Want to use our API?
We have a special subscription designed for those users who require extensive use of SEMrush API. This plan includes 300,000 API units.
Subscribe for $15

API allows SEMrush users to pull automated data from our servers, making it far simpler to analyze. Basically, API permits our users to integrate data within their software without having to go through the SEMrush interface.

Using SEMrush API is virtually effortless as well and easy to incorporate into any web project. All that you would need to do is merely complete a request.

Overview Reports
Price 10 API units per line Historical Price 50 API units per line
 

This report provides live or historical data on a domain’s keyword rankings in both organic and paid search in all regional databases.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_ranksA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database; if this parameter is not specified, your request will be sent to all regional databases.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Db, Ph, Nq, Cp, Co, Nr Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&type=domain_ranks&export_columns=Db,Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=seobook.com&database=us

Response example

Database;Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost us;seobook.com;24041;5249;37332;143496;0;0;0
Price 10 API units per line Historical Price 50 API units per line
 

This report provides live or historical data on a domain’s keyword rankings in both organic and paid search in a chosen regional database.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_rankA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=domain_rank&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=seobook.com&database=us

Response example

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost seobook.com;24041;5249;37332;143496;0;0;0
 
domain_rank_history
Price 10 API units per line
 

This report provides live and historical data on a domain’s keyword rankings in both organic and paid search in a chosen database.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_rank_historyA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_daily1This parameter allows you to get daily updates on position changes that occurred in the last 30 days or more. If the parameter is not specified, your report will show monthly results for the current month and for previous months.
export_columns Rk, Or, Ot, Oc, Ad, At, Ac, Dt Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortdt_asc, dt_desc

Request example

http://api.semrush.com/?type=domain_rank_history&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Rk,Or,Ot,Oc,Ad,At,Ac,Dt&domain=ebay.com&database=us

Response example

Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Date 17;2882456;8770712;7001679;1401952;2212672;1757371;20091215 16;2506570;8503977;6798483;854060;1013730;779171;20100115 9;2857493;45525396;41030076;909558;4637887;3912758;20100215 9;2347447;41973374;37879408;947112;4574135;3807340;20100315 9;2054556;39978373;36045179;783128;3600911;2975862;20100415 11;1925332;37399286;33659947;1206016;5243177;4367355;20100515 11;1827052;37447531;33594681;945977;3746817;3083455;20100615 9;1703405;38290175;34464866;965878;4779842;4063123;20100715 10;1747390;36753116;33127383;757175;3902664;3293719;20100815 9;1615035;38570878;34911222;832597;3799424;3203895;20100915
 
rank_difference
Price 20 API units per line Historical Price 100 API units per line
 

This report shows changes in the number of keywords, traffic, and budget estimates of the most popular websites in Google's (or Bing US') top 20 and paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*rank_differenceA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Om, Tm, Um, Am, Bm, Cm Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortom_asc, om_desc, tm_asc, tm_desc, um_asc, um_desc, am_asc, am_desc, bm_asc, bm_desc, cm_asc, cm_desc
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=rank_difference&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=5&database=us

Response example

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords Difference;Organic Traffic Difference;Organic Cost Difference;Adwords Keywords Difference;Adwords Traffic Difference;Adwords Cost Difference youtube.com;2;29588368;560156256;293898577;88095;518260;445293;1414436;17455210;2480862;36503;-24506;23023 facebook.com;3;10328267;539162798;291439847;27236;153751;186029;566112;-26521629;-9373541;4013;52236;91547 pinterest.com;20;4733729;60303624;38764006;46;103;74;469612;1508252;1785009;20;89;63 google.com;4;4072478;414476345;263394664;665202;3373704;3020002;251193;13307752;7086095;-11604;47969;-248175 allbookez.com;1830;223637;704494;462576;0;0;0;222901;669445;453624;0;0;0
 
rank
Price 10 API units per line Historical Price 50 API units per line
 

This report lists the most popular domains ranked by traffic originating from Google's (or Bing US') top 20 organic search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*rankA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&type=rank&display_limit=10&database=us

Response example

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost wikipedia.org;1;17773313;1436346705;1235791393;18;3;11 youtube.com;2;29588368;560156256;293898577;88095;518260;445293 facebook.com;3;10328267;539162798;291439847;27236;153751;186029 google.com;4;4072478;414476345;263394664;665202;3373704;3020002 twitter.com;5;2370943;270366367;177913666;2785;36047;43586 yahoo.com;6;12438732;241253256;193230084;561255;570540;458564 amazon.com;7;12211152;216651922;161100613;5619894;20749461;14168183 imdb.com;8;2640385;205514257;111845912;2306;2098;2377 apple.com;9;2446572;172363026;113338691;44027;1100798;1426953 yelp.com;10;6511147;137394291;152603659;5085;2975;16138
Accounts API
 
queries_api
Price Free
 

This report shows the last requests sent by a user to SEMrush via API. It also provides data on the time of the request, the chosen database, the type of report requested, the user’s IP address, and the cost per line.

Endpoint

http://logs.backend.semrush.com/

Request parameters

NameValueDescription
type*queries_apiA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_columns Ts, Db, Hs, Rt, Qu, Ip, Of, Li, Lc Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_filter Filters for columns. Ts, Db, Hs, Rt, Qu

Request example

http://logs.backend.semrush.com/?action=report&type=queries_api&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CDb%7C%7Cus&display_limit=3&export=api&export_columns=Ts,Db,Hs,Rt,Qu,Ip,Of,Li,Lc

Response example

"Time";"DB";"Historical";"Report type";"Query";"IP";"Offset";"Limit";"API line cost" "1404135852";"us";"0";"domain_rank";"seobook.com";"192.243.51.71";"0";"0";"10" "1404135405";"us";"0";"phrase_organic";"seo";"192.243.51.71";"0";"10";"10" "1404134484";"us";"0";"url_adwords";"http://www.amazon.com/";"84.52.114.132";"0";"5";"20"
 
queries_export
Price Free
 

This report shows the last requests to export data via the SEMrush user interface. It also provides data on the time of the request, the chosen database, the type of report requested, and the user’s IP address.

Endpoint

http://logs.backend.semrush.com/

Request parameters

NameValueDescription
type*queries_exportA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_columns Ts, Db, Hs, Rt, Qu, Ip Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_filter Filters for columns. Ts, Db, Hs, Rt, Qu

Request example

http://logs.backend.semrush.com/?action=report&type=queries_export&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CDb%7C%7Cus&display_limit=3&export=api&export_columns=Ts,Db,Hs,Rt,Qu,Ip

Response example

"Time";"DB";"Historical";"Report type";"Query";"IP" "1403253965";"us";"0";"domain_organic";"nationwide.com";"84.52.114.132" "1403188033";"us";"0";"domain_organic";"semrush.com";"84.52.114.132" "1403186623";"us";"0";"domain_organic";"semrush.com";"84.52.114.132"
Domain Reports
 
domain_organic
Price 10 API units per line Historical Price 50 API units per line
 

This report lists keywords that bring users to a domain via Google's (or Bing US') top 20 organic search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_organicA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr, Td Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sorttr_asc, tr_desc, po_asc, po_desc, tc_asc, tc_desc
display_positions new, lost, rise or fall The value "new" indicates keywords with which a domain entered Google's (or Bing US') top 20 organic or paid search results;
"lost" indicates keywords that no longer bring a domain to Google's (or Bing US') top 20 organic or paid search results;
"rise" indicates keywords that helped a domain to get a higher ranking in Google's (or Bing US') top 20 organic or paid search results;
"fall" indicates keywords that are currently helping a domain remain in the Google top 20, though its ranking may have decreased.
display_filter Filters for columns. Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=domain_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CPh%7CCo%7Cseo&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&domain=seobook.com&display_sort=tr_desc&database=us

Response example

Keyword;Position;Previous Position;Position Difference;Search Volume;CPC;Url;Traffic (%);Traffic Cost (%);Competition;Number of Results;Trends seo tools;1;1;0;4400;5.59;http://tools.seobook.com/;5.53;8.05;0.96;27100000;0.99,0.99,0.99,0.99,0.99,0.81,0.81,0.81,0.81,0.81,0.81,0.81 seo;12;7;-5;90500;13.01;http://www.seobook.com/;3.15;10.66;0.96;224000000;0.99,0.99,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82 seo training;1;1;0;1900;11.82;http://training.seobook.com/;2.39;7.35;0.94;6990000;0.99,0.79,0.79,0.79,0.79,0.79,0.67,0.79,0.79,0.67,0.67,0.67 free seo tools;1;1;0;1600;4.49;http://tools.seobook.com/;2.01;2.35;0.95;21000000;0.84,0.99,0.84,0.84,0.68,0.68,0.68,0.99,0.84,0.84,0.53,0.46 seo tool;1;1;0;880;5.12;http://tools.seobook.com/;1.10;1.47;0.98;10400000;0.45,0.45,0.45,0.45,0.37,0.45,0.63,0.45,0.55,0.99,0.45,0.37 seo book;1;1;0;880;11.87;http://www.seobook.com/;1.10;3.42;0.54;29800000;0.77,0.68,0.68,0.68,0.68,0.68,0.68,0.55,0.99,0.68,0.45,0.45 seobook;1;1;0;880;3.39;http://www.seobook.com/;1.10;0.97;0.05;119000;0.99,0.99,0.99,0.88,0.88,0.88,0.88,0.88,0.72,0.72,0.59,0.59 seo toolbar;1;1;0;390;2.11;http://tools.seobook.com/seo-toolbar/;0.49;0.26;0.35;1580000;0.99,0.81,0.99,0.81,0.81,0.81,0.81,0.81,0.67,0.54,0.44,0.35 seo infographic;1;1;0;210;0.00;http://www.seobook.com/learn-seo/infographics/;0.26;0.00;0.07;3560000;0.81,0.81,0.99,0.81,0.66,0.66,0.81,0.81,0.66,0.66,0.53,0.53 seotools;1;1;0;210;5.05;http://tools.seobook.com/;0.26;0.34;0.84;2950000;0.42,0.65,0.81,0.99,0.81,0.65,0.81,0.81,0.99,0.99,0.81,0.81
 
domain_adwords
Price 20 API units per line Historical Price 100 API units per line
 

This report lists keywords that bring users to a domain via Google's (or Bing US') paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_adwordsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Po, Pp, Pd, Ab, Nq, Cp, Tr, Tc, Co, Nr, Td, Tt, Ds, Vu, Ur Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sorttr_asc, tr_desc, po_asc, po_desc, tc_asc, tc_desc
display_positions new, lost, rise or fall The value "new" indicates keywords with which a domain entered Google's (or Bing US') top 20 organic or paid search results;
"lost" indicates keywords that no longer bring a domain to Google's (or Bing US') top 20 organic or paid search results;
"rise" indicates keywords that helped a domain to get a higher ranking in Google's (or Bing US') top 20 organic or paid search results;
"fall" indicates keywords that are currently helping a domain remain in the Google top 20, though its ranking may have decreased.
display_filter Filters for columns. Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=domain_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Vu,Tr,Tc,Co,Nr,Td&domain=ebay.com&display_sort=po_asc&database=us

Response example

Keyword;Position;Previous Position;Position Difference;Search Volume;CPC;Visible Url;Traffic (%);Traffic Cost (%);Competition;Number of Results;Trends solar sunroof;1;0;0;30;0.00;www.ebay.com/;0.00;0.00;0.48;3240000;0.40,0.60,0.60,0.60,0.60,0.80,0.99,0.80,0.60,0.40,0.40,0.60 mono audio jack;1;0;0;20;0.63;www.ebay.com/electronics;0.00;0.00;0.69;2120000;0.99,0.67,0.67,0.67,0.67,0.67,0.67,0.67,0.67,0.33,0.67,0.67 ebay iphone 4 16gb at&t;1;0;0;20;0.41;www.ebay.com/iPhone+4S;0.00;0.00;0.23;543000;0.99,0.75,0.75,0.50,0.50,0.75,0.50,0.25,0.50,0.50,0.25,0.25 darton ds 3800;1;0;0;170;0.13;www.ebay.com/;0.00;0.00;0.34;20000;0.99,0.52,0.67,0.67,0.52,0.67,0.81,0.81,0.81,0.81,0.81,0.67 used motorcycle exhaust pipes;1;0;0;10;0.00;www.ebay.com/motors;0.00;0.00;0.36;5370000;0.50,0.99,0.25,0.25,0.25,0.50,0.50,0.50,0.25,0.25,0.25,0.25 soapberry tree;1;0;0;390;0.39;www.ebay.com/home;0.00;0.00;0.49;126000;0.54,0.54,0.81,0.99,0.99,0.99,0.81,0.81,0.99,0.99,0.67,0.67 schaumburg watch;1;0;0;210;0.28;www.ebay.com/;0.00;0.00;0.54;4880000;0.81,0.66,0.99,0.81,0.81,0.81,0.66,0.53,0.53,0.53,0.53,0.81 naked jolie;1;0;0;30;0.00;www.ebay.com/;0.00;0.00;0.03;18800000;0.28,0.28,0.28,0.43,0.56,0.43,0.99,0.71,0.28,0.28,0.28,0.28 twilight poster cullens;1;0;0;10;0.00;www.ebay.com/;0.00;0.00;0.00;972000;0.99,0.99,0.00,0.00,0.00,0.99,0.99,0.99,0.00,0.00,0.00,0.00 alpine cda 9830;1;0;0;70;0.00;www.ebay.com/electronics;0.00;0.00;0.60;18000;0.45,0.45,0.45,0.64,0.82,0.82,0.82,0.99,0.64,0.64,0.45,0.45
 
domain_adwords_unique
Price 40 API units per line
 

This report shows unique ad copies SEMrush noticed when the domain ranked in Google's (or Bing US') paid search results for keywords from our databases.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_adwords_uniqueA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Ph, Po, Pp, Nq, Cp, Tr, Tc, Co, Nr, Td, Tt, Ds, Vu, Ur, Pc Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_filter Filters for columns. Tt, Ds, Vu

Request example

http://api.semrush.com/?type=domain_adwords_unique&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=3&export_columns=Tt,Ds,Vu,Ur,Pc&domain=ebay.com&database=us

Response example

Title;Description;Visible Url;Url;Number of Keywords Authentic Designer Goods - Clothing Shoes and Accessories;Prada Gucci Burberry Lanvin Chanel ;www.ebay.com/usr/luxeloveshop;http://www.ebay.com/usr/luxeloveshop&ved=0CHYQ0Qw;633 Boat For Sale on eBay;Huge selection of Boat For Sale.Free Shipping available. Buy Now!;www.ebay.com/;http://rover.ebay.com/rover/1/711-42618-2056-0/2%3Fmpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fsch%252Fi.html%253F_nkw%253Dboat%252520for%252520sale%26keyword%3Dboat%2Bfor%2Bsale%26crlp%3D35687221484_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s4%26device%3Dc&ved=0CIABENEM;361 Personalize Phone Cases - ebay.com;iPhone, iPod, HTC, Samsung, Sony, LG. Prices as low as $9.98.;www.stores.ebay.com/FSC25;http://www.stores.ebay.com/FSC25&ved=0CBMQ0Qw;273
 
domain_organic_organic
Price 40 API units per line Historical Price 200 API units per line
 

This report lists a domain’s competitors in organic search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_organic_organicA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Cr, Np, Or, Ot, Oc, Ad Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortnp_desc, cr_desc
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=domain_organic_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&domain=seobook.com&database=us

Response example

Domain;Competitor Relevance;Common Keywords;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords wordtracker.com;11.70;888;2337;14424;43425;0 moz.com;11.08;2103;13642;118148;537444;1170 seocentro.com;8.99;565;1034;8269;22462;0 wordstream.com;8.85;1826;15264;141247;547423;1436 bruceclay.com;7.75;635;2942;10853;111142;0 smallseotools.com;7.42;578;2532;93855;52850;0 webseoanalytics.com;7.13;450;1054;2099;8325;0 internetmarketingninjas.com;6.67;550;2993;16286;108353;7 searchenginewatch.com;5.96;1805;24867;258817;762913;0 searchenginejournal.com;5.76;1089;13573;70771;237464;0
 
domain_adwords_adwords
Price 40 API units per line Historical Price 200 API units per line
 

This report lists a domain’s competitors in paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_adwords_adwordsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Cr, Np, Ad, At, Ac, Or Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortnp_desc, cr_desc
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=domain_adwords_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Dn,Cr,Np,Ad,At,Ac,Or&domain=ebay.com&database=us

Response example

Domain;Competitor Relevance;Common Keywords;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords buycheapr.com;13.08;291015;983505;518192;274181;29 sale-fire.com;10.97;215583;735421;866840;497858;0 amazon.com;8.10;556564;5508370;18619722;12673065;12388884 compare99.com;7.04;116053;432662;280131;143400;0 wow.com;6.93;327750;3428518;5229411;2948004;43 xxl-sale.com;5.89;80453;160068;180350;81849;5 pronto.com;5.29;129105;1172469;485778;616248;107 best-deal.com;4.46;74543;448922;336108;272544;3 walmart.com;3.17;67883;903472;2134550;2150053;2447092 ask.com;2.88;152109;3911665;5426290;5056303;1174880
 
domain_adwords_historical
Price 100 API units per line
 

This report shows keywords a domain has bid on in the last 12 months and its positions in paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_adwords_historicalA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Ph, Dt, Po, Cp, Nq, Tr, Ur, Tt, Ds, Vu, Cv Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortcv_asc, cv_desc
display_filter Filters for columns. Ph, Nq, Cp, Tr

Request example

http://api.semrush.com/?type=domain_adwords_historical&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=1&export_columns=Ph,Dt,Po,Cp,Nq,Tr,Ur,Tt,Ds,Vu&domain=amazon.com&database=us

Response example

Keyword;Date;Position;CPC;Search Volume;Traffic (%);Url;Title;Description;Visible Url amazon;20140515;1;0.04;55600000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D32990341088%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D5171103263355843209%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e&ved=0CBoQ0Qw;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Two-Day Shipping with Prime. ;www.amazon.com/ amazon;20140415;1;0.04;55600000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D32990341088%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D1992461335032572848%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Two-Day Shipping with Prime. ;www.amazon.com/ amazon;20140315;1;0.04;55600000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D32990341088%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D2699138388277291794%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Two-Day Shipping with Prime. ;www.amazon.com/ amazon;20140215;1;0.04;55600000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D32990341088%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D724970626850373573%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Two-Day Shipping with Prime. ;www.amazon.com/ amazon;20140115;1;0.04;55600000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D32990341088%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D1617014662783984601%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Two-Day Shipping with Prime. ;www.amazon.com/ amazon;20131215;1;0.04;55600000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D34105712471%26ref%3Dpd_sl_9gjomtek7x_p;Amazon.com® Official Site;;www.amazon.com/ amazon;20131115;1;0.04;55600000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D32990340968%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D14247272491230668158%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free 2-Day Shipping w/Amazon Prime. ;www.amazon.com/ amazon;20131015;1;0.10;30400000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D32990340968%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D18509765391770279611%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free 2-Day Shipping w/Amazon Prime. ;www.amazon.com/ amazon;20130915;1;0.10;30400000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D15494587808%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D15753277532129816907%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Shipping on Orders Over $25 ;www.amazon.com/ amazon;20130815;1;0.10;30400000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D15494587808%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D12828290592009692725%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Shipping on Orders Over $25 ;www.amazon.com/ amazon;20130715;1;0.10;30400000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D13191552728%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D2966452031165308949%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Shipping on Orders Over $25 ;www.amazon.com/ amazon;20130615;1;0.10;30400000;12.59;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D13191552728%26hvpos%3D1o1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D181439590843952575%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26hvdev%3Dc%26ref%3Dpd_sl_7j18redljs_e;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Shipping on Orders Over $25 ;www.amazon.com/
 
domain_domains
Price 80 API units per line Historical Price 400 API units per line
 

This report allows users to compare up to five domains by common keywords, unique keywords, all keywords, or search terms that are unique to the first domain.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_domainsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domains*stringA URL-encoded string that contains domains in a specified format, separated by "|".
This format requires a domain to consist of <sign>|<type>|<domain>, where the<sign> means possible operations: "+", "-", "*", "/";
<type> has to take the value of "or" for organic keywords or "ad" for paid keywords; and 
<domain> indicates a domain.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, P0, P1, P2, P3, P4, Nr, Cp, Co, Nq Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortp0_asc, p0_desc, p1_asc, p1_desc, p2_asc, p2_desc, p3_asc, p3_desc, p4_asc, p4_desc, nq_asc, nq_desc, co_asc, co_desc, cp_asc, cp_desc, nr_asc, nr_desc
display_filter Filters for columns. Ph, P0, P1, P2, P3, P4, Nq, Cp, Co, Nr
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=domain_domains&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domains=%2B%7Cor%7Cebay.c­om%7C-%7Cor%7Cimdb.com%7C%2B%7Cad%7Cyoutube.com&display_limit=10&database=us

Response example

Keyword;Domain1 Pos;Domain2 Pos;Domain3 Pos;Domain4 Pos;Domain5 Pos;Number of Results;CPC;Average vol. craigslist;18;0;0;0;0;24900000;0.27;83100000 lowes;15;0;0;0;0;6960000;0.08;9140000 chase;13;0;0;0;0;101000000;0.62;9140000 tmz;8;0;0;0;0;10900000;0.51;7480000 hotmail.com;11;0;0;0;0;814000000;0.34;7480000 face;13;0;0;0;0;745000000;0.90;6120000 imdb;1;0;0;0;0;83900000;1.49;5000000 kim kardashian;17;0;0;0;0;55800000;0.04;4090000 miley cyrus;6;0;0;0;0;58600000;1.56;4090000 justin bieber;15;0;0;0;0;78800000;0.76;4090000
Keyword Reports
Price 10 API units per line
 

This report provides a summary of a keyword, including its volume, CPC, competition, and the number of results in all regional databases.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_allA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database; if this parameter is not specified, your request will be sent to all regional databases.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Db, Ph, Nq, Cp, Co, Nr Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.

Request example

http://api.semrush.com/?type=phrase_all&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Db,Ph,Nq,Cp,Co,Nr&phrase=search+engine+optimization&database=us

Response example

Price 10 API units per line Historical Price 50 API units per line
 

This report provides a summary of a keyword, including its volume, CPC, competition, and the number of results in a chosen regional database.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_thisA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Nq, Cp, Co, Nr Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=phrase_this&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Ph,Nq,Cp,Co,Nr&phrase=search+engine+optimization&database=us

Response example

Keyword;Search Volume;CPC;Competition;Number of Results search engine optimization;22200;17.79;0.97;31300000
 
phrase_organic
Price 10 API units per line Historical Price 50 API units per line
 

This report lists domains that are ranking in Google's (or Bing US') top 20 organic search results with a requested keyword.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_organicA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Ur Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=phrase_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Dn,Ur&phrase=seo&database=us

Response example

Domain;Url wikipedia.org;http://en.wikipedia.org/wiki/Search_engine_optimization searchengineland.com;http://searchengineland.com/guide/what-is-seo moz.com;http://moz.com/beginners-guide-to-seo google.com;https://support.google.com/webmasters/answer/35291%3Fhl%3Den majesticseo.com;http://www.majesticseo.com/ wspider.com;http://wspider.com/ baytechwebdesign.com;http://www.baytechwebdesign.com/services/online-marketing/seo-san-jose/ yelp.com;http://www.yelp.com/search%3Ffind_desc%3DSeo%2BCompany%26find_loc%3DSan%2BJose%252C%2BCA sanjoseseoservices.com;http://sanjoseseoservices.com/ starkmarketing.com;http://www.starkmarketing.com/
 
phrase_adwords
Price 20 API units per line Historical Price 100 API units per line
 

This report lists domains that are ranking in Google's (or Bing US') paid search results with a requested keyword.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_adwordsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Ur Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=phrase_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Dn,Ur&phrase=seo&database=us

Response example

Domain;Url seop.com;http://www.seop.com&ved=0CBMQ0Qw digitalsherpa.com;http://content.digitalsherpa.com/ultimate-seo-checklist-for-small-business-websites-free-ebook%3Futm_campaign%3DUltimate%2520SEO%2520Checklist%2520for%2520SMBs%26utm_medium%3Dgoogle%26utm_source%3Dppc%26mkwid%3DsFfCoTwav_dc%26pcrid%3D47184889391%26pkw%3Dseo%26pmt%3De%26utm_term%3Dseo&ved=0CBkQ0Qw rankpay.com;http://www.rankpay.com/r/adwords&ved=0CB8Q0Qw mdz.ca;http://www.mdz.ca&ved=0CJkBENEM scorpiondesign.com;http://www.scorpiondesign.com/What-We-Do/Search-Engine-Optimization.aspx%3FSPPC%3DGoogle%26sppcadid%3D132382%26keyword%3D%252Bseo%2520company%26matchtype%3Db%26adposition%3D1s2%26random%3D9845616637911377530%26network%3Dsearch%26device%3Dc%26networkType%3Dg&ved=0CJsBENEM moz.com;http://moz.com%3Futm_source%3Dgoogle%26utm_medium%3Dcpc%26utm_term%3Dseo%26utm_campaign%3DFree&ved=0CJ0BENEM gstatemarketing.com;http://www.gstatemarketing.com&ved=0CJ8BENEM siliconbeachdigital.com;https://www.SiliconBeachDigital.com/%3Fsec%3Dgoogft&ved=0CKEBENEM wildnettechnologies.com;http://seo.wildnettechnologies.com/seo-services%3Futm_source%3DPay%2520per%2520Click%2520Ads%26utm_medium%3DGoogle%2520Adwords%26utm_campaign%3DSEO%2520Services&ved=0CKMBENEM icrossing.com;http://m1024.ic-live.com/228/%3F151516816%26OVMTC%3DBroad%26site%3D%26creative%3D33350689017%26OVKEY%3Dseo%2520firm%26url_id%3D151516816%26adpos%3D1s7%26device%3Dc%26devicemodel%3D&ved=0CKUBENEM
 
phrase_related
Price 40 API units per line Historical Price 200 API units per line
 

This report provides an extended list of related keywords, synonyms, and variations relevant to a queried term in a chosen database.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_relatedA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Nq, Cp, Co, Nr, Td Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortnq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc
display_filter Filters for columns. Ph, Nq, Cp, Co, Nr
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=phrase_related&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ph,Nq,Cp,Co,Nr,Td&phrase=search+engine+optimization&database=us

Response example

Keyword;Search Volume;CPC;Competition;Number of Results;Trends search engines;201000;0.64;0.51;60500000;0.99,0.99,0.99,0.99,0.82,0.82,0.82,0.82,0.82,0.99,0.82,0.82 wikipedia.org;110000;0.42;0.01;127000000;0.45,0.45,0.82,0.99,0.99,0.99,0.82,0.82,0.82,0.67,0.37,0.37 seo;90500;13.01;0.96;224000000;0.99,0.99,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82 search engine;27100;0.46;0.37;307000000;0.99,0.99,0.99,0.99,0.82,0.67,0.67,0.67,0.82,0.99,0.82,0.82 en.wikipedia.org;22200;1.08;0.00;478000000;0.99,0.99,0.99,0.82,0.82,0.82,0.82,0.67,0.67,0.67,0.55,0.55 google search engine;18100;0.75;0.26;671000000;0.67,0.67,0.67,0.55,0.55,0.55,0.55,0.55,0.67,0.99,0.67,0.67 book.com;14800;1.90;0.50;5330000000;0.99,0.82,0.99,0.82,0.82,0.82,0.82,0.82,0.67,0.67,0.55,0.55 guide;14800;0.15;0.01;838000000;0.99,0.99,0.99,0.99,0.99,0.82,0.99,0.99,0.99,0.99,0.99,0.99 seo company;12100;26.70;0.98;38100000;0.99,0.82,0.82,0.82,0.82,0.67,0.82,0.67,0.67,0.82,0.67,0.67 beginners;9900;0.00;0.01;46000000;0.99,0.55,0.55,0.67,0.55,0.45,0.45,0.55,0.55,0.36,0.45,0.67
 
phrase_adwords_historical
Price 100 API units per line
 

This report shows domains that have bid on a requested keyword in the last 12 months and their positions in paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_adwords_historicalA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Dn, Dt, Po, Ur, Tt, Ds, Vu, At, Ac, Ad Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.

Request example

http://api.semrush.com/?type=phrase_adwords_historical&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=1&export_columns=Dn,Dt,Po,Ur,Tt,Ds,Vu&phrase=movie&database=us

Response example

Domain;Date;Position;Url;Title;Description;Visible Url blendedmovie.com;20140515;1;47.xg4ken.com/media/redir.php%3Fprof%3D626%26camp%3D58398%26affcode%3Dkw599%26cid%3D36205335494%26networkType%3Dsearch%26kdv%3Dc%26url%5B%5D%3Dhttp%253A%252F%252Fblendedmovie.com%252F%2523home&ved=0CBoQ0Qw;Blended Movie - blendedmovie.com;A wildly different family vacation. Out 5/23. Buy Tickets Today!;www.blendedmovie.com/ blendedmovie.com;20140415;;;;; blendedmovie.com;20140315;;;;; blendedmovie.com;20140215;;;;; blendedmovie.com;20140115;;;;; blendedmovie.com;20131215;;;;; blendedmovie.com;20131115;;;;; blendedmovie.com;20131015;;;;; blendedmovie.com;20130915;;;;; blendedmovie.com;20130815;;;;; blendedmovie.com;20130715;;;;; blendedmovie.com;20130615;;;;;
 
phrase_fullsearch
Price 20 API units per line
 

The report offers a list of phrase matches and alternate search queries, including particular keywords or keyword expressions.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_fullsearchA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Ph, Nq, Cp, Co, Nr, Td Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortnq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc
display_filter Filters for columns. Ph, Nq, Cp, Co, Nr

Request example

http://api.semrush.com/?type=phrase_fullsearch&phrase=buy+ticket+online&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ph,Nq,Cp,Co,Nr,Td&database=us

Response example

Keyword;Search Volume;CPC;Competition;Number of Results;Trends buy tickets online;2900;2.38;0.92;679000000;0.99,0.99,0.99,0.83,0.99,0.99,0.99,0.99,0.99,0.83,0.83,0.83 buy movie tickets online;2400;1.96;0.35;290000000;0.35,0.24,0.30,0.24,0.99,0.54,0.44,0.30,0.24,0.30,0.81,0.81 buy lottery tickets online;1300;0.90;0.30;3170000;0.24,0.24,0.36,0.28,0.81,0.28,0.24,0.44,0.36,0.24,0.24,0.99 buy concert tickets online;590;1.28;0.96;24700000;0.55,0.99,0.67,0.67,0.67,0.82,0.82,0.67,0.55,0.55,0.55,0.55 buy powerball tickets online;590;0.00;0.19;204000;0.06,0.11,0.38,0.09,0.99,0.11,0.14,0.99,0.21,0.06,0.06,0.06 can you buy lottery tickets online;480;0.56;0.17;2270000;0.20,0.20,0.30,0.16,0.68,0.20,0.25,0.45,0.37,0.13,0.13,0.99 buy six flags tickets online;390;0.95;0.56;198000;0.24,0.16,0.67,0.55,0.44,0.99,0.67,0.55,0.16,0.44,0.10,0.08 buying movie tickets online;390;1.87;0.45;43900000;0.44,0.28,0.36,0.28,0.82,0.54,0.54,0.44,0.28,0.28,0.99,0.99 can you buy powerball tickets online;390;0.00;0.03;136000;0.05,0.05,0.17,0.06,0.99,0.06,0.07,0.46,0.25,0.07,0.05,0.09 buy greyhound tickets online;320;0.14;0.67;124000;0.05,0.04,0.08,0.07,0.04,0.08,0.13,0.08,0.07,0.30,0.68,0.99
URL Reports
Price 10 API units per line Historical Price 50 API units per line
 

This report lists keywords that bring users to a URL via Google's (or Bing US') top 20 organic search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*url_organicA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
url*http://example.com/The URL of a landing page you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=url_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export_columns=Ph,Po,Nq,Cp,Co,Tr,Tc,Nr,Td&url=http://tools.seobook.com/&database=us

Response example

Keyword;Position;Search Volume;CPC;Competition;Traffic (%);Traffic Cost (%);Number of Results;Trends seo tools;1;4400;5.59;0.96;5.53;8.05;27100000;0.99,0.99,0.99,0.99,0.99,0.81,0.81,0.81,0.81,0.81,0.81,0.81 search engine optimization seo;12;1600;17.28;0.23;0.05;0.25;105000000;0.07,0.07,0.09,0.09,0.09,0.09,0.11,0.81,0.67,0.81,0.99,0.99 free seo tools;1;1600;4.49;0.95;2.01;2.35;21000000;0.84,0.99,0.84,0.84,0.68,0.68,0.68,0.99,0.84,0.84,0.53,0.46 about search engine optimization;12;1300;0.00;0.11;0.04;0.00;171000000;0.01,0.01,0.01,0.01,0.01,0.01,0.01,0.67,0.53,0.81,0.99,0.81 free seo;4;1000;4.53;0.94;0.18;0.22;66500000;0.30,0.37,0.42,0.37,0.37,0.54,0.42,0.99,0.37,0.37,0.25,0.25 seo tool;1;880;5.12;0.98;1.10;1.47;10400000;0.45,0.45,0.45,0.45,0.37,0.45,0.63,0.45,0.55,0.99,0.45,0.37 seo search engine optimization;10;880;13.82;0.94;0.07;0.25;109000000;0.13,0.13,0.17,0.17,0.17,0.20,0.20,0.99,0.99,0.20,0.11,0.11 free search engines;13;880;0.73;0.88;0.02;0.00;144000000;0.72,0.72,0.72,0.72,0.72,0.88,0.88,0.88,0.88,0.99,0.88,0.88 seo tools free;3;480;5.29;0.89;0.11;0.15;28100000;0.44,0.55,0.44,0.44,0.36,0.36,0.36,0.99,0.67,0.99,0.36,0.13 free seo software;5;390;4.55;0.96;0.05;0.06;24700000;0.99,0.99,0.99,0.99,0.99,0.99,0.99,0.99,0.67,0.67,0.54,0.54
 
url_adwords
Price 20 API units per line Historical Price 100 API units per line
 

This report lists keywords that bring users to a URL via Google's (or Bing US') paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*url_adwordsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
url*http://example.com/The URL of a landing page you'd like to investigate.
database* "us" (google.com) , "uk" (google.co.uk) , "ca" (google.ca) , "ru" (google.ru) , "de" (google.de) , "fr" (google.fr) , "es" (google.es) , "it" (google.it) , "br" (google.com.br) , "au" (google.com.au) , "bing-us" (bing.com) , "ar" (google.com.ar) , "be" (google.be) , "ch" (google.ch) , "dk" (google.dk) , "fi" (google.fi) , "hk" (google.com.hk) , "ie" (google.ie) , "il" (google.co.il) , "mx" (google.com.mx) , "nl" (google.nl) , "no" (google.no) , "pl" (google.pl) , "se" (google.se) , "sg" (google.com.sg) , "tr" (google.com.tr) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_datedate in format "YYYYMM15"A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td, Tt, Ds Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=url_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=5&export_columns=Ph,Po,Nq,Cp,Co,Tr,Tc,Nr,Td,Tt,Ds&url=http://www.amazon.com/&database=us

Response example

Keyword;Position;Search Volume;CPC;Competition;Traffic (%);Traffic Cost (%);Number of Results;Trends;Title;Description amazon;1;55600000;0.04;0.10;1.22;0.06;554000000;0.67,0.55,0.67,0.55,0.55,0.55,0.67,0.67,0.67,0.55,0.67,0.99;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Two-Day Shipping with Prime. amazon.com;1;5000000;0.04;0.12;0.10;0.00;3940000000;0.67,0.55,0.67,0.55,0.55,0.55,0.67,0.67,0.55,0.55,0.67,0.99;Amazon.com® Official Site - Huge Selection and Amazing Prices;Free Two-Day Shipping with Prime. ps4;4;2240000;0.37;0.91;0.00;0.00;76500000;0.07,0.67,0.25,0.16,0.25,0.67,0.30,0.30,0.25,0.30,0.99,0.99;PS4 at Amazon.com;Buy PS4 at Amazon!Free Shipping on Qualified Orders. samsung galaxy s4;4;1500000;2.13;1.00;0.00;0.01;418000000;0.13,0.20,0.99,0.67,0.67,0.45,0.36,0.36,0.30,0.25,0.25,0.25;Samasung Galaxy S4;Buy samasung galaxy s4 at Amazon!Free Shipping on Qualified Orders. galaxy s4;6;1220000;3.50;0.99;0.00;0.01;701000000;0.16,0.25,0.99,0.67,0.55,0.30,0.30,0.25,0.20,0.13,0.13,0.16;S4 Galaxy Case at Amazon;Buy s4 galaxy case at Amazon!Free Shipping on Qualified Orders.
Display Advertising Reports
 
publisher_text_ads
Price 50 API units per line
 

This report lists display ads that have appeared on a publisher’s website.

Endpoint

http://api.asns.backend.semrush.com/

Request parameters

NameValueDescription
type*publisher_text_adsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
domain*example.comA unique name of a website you’d like to investigate.
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns title,text, first_seen, last_seen, times_seen, avg_position, media_type, visible_url Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortlast_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_asc, times_seen_desc
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android This parameter shows the type of device by which statistics have been collected—a PC, tablet, or smartphone.
display_filter Filters for columns. title, text

Request example

http://api.asns.backend.semrush.com/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=american-shopping-online.com&type=publisher_text_ads&export=api

Response example

title;text;first_seen;last_seen;times_seen;avg_position;media_type;visible_url The Official Honda Site;See Great Offers on a new Honda. Build and Price Yours Online Today!;1368659390;1372466407;92163;0;text;www.honda.com Facebook® Account Sign Up;World's Largest Online Community. Join for Free & Enjoy the Benefits!;1368958394;1372737023;10974;0;text;www.Facebook.com NORDSTROM - Official Site;Shop New Arrivals from Top Brands. Free Shipping & Free Returns.;1368650056;1372747486;8165;0;text;www.nordstrom.com Honda IndyCar Racing;Visit the Honda Racing HPD site to learn more today.;1368796116;1371403701;5641;0;text;www.honda.com/indycar QuickBooks Online Free;Access Your Books Anytime, Anywhere & Even Share with Others. Try Free!;1368737373;1372670070;4521;0;text;www.QuickBooksOnline.com Find deal now;Find your deal Buy more, save more!;1368957253;1372733166;4217;0;text;dealsea.com/ Get Your Veteran ID Card;Largest US Veteran Website ID card Benefits, discounts & service pride;1368989287;1372840876;4132;0;text;www.VetFriends.com Brain Training Games;Improve memory and attention with scientific brain games. Free Trial;1368957409;1372839646;3970;0;text;www.lumosity.com Exclusive: 30% Off Codes;Get 30% Off with These Codes! As Seen On ABC News - Save Now;1370674879;1372840950;3375;0;text;PromoCodes.ebates.com Google Drive - Start Now;Store all your files in one place. Now get up to 15GB of free storage.;1369849591;1372488846;2896;0;text;google.com/drive
 
publisher_advertisers
Price 50 API units per line
 

This report lists advertisers whose display ads have appeared on a queried publisher’s website.

Endpoint

http://api.asns.backend.semrush.com/

Request parameters

NameValueDescription
type*publisher_advertisersA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
domain*example.comA unique name of a website you’d like to investigate.
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns domain, ads_count, first_seen, last_seen, times_seen, ads_percent Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortlast_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc ads_count_asc, ads_count_desc
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android This parameter shows the type of device by which statistics have been collected—a PC, tablet, or smartphone.
display_filter Filters for columns. domain

Request example

http://api.asns.backend.semrush.com/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=american-shopping-online.com&type=publisher_advertisers&export=api

Response example

domain;ads_count;first_seen;last_seen;times_seen;ads_percent honda.com;45;1368659390;1372746618;101008;0.0 facebook.com;93;1368958112;1372735669;24363;0.0 facebook.com;61;1368730812;1372839646;12315;0.0 nordstrom.com;85;1368630096;1372747486;10339;0.0 doubleclick.net;117;1368672599;1372840834;9323;0.0 ebates.com;15;1370673634;1372840950;5653;0.0 quickbooksonline.com;19;1368737373;1372840410;5152;0.0 lumosity.com;40;1368823103;1372839646;4402;0.0 dealsea.com;1;1368957253;1372733166;4217;0.0 vetfriends.com;20;1368669487;1372840876;4170;0.0
 
advertiser_publishers
Price 100 API units per line
 

This report lists publisher’s websites where an advertiser’s display ads have appeared.

Endpoint

http://api.asns.backend.semrush.com/

Request parameters

NameValueDescription
type*advertiser_publishersA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
domain*example.comA unique name of a website you’d like to investigate.
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns domain, ads_count, first_seen, last_seen, times_seen, ads_percent Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortlast_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc ads_count_asc, ads_count_desc
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android This parameter shows the type of device by which statistics have been collected—a PC, tablet, or smartphone.
display_filter Filters for columns. domain

Request example

http://api.asns.backend.semrush.com/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=facebook.com&type=advertiser_publishers&export=api

Response example

domain;ads_count;first_seen;last_seen;times_seen;ads_percent american-shopping-online.com;320;1368730812;1372839646;37626;0.0 indianfestivaldiary.com;33;1369039202;1370837769;10223;0.0 arcadehi.com;43;1368884290;1372837445;9864;0.0 longislanddirectory.com;104;1368715135;1372840680;9414;0.0 gsmasha.com;263;1368843008;1372768613;8550;0.0 plexpedia.com;37;1368973062;1372620577;7952;0.0 delhichoices.com;39;1364587968;1372774888;7272;0.0 wallaceandgromit.net;8;1368847520;1372762932;7100;0.0 al-raqi.net;166;1369075329;1372657766;6591;0.0 comprasnoparaguai.com;191;1368755715;1372706594;6222;0.0
 
advertiser_text_ads
Price 100 API units per line
 

This report lists display ads of a queried advertiser’s website.

Endpoint

http://api.asns.backend.semrush.com/

Request parameters

NameValueDescription
type*advertiser_text_adsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
domain*example.comA unique name of a website you’d like to investigate.
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns title,text, first_seen, last_seen, times_seen, avg_position, media_type, visible_url Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortlast_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_asc, times_seen_desc
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android This parameter shows the type of device by which statistics have been collected—a PC, tablet, or smartphone.
display_filter Filters for columns. title, text

Request example

http://api.asns.backend.semrush.com/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=facebook.com&type=advertiser_text_ads&export=api

Response example

title;text;first_seen;last_seen;times_seen;avg_position;media_type;visible_url Facebook® Account Sign Up;World's Largest Online Community. Join for Free & Enjoy the Benefits!;1368833102;1372840924;1171014;0;text;www.Facebook.com Facebook® Account Sign Up;World's Largest Online Community. Join for Free & Enjoy the Benefits!;1369349831;1372840931;297370;0;text;Facebook.com Facebook En Español;Busca y Conéctate con tus Amigos en Facebook®. ¡Regístrate Ahora!;1368839917;1372840972;46633;0;text;www.Facebook.com اعمل بروفيل على Facebook;تواصل مع الأصدقاء والعائلة والزملاء. اعمل بروفيل اليوم!;1370518077;1372840685;11449;0;text;Facebook.com/Arabic Make a Facebook™ Profile;Chat w/ Friends, Play Games, Send Photos & More. Sign Up for Free!;1368842122;1372840694;7377;0;text;www.Facebook.com Create a Facebook Profile;World's Largest Online Community. Join for Free & Enjoy the Benefits!;1369275297;1372840291;6045;0;text;Facebook.com Facebook - الموقع الرسمي;تواصل مع أصدقائك وعائلتك وزملائك في الفصل. أنشئ ملفًا شخصيًا الآن;1368845167;1372839491;4067;0;text;Facebook.com/Arabic Green Tea with Citrus;Sit Back, Relax & Enjoy Nestea®'s Delicious Green Tea. Try It Today!;1370518182;1372840511;2287;0;text;www.facebook.com/nestea Nestea® Iced Tea;Try Our Sugar Free Tea! A Delicious Blend Of Tea & Fresh Fruit Flavor.;1364300389;1372840583;2245;0;text;www.facebook.com/nestea Go Pro With Crest;For Clean That’s 4X Better Than Ordinary Brushing Alone;1370518991;1372840939;1727;0;text;Facebook.com/CrestProHealth
 
advertiser_landings
Price 100 API units per line
 

This report lists URLs of a domain’s landing pages promoted via display ads.

Endpoint

http://api.asns.backend.semrush.com/

Request parameters

NameValueDescription
type*advertiser_landingsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
domain*example.comA unique name of a website you’d like to investigate.
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns target_url, first_seen, last_seen, times_seen, ads_count Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortast_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc, ads_count_asc, ads_count_desc
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android This parameter shows the type of device by which statistics have been collected—a PC, tablet, or smartphone.
display_filter Filters for columns. target_url

Request example

http://api.asns.backend.semrush.com/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=facebook.com&type=advertiser_landings&export=api

Response example

target_url;first_seen;last_seen;times_seen;ads_count https://www.facebook.com/burnnotice?__source=ggl|imgcnt&sky=ggl|imgcnt;1370590491;1371144364;7655;3 https://www.facebook.com/burnnotice?__source=ggl|imgcnt&sky=ggl|imgcnt;1370590017;1371144300;7149;1 http://facebook.com/nesteausa;1364300389;1372840583;6187;14 https://www.facebook.com/farnamhorse/app_158086484245654;1370828300;1371793865;4152;2 https://www.facebook.com/VolvoTrucksUnitedStates;1364298008;1369983523;2993;3 https://www.facebook.com/crest/app_315968191857690?utm_source=google&utm_medium=cpc&utm_term=&utm_campaign=CPH_Content_Desktop_Brand+Purchase_Paste|Titan+-+Placement+Facebook+-+Buy+General_Paste&utm_content=cDYMu2k88_23035024137__;1368615623;1372682936;2300;2 https://apps.facebook.com/topeleven/;1365486726;1372812302;1882;9 https://www.facebook.com/crest/app_315968191857690?utm_source=google&utm_medium=cpc&utm_term=&utm_campaign=CPH_Content_Desktop_Brand+Awareness_Paste|Titan+-+Placement+Facebook+-+Crest_Non&utm_content=cIgScYy0D_22830758697__;1368615491;1372840939;1840;2 https://www.facebook.com/farnamhorse/app_158086484245654;1370828320;1371757823;1837;2 http://www.facebook.com/mobil1;1369867399;1370269882;1541;5
 
advertiser_publisher_text_ads
Price 100 API units per line
 

This report lists the display ads of a given advertiser that have appeared on a particular publisher’s website.

Endpoint

http://api.asns.backend.semrush.com/

Request parameters

NameValueDescription
type*advertiser_publisher_text_adsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
domain*example.comA unique name of a website you’d like to investigate.
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns title,text, first_seen, last_seen, times_seen, avg_position, media_type, visible_url Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sortlast_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_asc, times_seen_desc
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android This parameter shows the type of device by which statistics have been collected—a PC, tablet, or smartphone.
display_filter Filters for columns. title, text

Request example

http://api.asns.backend.semrush.com/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=facebook.com american-shopping-online.com&type=advertiser_publisher_text_ads&export=api

Response example

title;text;first_seen;last_seen;times_seen;avg_position;media_type;visible_url Facebook® Account Sign Up;World's Largest Online Community. Join for Free & Enjoy the Benefits!;1368958394;1372737023;10974;0;text;www.Facebook.com Facebook® Account Sign Up;World's Largest Online Community. Join for Free & Enjoy the Benefits!;1369465663;1372719461;608;0;text;Facebook.com Facebook En Español;Busca y Conéctate con tus Amigos en Facebook®. ¡Regístrate Ahora!;1368971432;1372727656;309;0;text;www.Facebook.com Go Pro With Crest;For Clean That’s 4X Better Than Ordinary Brushing Alone;1368764680;1372743656;62;0;text;Facebook.com/CrestProHealth Make a Facebook™ Profile;Chat w/ Friends, Play Games, Send Photos & More. Sign Up for Free!;1368961529;1372839646;61;0;text;www.Facebook.com Create a Facebook Profile;World's Largest Online Community. Join for Free & Enjoy the Benefits!;1369209601;1369310321;45;0;text;Facebook.com Go Pro With Crest;A Clean That’s 4X Better Than Ordinary Brushing Alone, Buy Now!;1369156041;1372737771;33;0;text;Facebook.com/CrestProHealth Green Tea with Citrus;Sit Back, Relax & Enjoy Nestea®'s Delicious Green Tea. Try It Today!;1368730812;1372597252;27;0;text;www.facebook.com/nestea Nestea® Iced Tea;Try Our Sugar Free Tea! A Delicious Blend Of Tea & Fresh Fruit Flavor.;1369034031;1372743234;21;0;text;www.facebook.com/nestea Ruffles® Ultimate Chips;Deeper Ridges for Ultimate Flavor Like Us and Pick up a Bag Today!;1370005670;1371190635;16;0;text;www.facebook.com/ruffles
 
advertiser_rank
Price 10 API units per line
 

This report lists advertisers ranked by the total number of display ads noticed by SEMrush.

Endpoint

http://api.asns.backend.semrush.com/

Request parameters

NameValueDescription
type*advertiser_rankA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
domain*example.comA unique name of a website you’d like to investigate.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_columns domain, ads_overall, text_ads_overall, ads_count, text_ads_count, times_seen, first_seen, last_seen, media_ads_overall, media_ads_count, publishers_overall, publishers_count Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android This parameter shows the type of device by which statistics have been collected—a PC, tablet, or smartphone.

Request example

http://api.asns.backend.semrush.com/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=facebook.com&type=advertiser_rank&export=api

Response example

domain;ads_overall;text_ads_overall;ads_count;text_ads_count;times_seen;first_seen;last_seen;media_ads_overall;media_ads_count;publishers_overall;publishers_count facebook.com;35499;35499;7952;7952;25218631;1364295355;1372809663;0;0;57167;15064
 
publisher_rank
Price 10 API units per line
 

This report lists publishers ranked by the total number of display ads noticed by SEMrush.

Endpoint

http://api.asns.backend.semrush.com/

Request parameters

NameValueDescription
type*publisher_rankA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
domain*example.comA unique name of a website you’d like to investigate.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_columns domain, ads_overall, text_ads_overall, ads_count, text_ads_count, times_seen, first_seen, last_seen, media_ads_overall, media_ads_count, advertiser_overall, advertiser_count Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
device_type all, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_android This parameter shows the type of device by which statistics have been collected—a PC, tablet, or smartphone.

Request example

http://api.asns.backend.semrush.com/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=american-shopping-online.com&type=publisher_rank&export=api

Response example

domain;ads_overall;text_ads_overall;ads_count;text_ads_count;times_seen;first_seen;last_seen;media_ads_overall;media_ads_count;advertisers_overall;advertisers_count longislanddirectory.com;30045;30045;4090;4090;1003769;1368630206;1372654365;0
Columns
Descriptions of reports' columns:
Ab - The place on the SERP where the ad appeared (top, side, bottom blocks).
Ac - Estimated budget spent buying keywords in Google AdWords for ads that appear in paid search results (monthly estimation).
Ad - Keywords the website is buying in Google AdWords for ads that appear in paid search results.
Am - Number of adwords keywords changes
At - Traffic brought to the website via Google AdWords paid search results.
Bm - Adwords traffic changes
Cm - Adwords traffic price changes
Co - Competitive density of advertisers using the given term for their ads. One (1) means the highest competition.
Cp - Average price in U.S. dollars advertisers pay for a user’s click on an ad containing the given keyword (Google AdWords).
Cr - Competition level based on keywords
Cv - Keyword coverage represents the percentage of ads displayed for a particular keyword in the last 12 months (100% = 12 months).
Db - Database
Dn - The website ranking in Google's top 20 organic search results. Click the sign with a small arrow to view the website, or click the link to open the Overview Report for the domain.
Ds - Ad text
Dt - Actual date
Hs - Whether the report is historical?
Ip - IP address
Lc - API units per line
Li - Limit
Np - The same keywords the given and queried domains are ranking for in Google's top 20 organic search results.
Nq - The average number of search queries for the given keyword for the last 12 months.
Nr - The number of URLs displayed in organic search results for the given keyword.
Oc - Estimated price of organic keywords in Google AdWords.
Of - Offset
Om - Number of organic keywords changes
Or - Keywords bringing users to the website via Google's top 20 organic search results.
Ot - Traffic brought to the website via Google's top 20 organic search results.
P0 - The position of fisrt domain for this keyword in organic or Ads results
P1 - The position of second domain for this keyword in organic or Ads results
P2 - The position of third domain for this keyword in organic or Ads results
P3 - The position of fourth domain for this keyword in organic or Ads results
P4 - The position of fifth domain for this keyword in organic or Ads results
Pc - Number of keywords
Pd - The difference between keyword position in previous month and keyword position in current month
Ph - The keyword bringing users to the website via Google's top 20 organic search results.
Po - The position the URL gets in organic search for the given keyword at the specified period.
Pp - The site's position for the search query (at the time of prior data collection)
Pt - An estimation of how much traffic site would get if it was ranked #1
Qu - Query
Rh - The SEMrush rating of the websites’s popularity based on organic traffic coming from Google's top 20 organic search results.
Rk - The SEMrush rating of the websites’s popularity based on organic traffic coming from Google's top 20 organic search results.
Rt - Report type
Tc - Estimated price of the given keyword in Google AdWords.
Td - The interest of searchers in the given keyword during the period of 12 months. The metric is based on changes in the number of queries per month.
Tm - Organic traffic changes
Tr - The share of traffic driven to the website with the given keyword for the specified period.
Ts - UNIX Timestamp
Tt - Ad Title
Um - Organic traffic cost changes
Ur - Url of the target page
Vu - Visible URL
ads_count - The total number of all types of ads during the reporting period
ads_overall - The total number of all types of ads for all time
advertisers_count - The total number of advertisers by 7 days
advertisers_overall - The total number of advertisers
anchor - Text between open and close <a> tag
avg_positions - An average position of the ad
domain - Domain name
external_num - External links number on source page
first_seen - Timestamp when we have seen for the first time (s)
image_alt - Image alt between open and close <a> tag
image_url - Image url between open and close <a> tag
internal_num - Internal links number on source page
last_seen - Timestamp when we have seen for the last time (s)
media_ads_count - The total number of media ads during the reporting period
media_ads_overall - The total number of media ads for all time
media_type - Media type of the ad
publishers_count - The total number of publishers by 7 days
publishers_overall - The total number of publishers
redirect_url - Last url in redirect chain
response_code - Server response code
source_title - Title of the source page
source_size - Source page size in bytes
source_url - Url of the source page
target_title - Title of the target page
target_url - Url of the target page (Backlinks)
target_url - Landing page of the ad (AdSense)
text - Text of the ad
text_ads_count - The total number of text ads during the reporting period
text_ads_overall - The total number of text ads for all time
times_seen - Number of times we saw ad
title - Title of the ad
type - The metrics indicates the backlink type
visible_url - Visible url of the ad
  • Column names never change
  • Order of columns may be changed
  • Number of columns may be increased
  • Old columns may be removed only after notification
Sortings
Description of sortings:
am_asc - sorting by changes in adwords keywords, in ascending order (Am)
am_desc - sorting by changes in adwords keywords, in descending order (Am)
bm_asc - sorting by changes in adwords traffic, in ascending order (Bm)
bm_desc - sorting by changes in adwords traffic, in descending order (Bm)
cm_asc - sorting by changes in adwords trafic price, in ascending order (Cm)
cm_desc - sorting by changes in adwords trafic price, in descending order (Cm)
co_asc - sorting by competition, in ascending order (Co)
co_desc - sorting by competition, in descending order (Co)
cp_asc - sorting by cpc, in ascending order (Cp)
cp_desc - sorting by cpc, in descending order (Cp)
cr_desc - sorting by competitor relevance, in descending order (Cr)
cv_asc - sorting by coverage, in ascending order (Cv)
cv_desc - sorting by coverage, in descending order (Cv)
dt_asc - sorting by last update date, in ascending order (Ts)
dt_desc - sorting by last update date, in descending order (Ts)
np_desc - sorting by common keywords, in descending order (Np)
nq_asc - sorting by volume, in ascending order (Nq)
nq_desc - sorting by volume, in descending order (Nq)
nr_asc - sorting by number of results, in ascending order (Nr)
nr_desc - sorting by number of results, in descending order (Nr)
om_asc - sorting by changes in organic keywords, in ascending order (Om)
om_desc - sorting by changes in organic keywords, in descending order (Om)
p0_asc - sorting by position of 1st domain, in ascending order (P0)
p0_desc - sorting by position of 1st domain, in descending order (P0)
p1_asc - sorting by position of 2nd domain, in ascending order (P1)
p1_desc - sorting by position of 2nd domain, in descending order (P1)
p2_asc - sorting by position of 3rd domain, in ascending order (P2)
p2_desc - sorting by position of 3rd domain, in descending order (P2)
p3_asc - sorting by position of 4th domain, in ascending order (P3)
p3_desc - sorting by position of 4th domain, in descending order (P3)
p4_asc - sorting by position of 5th domain, in ascending order (P4)
p4_desc - sorting by position of 5th domain, in descending order (P4)
po_asc - sorting by position, in ascending order (Po)
po_desc - sorting by position, in descending order (Po)
tc_asc - sorting by traffic cost, in ascending order (Tc)
tc_desc - sorting by traffic cost, in descending order (Tc)
tm_asc - sorting by changes in organic traffic, in ascending order (Tm)
tm_desc - sorting by changes in organic traffic, in descending order (Tm)
tr_asc - sorting by traffic, in ascending order (Tr)
tr_desc - sorting by traffic, in descending order (Tr)
um_asc - sorting by changes in organic trafic price, in ascending order (Um)
um_desc - sorting by changes in organic trafic price, in descending order (Um)
last_seen_asc - sorting by last seen, in ascending order (last_seen)
last_seen_desc - sorting by last seen, in descending order (last_seen)
first_seen_asc - sorting by first seen, in ascending order (first_seen)
first_seen_desc - sorting by first seen, in descending order (first_seen)
times_seen_asc - sorting by times seen, in ascending order (times_seen)
times_seen_desc - sorting by times_seen, in descending order (times_seen)
ads_count_asc - sorting by ads count, in ascending order (ads_count)
ads_count_desc - sorting by ads count, in descending order (ads_count)
Filters
To apply a filter to the report you should add parameter display_filter with an urlencoded string which contains filters separated by "|" (maximum number - 25).
Please be aware, that some ready-to-use function code "+" sign incorrectly. Make sure that it is followed by the symbols "%2B".
A filter consists of <sign>|<field>|<operation>|<value>, where
<sign> - "+" or "-" (include/exclude)
<field> - possible fields: Co, Cp, Db, Hs, Nq, Nr, P0, P1, P2, P3, P4, Ph, Po, Pp, Qu, Rt, Tc, Tr, Ts, Ur, Vu
  • Metrical fields
  • Textual fields
  • Fields with fixed values
<operation> - possible operations: Eq, Gt, Lt, Bw, Ew, Co
  • For metrical fields
  • For textual fields
  • For fields with fixed values
<value> - value to filter
Price in API units
$1 = 20,000 API units. View our API products ›
All prices displayed are per each line of results.
Type Description API units per line Historical data
domain_ranks Domain Overview (All Databases) 10 50
domain_rank Domain Overview (One Database) 10 50
domain_rank_history Domain Overview (History) 10 -
rank_difference Winners and Losers 20 100
rank SEMrush Rank 10 50
queries_api Last User API Queries 0 -
queries_export Last User Export Queries 0 -
domain_organic Domain Organic Search Keywords 10 50
domain_adwords Domain Paid Search Keywords 20 100
domain_adwords_unique Ads Copies 40 -
domain_organic_organic Competitors in Organic Search 40 200
domain_adwords_adwords Competitors in Paid Search 40 200
domain_adwords_historical Domain Ads History 100 -
domain_domains Domain vs. Domain 80 400
phrase_all Keyword Overview (All Databases) 10 -
phrase_this Keyword Overview (One Database) 10 50
phrase_organic Organic Results 10 50
phrase_adwords Paid Results 20 100
phrase_related Related Keywords 40 200
phrase_adwords_historical Keyword Ads History 100 -
phrase_fullsearch Phrase Match Keywords 20 -
url_organic URL Organic Search Keywords 10 50
url_adwords URL Paid Search Keywords 20 100
publisher_text_ads Publisher Display Ads 50 -
publisher_advertisers Advertisers 50 -
advertiser_publishers Publishers 100 -
advertiser_text_ads Advertiser Display Ads 100 -
advertiser_landings Landing Pages 100 -
advertiser_publisher_text_ads Advertiser Display Ads on a Publisher’s Website 100 -
advertiser_rank Advertisers Rank 10 -
publisher_rank Publishers Rank 10 -
backlinks_overview Backlinks Overview 40 -
backlinks Backlinks 40 -
backlinks_refdomains Referring Domains 40 -
backlinks_refips Referring IPs 40 -
backlinks_tld TLD Distribution 40 -
backlinks_geo Referring Domains by Country 40 -
backlinks_pages Indexed pages 40 -
If you would like to retrieve a large amount of data, please contact us for discounted rates.
Error Messages
  • ERROR 50 :: NOTHING FOUND
    We haven’t found any information related to your request.
  • ERROR 40 :: MANDATORY PARAMETER action NOT SET OR EMPTY
    The required parameter action is missing or has been mistyped. Please add it to your request, or check the spelling.
  • ERROR 41 :: MANDATORY PARAMETER type NOT SET OR EMPTY
    The required parameter type is missing or has been mistyped. Please add it to your request, or check the spelling.
  • ERROR 42 :: MANDATORY PARAMETER domain NOT SET OR EMPTY
    The required parameter domain is missing, or its value is not set. Please add it to your request, or set its value.
  • ERROR 43 :: MANDATORY PARAMETER phrase NOT SET OR EMPTY
    The required parameter phrase is missing, or its value is not set. Please add it to your request, or set its value.
  • ERROR 44 :: MANDATORY PARAMETER url NOT SET OR EMPTY
    The required parameter url is missing, or its value is not set. Please add it to your request, or set its value.
  • ERROR 120 :: WRONG KEY - ID PAIR
    You tried to use an unknown API key. Please go to your profile to find your correct API key.
  • ERROR 130 :: API DISABLED
    Your subscription doesn’t allow you to use API.
  • ERROR 131 :: LIMIT EXCEEDED
    The API request limit for the requested report has been reached. (Valid for users of old API plans.)
  • ERROR 132 :: API UNITS BALANCE IS ZERO
    The API request limit has been reached. To continue using API, recharge your balance, or upgrade your subscription.
  • ERROR 133 :: DB ACCESS DENIED
    You are not allowed to access the requested database.
  • ERROR 134 :: TOTAL LIMIT EXCEEDED
    The API request limit has been reached. (Valid for users of old API plans.)
  • ERROR 135 :: API REPORT TYPE DISABLED
    You are not allowed to access the requested report.
Terms of use

If you integrate SEMrush API in your own web service you should send X-Real-IP header with your requests! (In case a partner's user overloads the server, we'd like to have an opportunity to disconnect the specific user without blocking the partner's access to SEMrush's API. For this reason, it is necessary for us to know the IP of the end-consumer.)

Publication of data provided by the service is only possible with reference to the data source or proper branding on the site. Any other type of publication is strictly prohibited.

The use of information provided by this service for commercial and other third-party services in the form in which it was obtained directly from the service without the express written consent of SEMrush.com is strictly prohibited.

You may not perform more than 10 requests per second, nor more than 2 simultaneous requests.

Integration scripts examples

Below are three simple scripts showing how SEMrush API data can be integrated into your web project. Examples are written in PERL, PHP, and JavaScript (using YQL). All you have to do is: download the script that suits you best, unzip it, set some parameters (explained in comments, in a script body), and upload it to your web server.

Attention!!! Use the JavaScript example with caution as your API key will be visible to anyone who views your page source!!!

  • PERL SEMrush API integration example script - perl_example.zip
  • PHP SEMrush API integration example script - php_example.zip
  • JavaScript SEMrush API integration example script - js_example.zip - Using this method, your API key will be visible to anyone who views your page source!!!
Billing example
Let’s suppose that you would like to receive 100 results of “domain_organic” report for the domain seobook.com. The request would appear as the following:
http://us.api.semrush.com/?action=report&type=domain_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=100&export=api&export_columns=Ph,Po,Pp,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&domain=seobook.com&display_sort=tr_desc
A single line of results for the “domain_organic” report costs 10 API units. Since 100 lines were requested, 100x10 = 1,000 API units that would be deducted from your account.
Check API units balance
http://www.semrush.com/users/countapiunits.html?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX