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.

Summary reports
 
Main report
domain_rank
Price 10 API units per line Historical Price 50 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=domain_rank&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export=api&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=seobook.com

Request parameters

NameValueDescription
type* domain_rank type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost seobook.com;9158;8139;70745;411708;0;0;0
 
Summary values history
domain_rank_history
Price 10 API units per line
 

Requested URL

http://DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)

Request example

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

Request parameters

NameValueDescription
type* domain_rank_history type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
display_daily 1 use of this parameter will allow you to receive a report on a domain's day-to-day position changes for the last 30 days, at least. In case If this parameter is not utilized your report will show monthly results for the current month and previous months.
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Rk, Or, Ot, Oc, Ad, At, Ac, Dt required fields separated by commas; if parameter is not specified default columns will be sent
display_sort dt_asc or dt_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Date 17;2012554;6960213;6739278;613433;1357628;1265412;20081215 14;2291631;8550119;7233402;456061;1403310;1369023;20090115 15;2554392;8510854;7129482;736756;1667289;1502623;20090315 12;2841336;8183599;6820876;1128789;1806967;1555226;20090515 15;2729120;8849182;7298148;1602683;2314847;1983092;20090715 18;2309468;8532688;6839386;1241054;1184032;1000871;20090915 17;3854583;8530994;6968773;1364674;1748614;1475326;20091015 17;2882456;8770712;7001679;1401952;2212672;1757371;20091115 17;2882456;8770712;7001679;1401952;2212672;1757371;20091215 16;2506570;8661303;6875400;854060;1064905;820961;20100115
 
Difference report
rank_difference
Price 20 API units per line Historical Price 100 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=rank_difference&export=api&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=5

Request parameters

NameValueDescription
type* rank_difference type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Om, Tm, Um, Am, Bm, Cm required fields separated by commas; if parameter is not specified default columns will be sent
display_sort om_asc, om_desc, tm_asc, tm_desc, um_asc, um_desc, am_asc, am_desc, bm_asc, bm_desc, cm_asc or cm_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

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 facebook.com;2;8328083;306965011;659681812;24498;101658;115411;356553;-53917144;-203683568;-13769;-62533;-140201 wikipedia.org;1;18110580;850114195;1060747503;132;764;492;280102;15948255;48066305;4;-37;-599 pinterest.com;34;2017864;19157937;15409297;137;417;317;202800;1914056;-1421976;-20;-2260;-187 amazon.com;7;12275347;122235239;105835754;4980133;10697932;7573015;198323;-2130528;-145943;-2365239;-6480593;-5721300 digsitevalue.net;520;178049;1455731;1477317;0;0;0;178049;1455731;1477317;0;0;0
 
SEMrush rank
rank
Price 10 API units per line Historical Price 50 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.backend.semrush.com/?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=rank&display_limit=10&export=api

Request parameters

NameValueDescription
type* rank type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost wikipedia.org;1;18110580;850114195;1060747503;132;764;492 facebook.com;2;8328083;306965011;659681812;24498;101658;115411 youtube.com;3;27075009;270278027;196309514;42014;4068560;802308 google.com;4;4771898;238038953;346361896;943900;3677116;5673854 twitter.com;5;2420034;161494962;190688361;2134;2793;5535 yahoo.com;6;13608582;157871149;163308562;166635;337645;285173 amazon.com;7;12275347;122235239;105835754;4980133;10697932;7573015 apple.com;8;1845218;113408295;140774774;56742;914652;1063267 imdb.com;9;2382600;75024451;56392372;209;1551;1916 about.com;10;6919609;64667789;83467099;5;24;9
 
Last user API queries
queries_api
Price Free
 

Requested URL

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

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

Request parameters

NameValueDescription
type* queries_api type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
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 fields separated by commas; if parameter is not specified default columns will be sent
display_filter filter for columns Ts, Db, Hs, Rt, Qu

Response example

"Time";"DB";"Historical";"Report type";"Query";"IP";"Offset";"Limit";"API line cost" "1369920584";"us";"0";"domain_organic_organic";"semrush.com";"19.17.110.107";"0";"10";"0" "1369916698";"us";"0";"domain_organic";"seobook.com";"197.71.123.191";"0";"10";"0" "1369916674";"us";"0";"domain_organic";"seobook.com";"197.71.123.191";"0";"100";"0"
 
Last user export queries
queries_export
Price Free
 

Requested URL

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

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

Request parameters

NameValueDescription
type* queries_export type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
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 fields separated by commas; if parameter is not specified default columns will be sent
display_filter filter for columns Ts, Db, Hs, Rt, Qu

Response example

"Time";"DB";"Historical";"Report type";"Query";"IP" "1369917315";"us";"1";"domain_organic";"photography.com";"19.170.20.171" "1369917303";"us";"1";"domain_organic";"semrush.com";"31.117.13.160" "1369917295";"us";"1";"domain_organic";"seoquake.com";"31.117.13.160"
Reports for domain
 
Organic keywords report
domain_organic
Price 10 API units per line Historical Price 50 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=domain_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CPh%7CCo%7Cseo&display_limit=10&export=api&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&domain=seobook.com&display_sort=tr_desc

Request parameters

NameValueDescription
type* domain_organic type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr, Td required fields separated by commas; if parameter is not specified default columns will be sent
display_sort tr_asc, tr_desc, po_asc, po_desc, tc_asc or tc_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted
display_positionsnew, lost, rise or fallnew - show keywords which appeared in current month
lost - show keywords which disappeared in current month
rise - show keywords which improved their positions in current month
fall - show keywords which declined their positions in current month
display_filter filter for columns Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr

Response example

Keyword;Position;Previous Position;Search Volume;CPC;Url;Traffic (%);Traffic Cost (%);Competition;Number of Results;Trends seo tools;1;1;8100;8.43;http://tools.seobook.com/;5.38;7.79;0.85;50000000;0.36,0.36,0.36,0.55,0.99,0.36,0.45,0.45,0.36,0.36,0.36,0.30 seo;10;8;90500;11.54;http://www.seobook.com/;3.83;7.61;0.87;1150000000;0.82,0.82,0.82,0.82,0.82,0.82,0.99,0.99,0.82,0.82,0.82,0.82 seo training;1;1;2900;11.68;http://training.seobook.com/;1.92;3.86;0.94;27600000;0.55,0.55,0.43,0.55,0.55,0.55,0.82,0.82,0.82,0.82,0.99,0.55 seo book;1;1;1900;10.26;http://www.seobook.com/;1.26;2.22;0.15;31500000;0.66,0.83,0.55,0.66,0.99,0.55,0.66,0.66,0.66,0.66,0.66,0.66 seo tool;1;1;1600;7.50;http://tools.seobook.com/;1.06;1.36;0.81;21500000;0.55,0.55,0.45,0.83,0.83,0.99,0.66,0.55,0.45,0.30,0.34,0.66 free seo tools;1;1;1600;4.38;http://tools.seobook.com/;1.06;0.80;0.82;42200000;0.79,0.79,0.67,0.67,0.67,0.67,0.67,0.79,0.67,0.99,0.79,0.54 seobook;1;1;1300;10.51;http://www.seobook.com/;0.86;1.55;0.06;1040000;0.63,0.63,0.63,0.63,0.81,0.81,0.81,0.99,0.99,0.99,0.99,0.99 seo link building;2;2;2900;13.66;http://www.seobook.com/archives/001792.shtml;0.53;1.25;0.76;25100000;0.44,0.44,0.30,0.44,0.44,0.44,0.54,0.99,0.99,0.81,0.44,0.35 seo courses;1;2;720;10.60;http://training.seobook.com/;0.47;0.87;0.83;14300000;0.09,0.17,0.07,0.13,0.20,0.20,0.17,0.99,0.55,0.30,0.17,0.11 seo toolbar;1;1;720;1.73;http://tools.seobook.com/seo-toolbar/;0.47;0.14;0.52;3520000;0.55,0.55,0.55,0.67,0.67,0.82,0.82,0.82,0.99,0.82,0.82,0.67
 
AdWords keywords report
domain_adwords
Price 20 API units per line Historical Price 100 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=domain_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Vu,Tr,Tc,Co,Nr,Td&domain=ebay.com&display_sort=po_asc

Request parameters

NameValueDescription
type* domain_adwords type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Po, Pp, Pd, Nq, Cp, Tr, Tc, Co, Nr, Td, Tt, Ds, Vu, Ur required fields separated by commas; if parameter is not specified default columns will be sent
display_sort tr_asc, tr_desc, po_asc, po_desc, tc_asc or tc_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted
display_positionsnew, lost, rise or fallnew - show keywords which appeared in current month
lost - show keywords which disappeared in current month
rise - show keywords which improved their positions in current month
fall - show keywords which declined their positions in current month
display_filter filter for columns Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr

Response example

Keyword;Position;Previous Position;Search Volume;CPC;Visible Url;Traffic (%);Traffic Cost (%);Competition;Number of Results;Trends vintage archtop;1;0;28;0.72;www.ebay.com/;0.00;0.00;0.46;1360000; euphorbia oblongata;1;0;16;0.10;www.ebay.com/home;0.00;0.00;0.04;22000; profile hubs;1;0;210;0.35;www.ebay.com/;0.00;0.00;0.14;32900000;0.81,0.81,0.99,0.81,0.99,0.99,0.81,0.81,0.65,0.81,0.99,0.99 craigslist philip markoff;1;0;5;0.10;www.ebay.com/;0.00;0.00;0.00;133000; ebay ham radio equipment;1;0;16;0.23;www.ebay.com/;0.00;0.00;0.56;852000; chauvet 1100 fog machine;1;0;12;0.98;www.ebay.com/;0.00;0.00;1.00;34000; antique photo props;1;0;22;0.19;www.ebay.com/;0.00;0.00;0.46;1210000; matilda jane fabric;1;0;36;0.20;www.ebay.com/children;0.00;0.00;0.42;97000; nishiki tri-a;1;0;73;0.18;www.ebay.com/;0.00;0.00;0.06;120000;0.99,0.79,0.52,0.52,0.65,0.41,0.41,0.33,0.26,0.26,0.41,0.52 lundy s sheepshead bay;1;0;28;0.10;www.ebay.com/;0.00;0.00;0.00;10000;
 
Unique Ads report
domain_adwords_unique
Price 40 API units per line
 

Requested URL

http://DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)

Request example

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

Request parameters

NameValueDescription
type* domain_adwords_unique type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Po, Pp, Nq, Cp, Tr, Tc, Co, Nr, Td, Tt, Ds, Vu, Ur, Pc required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted
display_filter filter for columns Tt, Ds, Vu

Response example

Title;Description;Visible Url;Url;Number of Keywords Great Deals on eBay;Huge selection of great items.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%253Djack%252520nicklaus%2525205%252520pound%252520note%26keyword%3Djack%2Bnicklaus%2B5%2Bpound%2Bnote%26crlp%3D11518574673_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s1%26device%3Dc;803 Products;Find Products for less.eBay - it's where you go to save.;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%253Dproducts%26keyword%3Dproducts%26crlp%3D33316690683_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s6%26device%3Dc;759 Products;Great Deals on Products.New eBay Buyer Protection Program.;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%253Dproducts%26keyword%3Dproducts%26crlp%3D33316690923_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s4%26device%3Dc;738 Great Deals on eBay; ;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%253Dwatchtower%252520phonograph%26keyword%3Dwatchtower%2Bphonograph%26crlp%3D21738654518_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s1%26device%3Dc;467 Great Deals on Products.;Big Savings on Products.eBay! Buy It New. Buy It Now.;www.ebay.com/Products;http://rover.ebay.com/rover/1/711-42618-2056-0/2%3Fmpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fsch%252Fi.html%253F_nkw%253Dproducts%26keyword%3Dproducts%26crlp%3D33316690803_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s2%26device%3Dc;420 Great Deals on eBay.;Big Savings on eBay.eBay! Buy It New. Buy It Now.;www.ebay.com/Shopping;http://rover.ebay.com/rover/1/711-42618-2056-0/2%3Fmpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fsch%252Fi.html%253F_nkw%253Dsympathy%252520card%252520for%252520loss%252520of%252520horse%26keyword%3Dsympathy%2Bcard%2Bfor%2Bloss%2Bof%2Bhorse%26crlp%3D31251472043_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s6%26device%3Dc;307 Parts & Accessories;Low prices on Parts & Accessories.Free Shipping available. Buy Now!;www.ebay.com/motors;http://rover.ebay.com/rover/1/711-42619-2056-0/2%3Fmpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fsch%252Fi.html%253F_nkw%253Dcamper%252520tops%252520for%252520toyota%252520tacoma%26keyword%3Dcamper%2Btops%2Bfor%2Btoyota%2Btacoma%26crlp%3D38647192444_2416792%26MT_ID%3D70%26geo_id%3D10232%26adpos%3D1s4%26device%3Dc;298 Products;Great Deals on Products. New eBay Buyer Protection Program.;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%253Dproducts%26keyword%3Dproducts%26crlp%3D33316690923_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1o1%26device%3Dc;287 Parts & Accessories;Great Deals on Parts & Accessories.eBay! Buy it new. Buy it now.™;www.ebay.com/motors;http://rover.ebay.com/rover/1/711-42618-2056-0/2%3Fmpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fsch%252Fi.html%253F_nkw%253Dh3%252520hummer%252520performance%252520chips%26keyword%3Dh3%2Bhummer%2Bperformance%2Bchips%26crlp%3D21520475523_2416792%26MT_ID%3D69%26geo_id%3D10232%26adpos%3D1s6%26device%3Dc;274 Parts & Accessories;Find Parts & Accessories for less.eBay - It's where you go to save.;www.ebay.com/motors;http://rover.ebay.com/rover/1/711-42619-2056-0/2%3Fmpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fsch%252Fi.html%253F_nkw%253Dstudebaker%252520transmission%252520adapter%26keyword%3Dstudebaker%2Btransmission%2Badapter%26crlp%3D24599763964_2416792%26MT_ID%3D70%26geo_id%3D10232%26adpos%3D1s1%26device%3Dc;262
 
Competitors in organic search report
domain_organic_organic
Price 40 API units per line Historical Price 200 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=domain_organic_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&domain=seobook.com

Request parameters

NameValueDescription
type* domain_organic_organic type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Cr, Np, Or, Ot, Oc, Ad required fields separated by commas; if parameter is not specified default columns will be sent
display_sort np_desc or cr_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Domain;Competitor Relevance;Common Keywords;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords seomoz.org;9.74;2401;16484;121258;829468;1747 wordstream.com;9.69;1720;9595;116498;444049;2011 wordtracker.com;9.33;1051;3116;24092;96913;0 seocentro.com;7.93;801;1959;16960;69289;0 seochat.com;6.40;768;3851;12506;62595;0 searchenginegenie.com;5.90;610;2193;9511;31152;0 webconfs.com;5.60;594;2457;17435;76167;0 googlekeywordtool.com;5.43;508;1209;42844;135929;0 searchenginejournal.com;5.41;1061;11452;60676;199070;0 link-assistant.com;5.24;489;1184;12680;50489;0
 
Competitors in AdWords search report
domain_adwords_adwords
Price 40 API units per line Historical Price 200 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=domain_adwords_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Dn,Cr,Np,Ad,At,Ac,Or&domain=ebay.com

Request parameters

NameValueDescription
type* domain_adwords_adwords type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Cr, Np, Ad, At, Ac, Or required fields separated by commas; if parameter is not specified default columns will be sent
display_sort np_desc or cr_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Domain;Competitor Relevance;Common Keywords;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords buycheapr.com;12.52;438612;2284912;1181473;816860;3 amazon.com;9.64;597838;4980133;10697932;7573015;12275347 nextag.com;8.51;242181;1626393;767841;753588;458564 shopzilla.com;6.14;151094;1242913;565875;525085;80786 compare99.com;5.98;113622;682060;453554;316934;0 pricedumper.com;4.16;64357;328690;161111;97203;0 pronto.com;4.00;85111;908052;390033;408012;56251 bizrate.com;3.77;74921;769978;342563;359977;163874 ask.com;3.35;266280;6714720;9757702;9335327;1491882 izito.com;3.30;104011;1932195;820889;945303;0
 
Potential ad/traffic buyers report
domain_organic_adwords
Price 40 API units per line Historical Price 200 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=domain_organic_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Dn,Np,Ad,At,Ac,Or&domain=ebay.com

Request parameters

NameValueDescription
type* domain_organic_adwords type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Np, Ad, At, Ac, Or required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Domain;Common Keywords;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords buycheapr.com;1156331;2284912;1181473;816860;3 ask.com;835725;6714720;9757702;9335327;1491882 nextag.com;689105;1626393;767841;753588;458564 shopzilla.com;605635;1242913;565875;525085;80786 amazon.com;1949670;4980133;10697932;7573015;12275347 izito.com;420002;1932195;820889;945303;0 pronto.com;423722;908052;390033;408012;56251 webcrawler.com;364955;3462433;6145132;4235062;0 bizrate.com;339513;769978;342563;359977;163874 compare99.com;320157;682060;453554;316934;0
 
Potential ad/traffic sellers report
domain_adwords_organic
Price 40 API units per line Historical Price 200 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=domain_adwords_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Dn,Np,Or,Ot,Oc,Ad&domain=ebay.com

Request parameters

NameValueDescription
type* domain_adwords_organic type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Np, Or, Ot, Oc, Ad required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Domain;Common Keywords;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords youtube.com;675999;27075009;270278027;196309514;42014 wikipedia.org;337919;18110580;850114195;1060747503;132 yahoo.com;314699;13608582;157871149;163308562;166635 facebook.com;146625;8328083;306965011;659681812;24498 amazon.com;723782;12275347;122235239;105835754;4980133 sears.com;101387;970705;6190294;4849970;51890 aliexpress.com;94543;786794;1057896;956128;934 ehow.com;111938;3896583;12046673;19643968;290485 alibaba.com;89407;1062949;1200792;1282261;10529 thefind.com;83502;586989;975736;761467;0
 
Ads history for domain
domain_adwords_historical
Price 100 API units per line
 

Requested URL

http://DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)

Request example

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

Request parameters

NameValueDescription
type* domain_adwords_historical type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Dt, Po, Cp, Nq, Tr, Ur, Tt, Ds, Vu, Cv required fields separated by commas; if parameter is not specified default columns will be sent
display_sort cv_asc or cv_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted
display_filter filter for columns Ph, Nq, Cp, Tr

Response example

Keyword;Date;Position;CPC;Search Volume;Traffic (%);Url;Title;Description;Visible Url amazon;20130115;1;0.10;24900000;10.93;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D15494587808%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D15660728032006131929%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26ref%3Dpd_sl_7j18redljs_e%26hvkeyid%3Damazon;<b>Amazon</b>.com® Official Site;Huge Selection and Amazing Prices. Free Shipping on Orders Over $25;www.amazon.com/ amazon;20121215;1;0.10;24900000;10.93;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D15494587808%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D10673480141069141609%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26ref%3Dpd_sl_7j18redljs_e%26hvkeyid%3Damazon;<b>Amazon</b>.com® Official Site;Huge Selection and Amazing Prices. Free Shipping on Orders Over $25;www.amazon.com/ amazon;20121115;1;0.10;24900000;10.93;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D15494587808%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D20975085612001691488%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26ref%3Dpd_sl_7j18redljs_e%26hvkeyid%3Damazon;<b>Amazon</b>.com® Official Site;Huge Selection and Amazing Prices. Free Shipping on Orders Over $25;www.amazon.com/ amazon;20121015;1;0.10;24900000;10.93;http://www.blend357.com/%3F4EyH72m%3DsYKE2465%26Jk625fD93ix%3D38VmJKw%26CHKRND%3D12484042332014418284;<b>Amazon</b>® Official Site - Huge Selection and Amazing Prices.;Free Shipping on Orders Over $25 ;www.amazon.com/ amazon;20120915;;;;10.93;;;; amazon;20120815;1;0.10;24900000;10.93;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D13191552728%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D12110069751568487700%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26ref%3Dpd_sl_7j18redljs_e%26hvkeyid%3Damazon;<b>Amazon</b>.com® Official Site;Huge Selection and Amazing Prices. Free Shipping on Orders Over $25;www.amazon.com/ amazon;20120715;1;0.10;24900000;10.93;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D15494587808%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D13836853582018898394%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26ref%3Dpd_sl_7j18redljs_e%26hvkeyid%3Damazon;<b>Amazon</b>.com® Official Site;Huge Selection and Amazing Prices. Free Shipping on Orders Over $25<br>;www.amazon.com/ amazon;20120615;1;0.10;24900000;10.93;http://www.amazon.com/%3Ftag%3Damazusnavi-20%26hvadid%3D13191552728%26hvpos%3D1t1%26hvexid%3D%26hvnetw%3Dg%26hvrand%3D1444322491240299493%26hvpone%3D%26hvptwo%3D%26hvqmt%3De%26ref%3Dpd_sl_7j18redljs_e%26hvkeyid%3Damazon;<b>Amazon</b>.com® Official Site;Huge Selection and Amazing Prices. Free Shipping on Orders Over $25<br>;www.amazon.com/ amazon;20120515;1;0.10;24900000;10.93;http://www.amazon.com/b/%3Fie%3DUTF8%26node%3D507846%26tag%3Damazusnavi-20%26hvadid%3D4896586421%26hydpos%3D1t1%26hydexid%3D%26hydnetw%3Dg%26hydrand%3D3585559811487608%26hydpone%3D%26hydptwo%3D%26hydmt%3De;<b>Amazon</b>.com® Official Site;Huge Selection and Amazing Prices. Free Shipping on Orders Over $25<br/>;www.amazon.com/ amazon;20120415;;;;10.93;;;; amazon;20120315;;;;10.93;;;; amazon;20120215;;;;10.93;;;;
 
Comparison of domains
domain_domains
Price 80 API units per line Historical Price 400 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&export=api&type=domain_domains&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domains=%2B%7Cor%7Cebay.c­om%7C-%7Cor%7Cimdb.com%7C%2B%7Cad%7Cyoutube.com&display_limit=10

Request parameters

NameValueDescription
type* domain_domains type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domains*stringurlencoded string which contains domains in specified format separated by "|". Domain consists of <sign>|<type>|<domain>, where
<sign> - possible operations: "+", "-", "*", "/"
<type> - "or" for organic or "ad" for adwords
<domain> - domain
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, P0, P1, P2, P3, P4, Nr, Cp, Co, Nq required fields separated by commas; if parameter is not specified default columns will be sent
display_sort p0_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, or nr_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted
display_filter filter for columns Ph, P0, P1, P2, P3, P4, Nq, Cp, Co, Nr

Response example

Keyword;Domain1 Pos;Domain2 Pos;Domain3 Pos;Domain4 Pos;Domain5 Pos;Number of Results;CPC;Average vol. chase;10;0;0;0;0;346000000;1.73;7480000 face;8;0;0;0;0;2440000000;0.50;6120000 imdb;1;0;0;0;0;353000000;0.53;3350000 tmz;5;0;0;0;0;42400000;0.10;3350000 cartoon network;20;0;0;0;0;199000000;0.37;2240000 www.youtube.com;0;1;0;0;0;21760000000;0.27;2240000 huffington post;14;0;0;0;0;687000000;1.29;2240000 firefox;14;0;0;0;0;583000000;0.34;1830000 fandango;3;0;0;0;0;21100000;0.74;1830000 firefox -install-global-extension;16;0;0;0;0;739000000;0.34;1830000
Reports for keywords
 
Main keyword report
phrase_this
Price 10 API units per line Historical Price 50 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=phrase_this&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export=api&export_columns=Ph,Nq,Cp,Co,Nr&phrase=search+engine+optimization

Request parameters

NameValueDescription
type* phrase_this type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
phrase*phrasephrase
export*api
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Nq, Cp, Co, Nr required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Keyword;Search Volume;CPC;Competition;Number of Results search engine optimization;33100;17.41;0.92;111000000
 
Organic results
phrase_organic
Price 10 API units per line Historical Price 50 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=phrase_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Dn,Ur&phrase=seo

Request parameters

NameValueDescription
type* phrase_organic type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
phrase*phrasephrase
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Ur required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Domain;Url wikipedia.org;http://en.wikipedia.org/wiki/Search_engine_optimization seomoz.org;http://www.seomoz.org/beginners-guide-to-seo searchengineland.com;http://searchengineland.com/guide/what-is-seo google.com;http://support.google.com/webmasters/bin/answer.py%3Fhl%3Den%26answer%3D35291 seo.com;http://www.seo.com/ mashable.com;http://mashable.com/category/seo/ seo-usa.org;http://www.seo-usa.org/ seobook.com;http://tools.seobook.com/ wisdek-seo.com;http://www.wisdek-seo.com/ searchenginewatch.com;http://searchenginewatch.com/seo
 
Related keyword report
phrase_related
Price 40 API units per line Historical Price 200 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=phrase_related&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Ph,Nq,Cp,Co,Nr,Td&phrase=search+engine+optimization

Request parameters

NameValueDescription
type* phrase_related type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
phrase*phrasephrase
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Nq, Cp, Co, Nr, Td required fields separated by commas; if parameter is not specified default columns will be sent
display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc or nr_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted
display_filter filter for columns Ph, Nq, Cp, Co, Nr

Response example

Keyword;Search Volume;CPC;Competition;Number of Results;Trends seo;90500;11.54;0.87;1150000000;0.82,0.82,0.82,0.82,0.82,0.82,0.99,0.99,0.82,0.82,0.82,0.82 internet marketing;22200;12.53;0.91;351000000;0.55,0.55,0.55,0.55,0.55,0.45,0.82,0.99,0.99,0.82,0.67,0.55 seo services;18100;18.67;0.91;61100000;0.67,0.67,0.55,0.82,0.82,0.67,0.99,0.82,0.99,0.82,0.67,0.55 seo company;18100;21.24;0.87;86400000;0.82,0.82,0.82,0.99,0.99,0.67,0.82,0.82,0.67,0.67,0.67,0.55 google search engine;12100;0.37;0.17;1180000000;0.67,0.67,0.67,0.67,0.67,0.67,0.67,0.82,0.82,0.82,0.82,0.99 what is seo;6600;4.66;0.44;423000000;0.81,0.81,0.81,0.81,0.81,0.99,0.99,0.99,0.81,0.81,0.67,0.67 search engine marketing;6600;15.14;0.90;447000000;0.81,0.81,0.67,0.81,0.67,0.67,0.99,0.99,0.81,0.99,0.81,0.81 local seo;6600;11.23;0.82;44500000;0.55,0.55,0.55,0.67,0.67,0.55,0.82,0.82,0.99,0.82,0.55,0.36 seo companies;5400;22.82;0.94;37300000;0.67,0.82,0.67,0.82,0.99,0.55,0.67,0.55,0.44,0.44,0.36,0.28 google seo;5400;7.66;0.68;468000000;0.82,0.82,0.82,0.67,0.67,0.82,0.82,0.99,0.99,0.82,0.67,0.67
 
Ads history for keyword
phrase_adwords_historical
Price 100 API units per line
 

Requested URL

http://DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)

Request example

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

Request parameters

NameValueDescription
type* phrase_adwords_historical type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
phrase*phrasephrase
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Dn, Dt, Po, Ur, Tt, Ds, Vu, At, Ac, Ad required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Domain;Date;Position;Url;Title;Description;Visible Url hulu.com;20130115;;;;; hulu.com;20121215;;;;; hulu.com;20121115;;;;; hulu.com;20121015;;;;; hulu.com;20120915;;;;; hulu.com;20120815;;;;; hulu.com;20120715;;;;; hulu.com;20120615;1;www.hulu.com/plus%3Fcmp%3D205;Watch <b>Movies</b> Online;Watch <b>Movies</b> & TV Shows Instantly. More Devices. Try Hulu Plus Free!<br><a href="/aclk?sa=l&ai=CX0dpcQPtT5mdLoGg0AGOhLDyDs343PAD7ZSJmkvrnNILCAMQAVDwutP7-P____8BYMkGoAHLkvHSA8gBAaoEIU_QE9vMXL0UWpwQj-Qu9NnZ9gHnc288w8bDzJ32LZbKuPoFCQgDEN372T4YAQ&ctype=4&sig=AOD64_0tEnEU4Q493RI5E2wlQrFxpL7EGQ&adurl=http://www.hulu.com/plus%3Fsrc%3Dsem-plus-google%26cmp%3D205%26sitelink%3D1">Free Trial</a> - <a href="/aclk?sa=l&ai=Cy2s2cQPtT5mdLoGg0AGOhLDyDs343PAD7ZSJmkvrnNILCAMQAVCg-pAUYMkGoAHLkvHSA8gBAaoEIU_QE9vMXL0UWpwQj-Qu9NnZ9gHnc288w8bDzJ32LZbKuPoFCQgDEN372T4YAg&ctype=4&sig=AOD64_3e2mChdJxc9P5kq6WfKe2JO6c4sA&adurl=http://www.hulu.com/plus/devices%3Fsrc%3Dsem-plus-google%26sitelink%3D2">Hulu Plus on Wii</a> - <a href="/aclk?sa=l&ai=CNF5fcQPtT5mdLoGg0AGOhLDyDs343PAD7ZSJmkvrnNILCAMQAVCkr6-XB2DJBqABy5Lx0gPIAQGqBCFP0BPbzFy9FFqcEI_kLvTZ2fYB53NvPMPGw8yd9i2Wyrj6BQkIAxDd-9k-GAM&ctype=4&sig=AOD64_1QV_k-C4k0jrDNLohjGJ69n1WA0Q&adurl=http://www.hulu.com/plus/devices%3Fsrc%3Dsem-plus-google%26sitelink%3D3">Hulu Plus on PS3</a> - <a href="/aclk?sa=l&ai=C6Lm-cQPtT5mdLoGg0AGOhLDyDs343PAD7ZSJmkvrnNILCAMQAVCsod21AmDJBqABy5Lx0gPIAQGqBCFP0BPbzFy9FFqcEI_kLvTZ2fYB53NvPMPGw8yd9i2Wyrj6BQkIAxDd-9k-GAQ&ctype=4&sig=AOD64_01kaCi219UL0vDCvrDLUWOYAFNMg&adurl=http://www.hulu.com/plus/devices%3Fsrc%3Dsem-plus-google%26sitelink%3D4">Hulu Plus on Xbox</a><br>;www.hulu.com/plus hulu.com;20120515;;;;; hulu.com;20120415;;;;; hulu.com;20120315;;;;; hulu.com;20120215;;;;;
 
Phrase match report
phrase_fullsearch
Price 20 API units per line
 

Requested URL

http://DB.fullsearch-api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)

Request example

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

Request parameters

NameValueDescription
type* phrase_fullsearch type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
phrase*phrasephrase
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Nq, Cp, Co, Nr, Td required fields separated by commas; if parameter is not specified default columns will be sent
display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc or nr_desc
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted
display_filter filter for columns Ph, Nq, Cp, Co, Nr

Response example

Keyword;Search Volume;CPC;Competition;Number of Results;Trends buy movie tickets online;3600;0.37;0.35;42200000;0.99,0.99,0.44,0.81,0.30,0.99,0.54,0.23,0.20,0.44,0.20,0.12 buy tickets online;1600;1.49;0.93;266000000;0.99,0.99,0.81,0.99,0.99,0.99,0.81,0.63,0.63,0.99,0.81,0.81 buy lottery tickets online;1300;0.76;0.22;19400000;0.09,0.09,0.07,0.09,0.13,0.99,0.13,0.13,0.13,0.11,0.11,0.09 buy mega millions lottery tickets online;590;1.48;0.07;203000;0.00,0.00,0.00,0.00,0.01,0.99,0.00,0.00,0.00,0.00,0.00,0.00 can you buy lottery tickets online;390;1.10;0.04;2690000;0.14,0.14,0.09,0.09,0.07,0.17,0.99,0.17,0.17,0.14,0.11,0.11 buy concert tickets online;320;1.38;0.90;42700000;0.67,0.67,0.82,0.99,0.99,0.99,0.99,0.67,0.99,0.82,0.82,0.54 buying movie tickets online;320;0.24;0.36;2580000;0.99,0.99,0.67,0.81,0.54,0.99,0.54,0.44,0.67,0.99,0.35,0.35 buy lotto tickets online;320;0.81;0.33;581000;0.07,0.07,0.06,0.06,0.11,0.99,0.11,0.11,0.09,0.07,0.11,0.07 buy airline tickets online;260;1.78;0.97;5020000;0.99,0.99,0.66,0.53,0.44,0.53,0.44,0.44,0.66,0.99,0.99,0.99 buy mega millions tickets online;210;1.52;0.10;171000;0.00,0.00,0.00,0.00,0.04,0.99,0.00,0.01,0.00,0.00,0.00,0.00
Reports for URL
 
Organic URL report
url_organic
Price 10 API units per line Historical Price 50 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=url_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Ph,Po,Nq,Cp,Co,Tr,Tc,Nr,Td&url=http://tools.seobook.com/

Request parameters

NameValueDescription
type* url_organic type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
url*http://example.com/URL
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Keyword;Position;Search Volume;CPC;Competition;Traffic (%);Traffic Cost (%);Number of Results;Trends seo tools;1;8100;8.43;0.85;5.38;7.79;50000000;0.36,0.36,0.36,0.55,0.99,0.36,0.45,0.45,0.36,0.36,0.36,0.30 seo book;3;1900;10.26;0.15;0.24;0.42;31500000;0.66,0.83,0.55,0.66,0.99,0.55,0.66,0.66,0.66,0.66,0.66,0.66 seo tool;1;1600;7.50;0.81;1.06;1.36;21500000;0.55,0.55,0.45,0.83,0.83,0.99,0.66,0.55,0.45,0.30,0.34,0.66 free seo;4;1600;4.09;0.95;0.15;0.11;74800000;0.54,0.67,0.67,0.54,0.54,0.54,0.54,0.67,0.67,0.99,0.67,0.54 free seo tools;1;1600;4.38;0.82;1.06;0.80;42200000;0.79,0.79,0.67,0.67,0.67,0.67,0.67,0.79,0.67,0.99,0.79,0.54 google seo tools;15;1300;6.73;0.92;0.00;0.01;50100000;0.63,0.81,0.63,0.81,0.63,0.63,0.99,0.81,0.99,0.81,0.63,0.45 free seo software;7;880;4.49;0.86;0.04;0.03;42400000;0.68,0.99,0.68,0.77,0.55,0.68,0.77,0.68,0.77,0.68,0.55,0.45 seo program;10;880;10.74;0.86;0.03;0.06;281000000;0.37,0.55,0.45,0.37,0.37,0.37,0.45,0.55,0.99,0.99,0.63,0.45 search engine optimization software;1;880;10.54;0.86;0.58;1.05;34100000;0.46,0.46,0.31,0.38,0.38,0.31,0.53,0.53,0.99,0.68,0.46,0.25 search engine seo;9;720;8.74;0.67;0.03;0.04;292000000;0.72,0.72,0.48,0.59,0.72,0.72,0.72,0.59,0.88,0.99,0.99,0.72
 
AdWords URL report
url_adwords
Price 20 API units per line Historical Price 100 API units per line
 

Requested URL

http://[DATE.]DB.api.semrush.com/

Name Value Description
DB* "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) or "tr" (Google.com.tr) requested database (one value from the list)
DATE date in format "YYYYMM15" allows users to build reports by using historical data that is available for 11 databases* dating back to January 2012 and for 15 new regional databases** containing gathered data from December 2013 forward
* 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://us.api.semrush.com/?action=report&type=url_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=5&export=api&export_columns=Ph,Po,Nq,Cp,Co,Tr,Tc,Nr,Td,Tt,Ds&url=http://www.amazon.com/

Request parameters

NameValueDescription
type* url_adwords type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
url*http://example.com/URL
export*api
display_limitintegernumber of results returned; if the parameter is not specified or equal to 0, the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td, Tt, Ds required fields separated by commas; if parameter is not specified default columns will be sent
export_decode1 or 00 means that response will be given as urlencoded string
1 means that response will not be converted

Response example

Keyword;Position;Search Volume;CPC;Competition;Traffic (%);Traffic Cost (%);Number of Results;Trends;Title;Description amazon;1;24900000;0.10;0.06;10.93;1.54;2220000000;0.67,0.67,0.67,0.67,0.67,0.67,0.67,0.82,0.99,0.82,0.55,0.55;<b>Amazon</b>.com® Official Site;Huge Selection and Amazing Prices. Free Shipping on Orders Over $25 iphone 5;6;2740000;2.92;0.11;0.12;0.52;6190000000;0.37,0.37,0.24,0.20,0.16,0.20,0.20,0.24,0.37,0.37,0.82,0.99;<b>iPhone 5</b> at Amazon.com;Buy <b>iPhone 5</b> at Amazon!<br>Qualified orders over $25 ship free louis vuitton;3;1000000;0.72;0.22;0.08;0.08;178000000;0.67,0.67,0.55,0.82,0.67,0.82,0.82,0.82,0.99,0.99,0.67,0.67;<b>Louis Vuitton</b> Outlets;Buy <b>louis vuitton</b> outlets at Amazon! Qualified orders over $25 ship free iphone 4s;7;673000;2.66;0.82;0.02;0.09;519000000;0.09,0.09,0.09,0.11,0.09,0.11,0.13,0.16,0.20,0.25,0.99,0.01;Apple <b>4S iPhone</b> at Amazon;Buy apple <b>4S iPhone</b> at Amazon!<br>Qualified orders over $25 ship free ipod touch;3;450000;0.60;0.86;0.03;0.03;693000000;0.30,0.30,0.30,0.30,0.30,0.37,0.37,0.45,0.99,0.82,0.55,0.37;<b>iPod Touch</b>' at Amazon.com;Buy <b>iPod touch</b>' at Amazon! Qualified orders over $25 ship free
Adsense reports
 
Publisher text ads report
publisher_text_ads
Price 50 API units per line
 

Requested URL

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

Request example

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

Request parameters

NameValueDescription
type* publisher_text_ads type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns title,text, first_seen, last_seen, times_seen, avg_position, media_type, visible_url required fields separated by commas; if parameter is not specified default columns will be sent
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_asc or times_seen_desc
device_typeall, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_androidIf parameter is not specified default value is all
display_filter filter for columns title, text

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 report
publisher_advertisers
Price 50 API units per line
 

Requested URL

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

Request example

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

Request parameters

NameValueDescription
type* publisher_advertisers type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns domain, ads_count, first_seen, last_seen, times_seen, ads_percent required fields separated by commas; if parameter is not specified default columns will be sent
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc ads_count_asc or ads_count_desc
device_typeall, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_androidIf parameter is not specified default value is all
display_filter filter for columns domain

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 report
advertiser_publishers
Price 100 API units per line
 

Requested URL

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

Request example

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

Request parameters

NameValueDescription
type* advertiser_publishers type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns domain, ads_count, first_seen, last_seen, times_seen, ads_percent required fields separated by commas; if parameter is not specified default columns will be sent
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc ads_count_asc or ads_count_desc
device_typeall, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_androidIf parameter is not specified default value is all
display_filter filter for columns domain

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 report
advertiser_text_ads
Price 100 API units per line
 

Requested URL

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

Request example

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

Request parameters

NameValueDescription
type* advertiser_text_ads type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns title,text, first_seen, last_seen, times_seen, avg_position, media_type, visible_url required fields separated by commas; if parameter is not specified default columns will be sent
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_asc or times_seen_desc
device_typeall, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_androidIf parameter is not specified default value is all
display_filter filter for columns title, text

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 report
advertiser_landings
Price 100 API units per line
 

Requested URL

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

Request example

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

Request parameters

NameValueDescription
type* advertiser_landings type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns target_url, first_seen, last_seen, times_seen, ads_count required fields separated by commas; if parameter is not specified default columns will be sent
display_sort ast_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_desc, ads_count_asc or ads_count_desc
device_typeall, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_androidIf parameter is not specified default value is all
display_filter filter for columns target_url

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 report
advertiser_publisher_text_ads
Price 100 API units per line
 

Requested URL

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

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

Request parameters

NameValueDescription
type* advertiser_publisher_text_ads type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
display_limitintegernumber of results returned; if the parameter is not specified the default value will be 10 000
display_offsetintegerinstructs to skip a specified number of results before beginning to return results to you
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset
export_escape1value "1" means that columns will be wrapped in double quotes
export_columns title,text, first_seen, last_seen, times_seen, avg_position, media_type, visible_url required fields separated by commas; if parameter is not specified default columns will be sent
display_sort last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc, times_seen_asc, times_seen_asc or times_seen_desc
device_typeall, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_androidIf parameter is not specified default value is all
display_filter filter for columns title, text

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
advertiser_rank
Price 10 API units per line
 

Requested URL

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

Request example

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

Request parameters

NameValueDescription
type* advertiser_rank type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
export_escape1value "1" means that columns will be wrapped in double quotes
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 fields separated by commas; if parameter is not specified default columns will be sent
device_typeall, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_androidIf parameter is not specified default value is all

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
publisher_rank
Price 10 API units per line
 

Requested URL

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

Request example

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

Request parameters

NameValueDescription
type* publisher_rank type of the request
key* XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX user identification key - available through your profile on the site
domain*example.comdomain
export*api
export_escape1value "1" means that columns will be wrapped in double quotes
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 fields separated by commas; if parameter is not specified default columns will be sent
device_typeall, desktop, smartphone_apple, smartphone_android, tablet_apple, tablet_androidIf parameter is not specified default value is all

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
Description of columns from response:
Ac - Estimated expenses the site has for advertising in Ads (per month)
Ad - Keywords this site has in the TOP20 Ads results
Am - Number of adwords keywords changes
At - Estimated number of visitors coming from Ads (per month)
Bm - Adwords traffic changes
Cm - Adwords traffic price changes
Co - Competition of advertisers for that term (the higher the number - the greater the competition)
Cp - Average price of a click on an Ad for this search query (in U.S. dollars)
Cr - Competition level based on keywords
Cv - Keyword coverage is the percentage of ads displayed for a particular keyword during a specified period (100% = 12 months)
Db - Database
Dn - A site name
Ds - Ad text
Dt - Actual date
Hs - Whether the report is historical?
Ip - IP address
Lc - API units per line
Li - Limit
Np - The number of keywords for which the site is displayed in search results in common with the analyzed site
Nq - The approximate 12-month average of the number of queries for the keyword (for the corresponding local version of search engine)
Nr - The number of search results - how many results does the search engine return for this query
Oc - Estimated cost of purchasing the same number of visitors through Ads
Of - Offset
Om - Number of organic keywords changes
Or - Keywords this site has in the TOP20 organic results
Ot - Estimated number of visitors coming from the first 20 search results (per month)
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 search query the site has within the first 20 search results
Po - The position of this URL for this keyword in organic or Ads results
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 - Rating of sites by the number of visitors coming from the first 20 search results
Rk - Rating of sites by the number of visitors coming from the first 20 search results
Rt - Report type
Tc - The ratio of the estimated cost of buying the same number of visitors for this search query to the estimated cost of purchasing the same number of targeted visitors coming to this URL
Td - Dynamics of change in the number of search queries in the past 12 months (estimated)
Tm - Organic traffic changes
Tr - The ratio of the number of visitors coming to the URL from this keyword to all visitors coming
Ts - UNIX Timestamp
Tt - Ad Title
Um - Organic traffic cost changes
Ur - Url of the target page
Vu - Visible URL
domain - Domain name
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
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
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
first_seen - Timestamp when we have seen for the first time (s)
last_seen - Timestamp when we have seen for the last time (s)
times_seen - Number of times we saw ad
title - Title of the ad
text - Text of the ad
avg_positions - An average position of the ad
media_type - Media type of the ad
visible_url - Visible url of the ad
target_url - Landing page of the ad
advertisers_count - The total number of advertisers by 7 days
advertisers_overall - The total number of advertisers
publishers_count - The total number of publishers by 7 days
publishers_overall - The total number of publishers
anchor - Text between open and close <a> tag
external_num - External links number on source page
image_alt - Image alt between open and close <a> tag
internal_num - Internal links number on source page
image_url - Image url between open and close <a> tag
response_code - Server response code
redirect_url - Last url in redirect chain
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
type - Link with nofollow flag
  • 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.
TypeDescriptionAPI units, per lineHistorical data
domain_rankDomain: Rank1050
domain_rank_historyDomain: Rank history10-
domain_organicDomain: Organic keywords1050
domain_adwordsDomain: Ads keywords20100
domain_adwords_uniqueDomain: Ads copies40-
domain_organic_organicDomain: Organic competitors40200
domain_organic_adwordsDomain: Potential ads buyers40200
domain_adwords_organicDomain: Potential ads sellers40200
domain_adwords_adwordsDomain: Ads competitors40200
phrase_fullsearchPhrase: Phrase match report20-
phrase_relatedPhrase: Related keywords report40200
phrase_organicPhrase: Organic results1050
phrase_adwordsPhrase: Ads results20100
phrase_thisPhrase: General info1050
domain_domainsDomain VS Domains80400
url_organicURL: Organic report1050
url_adwordsURL: Ads report20100
rank_differenceRank: Ups & Downs20100
domain_adwords_historicalDomain: Ads history100-
phrase_adwords_historicalPhrase: Ads history100-
publisher_text_adsAdsense: Publisher text ads50-
publisher_advertisersAdsense: Publisher advertisers50-
advertiser_publishersAdsense: Advertiser publishers100-
advertiser_text_adsAdsense: Advertiser text ads100-
advertiser_landingsAdsense: Advertiser landings100-
advertiser_publisher_text_adsAdsense: Advertiser publisher text ads report100-
advertiser_rankAdsense: Advertiser rank10-
publisher_rankAdsense: Publisher rank10-
links_domainBacklinks: Report for root domain40-
linksBacklinks: Report for URL40-
links_hostnameBacklinks: Report for domain40-
If you would like to retrieve a large amount of data, please contact us for discounted rates.
Error Messages
  • ERROR 30 :: LIMIT EXCEEDED
  • ERROR 50 :: NOTHING FOUND
  • ERROR 70 :: API KEY HASH FAILURE
  • ERROR 40 :: MANDATORY PARAMETER action NOT SET OR EMPTY
  • ERROR 41 :: MANDATORY PARAMETER type NOT SET OR EMPTY
  • ERROR 42 :: MANDATORY PARAMETER domain NOT SET OR EMPTY
  • ERROR 43 :: MANDATORY PARAMETER phrase NOT SET OR EMPTY
  • ERROR 44 :: MANDATORY PARAMETER url NOT SET OR EMPTY
  • ERROR 120 :: WRONG KEY - ID PAIR
  • ERROR 121 :: WRONG FORMAT OR EMPTY HASH
  • ERROR 122 :: WRONG FORMAT OR EMPTY KEY
  • ERROR 130 :: API DISABLED
  • ERROR 131 :: LIMIT EXCEEDED
  • ERROR 132 :: API UNITS BALANCE IS ZERO
  • ERROR 133 :: DB ACCESS DENIED
  • ERROR 134 :: TOTAL LIMIT EXCEEDED
  • ERROR 135 :: API REPORT TYPE DISABLED
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://de.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/de/users/countapiunits.html?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX