logo-small

SEMrush API
3.0

Any questions?
US customers, Toll-Free
+1-855-814-4510
offline
Monday through Friday (ET)
Europe customers, Toll-Free
United Kingdom
España
France
Italia
Россия
0-808-189-3160
offline
Monday through Monday in your local time

Analytics API

Once you get your API key, you can start integrating with SEMrush API. Below you will find which reports you can request and which columns, parameters, values, sortings, and filters you can use.

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_ranksA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database; if this parameter is not specified, your request will be sent to all regional databases.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Db, Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sv, Sh Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

Database;Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;PLA uniques;PLA keywords us;seobook.com;40421;36547;41026;187439;0;0;0;0;0
Price: 10 API units per line Historical Price: 50 API units per line

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_rankA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_rank_historyA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_daily1This parameter allows you to get daily updates on position changes that occurred in the last 30 days or more. If the parameter is not specified, your report will show monthly results for the current month and for previous months.
export_columns Rk, Or, Ot, Oc, Ad, At, Ac, Dt Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort dt_asc, dt_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*rank_differenceA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Om, Tm, Um, Am, Bm, Cm Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort om_asc, om_desc, tm_asc, tm_desc, um_asc, um_desc, am_asc, am_desc, bm_asc, bm_desc, cm_asc, cm_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*rankA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Rk, Or, Ot, Oc, Ad, At, Ac Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_organicA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr, Td Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort tr_asc, tr_desc, po_asc, po_desc, tc_asc, tc_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_positions new, lost, rise or fall The value "new" indicates keywords with which a domain entered Google's top 20 organic or paid search results;
"lost" indicates keywords that no longer bring a domain to Google's top 20 organic or paid search results;
"rise" indicates keywords that helped a domain to get a higher ranking in Google's top 20 organic or paid search results;
"fall" indicates keywords that are currently helping a domain remain in the Google top 20, though its ranking may have decreased.
display_filter Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr Filters for columns.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

This report lists keywords that bring users to a domain via Google's paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_adwordsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Po, Pp, Pd, Ab, Nq, Cp, Tr, Tc, Co, Nr, Td, Tt, Ds, Vu, Ur Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort tr_asc, tr_desc, po_asc, po_desc, tc_asc, tc_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_positions new, lost, rise or fall The value "new" indicates keywords with which a domain entered Google's top 20 organic or paid search results;
"lost" indicates keywords that no longer bring a domain to Google's top 20 organic or paid search results;
"rise" indicates keywords that helped a domain to get a higher ranking in Google's top 20 organic or paid search results;
"fall" indicates keywords that are currently helping a domain remain in the Google top 20, though its ranking may have decreased.
display_filter Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr Filters for columns.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_adwords_uniqueA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Ph, Po, Pp, Cp, Tr, Co, Td, Tt, Ds, Vu, Ur, Pc Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_filter Tt, Ds, Vu Filters for columns.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_organic_organicA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Cr, Np, Or, Ot, Oc, Ad Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort np_desc, cr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_adwords_adwordsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Cr, Np, Ad, At, Ac, Or Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort np_desc, cr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_adwords_historicalA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Ph, Dt, Po, Cp, Nq, Tr, Ur, Tt, Ds, Vu, Cv Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort cv_asc, cv_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, Nq, Cp, Tr Filters for columns.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_domainsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domains*stringA URL-encoded string that contains domains in a specified format, separated by "|".
This format requires a domain to consist of <sign>|<type>|<domain>, where the<sign> means possible operations: "+", "-", "*", "/";
<type> has to take the value of "or" for organic keywords or "ad" for paid keywords; and
<domain> indicates a domain.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, P0, P1, P2, P3, P4, Nr, Cp, Co, Nq Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_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, nr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, P0, P1, P2, P3, P4, Nq, Cp, Co, Nr Filters for columns.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

http://api.semrush.com/?type=domain_domains&database=us&display_limit=10&domains=*|or|ebay.com|*|or|imdb.com|*|or|youtube.com&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Response example

Keyword;Domain1 Pos;Domain2 Pos;Domain3 Pos;Domain4 Pos;Domain5 Pos;Number of Results;CPC;Average vol. kim kardashian;48;17;31;0;0;183000000;0.12;5000000 ups;27;89;10;0;0;705000000;0.17;3350000 michael kors;84;58;19;0;0;74300000;0.23;1830000 m;95;1;11;0;0;2395098000;1.67;1500000 straight talk;57;10;22;0;0;29100000;0.50;1220000 khloe kardashian;39;20;27;0;0;0;0.08;1220000 cars;61;3;36;0;0;1350000000;1.24;1220000 e;3;28;6;0;0;2770130000;4.21;1000000 kourtney kardashian;45;17;26;0;0;32700000;0.17;1000000 search;88;18;45;0;0;1975098000;1.22;823000
 
domain_shopping
Price: 30 API units per line Historical Price: 150 API units per line

This report lists keywords that trigger a domain’s product listing ads to appear in Google's paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_shoppingA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "ie" (google.ie), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "at" (google.at), "cl" (google.cl), "co" (google.co), "cz" (google.cz), "id" (google.id), "my" (google.my), "nz" (google.nz), "ph" (google.ph), "pt" (google.pt), "za" (google.za), "ae" (google.ae) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Ph,Po,Pp,Pd,Nq,Sn,Ur,Tt,Pr,Ts Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort po_asc, po_desc, nq_asc, nq_desc, pr_asc, pr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph,Po,Nq,Ur,Tt,Pr Filters for columns.

Request example

http://api.semrush.com/?type=domain_shopping&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&database=us&display_limit=3&display_sort=tr_desc&export_columns=Ph,Po,Pp,Pd,Nq,Sn,Ur,Tt,Pr,Ts

Response example

Keyword;Position;Previous Position;Position Difference;Search Volume;Shop Name;Url;Title;Product Price;Timestamp iphone 6s;2;0;-2;2240000;eBay;http://www.ebay.com/itm/like/162516889386;iPhone 6s 32GB Unlocked and SIM Free - Rose Gold -;399.99;1495581586 iphone 6;2;0;-2;1220000;eBay;http://www.ebay.com/itm/like/282433635239;Apple iPhone 6s - 32 GB - Space Gray - Unlocked - ...;348.74;1495563580 nexus 6;1;0;-1;246000;eBay;http://www.ebay.com/itm/like/382078481479?chn=ps;Google Nexus 6;206.99;1495590610
 
domain_shopping_unique
Price: 60 API units per line Historical Price: 300 API units per line

This report shows product listing ad copies SEMrush noticed when the domain ranked in Google's paid search results for keywords from our databases.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_shopping_uniqueA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "ie" (google.ie), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "at" (google.at), "cl" (google.cl), "co" (google.co), "cz" (google.cz), "id" (google.id), "my" (google.my), "nz" (google.nz), "ph" (google.ph), "pt" (google.pt), "za" (google.za), "ae" (google.ae) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Tt,Pr,Ur,Pc Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort pr_asc, pr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Tt,Pr Filters for columns.

Request example

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

Response example

Keyword;Position;Previous Position;Search Volume;CPC;Traffic (%);Traffic Cost (%);Competition;Number of Results;Trends;Title;Description;Visible Url;Url;Number of Keywords best cheap e cig;1;2;170;0.00;0.00;0.00;0.03;1397000;0.81,0.81,0.81,0.67,0.67,0.81,0.81,0.81,0.52,0.81,0.81,0.99;Electronic E Vape E Penevod 900mah;Description;Visible Url;http://rover.ebay.com/rover/1/711-117182-37290-0/2%3Fmtid%3D1588%26kwid%3D1%26crlp%3D53601919689_324272%26itemid%3D171566785432%26targetid%3D87946128969%26rpc%3D0.22%26rpc_upld_id%3D39899%26device%3Dc%26mpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fitm%252Flike%252F171566785432%253Flpid%253D82%26adtype%3Dpla;320 most popular electronic cigarette;3;0;110;0.00;0.00;0.00;0.07;1397000;0.28,0.53,0.41,0.82,0.53,0.65,0.99,0.99,0.82,0.82,0.82,0.99;Electronic E Vape E Penevod 900mah;Description;Visible Url;http://rover.ebay.com/rover/1/711-117182-37290-0/2%3Fmtid%3D1588%26kwid%3D1%26crlp%3D53601919689_324272%26itemid%3D171566785432%26targetid%3D87946125249%26rpc%3D0.20%26rpc_upld_id%3D40243%26device%3Dc%26mpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fitm%252Flike%252F171566785432%253Flpid%253D82%26adtype%3Dpla;168 ego electronic cigarette starter kit;1;1;590;0.07;0.00;0.00;0.69;1998000;0.39,0.39,0.32,0.32,0.32,0.72,0.99,0.59,0.59,0.48,0.72,0.72;E Vapor Pen With Charger Ce4 Vaporizer Pen Starter Kit -;Description;Visible Url;http://rover.ebay.com/rover/1/711-117182-37290-0/2%3Fmtid%3D1588%26kwid%3D1%26crlp%3D53601919689_324272%26itemid%3D261500197495%26targetid%3D87946124169%26rpc%3D0.18%26rpc_upld_id%3D39899%26device%3Dc%26mpre%3Dhttp%253A%252F%252Fwww.ebay.com%252Fitm%252Flike%252F261500197495%253Flpid%253D82%26adtype%3Dpla;152
 
domain_shopping_shopping
Price: 60 API units per line Historical Price: 300 API units per line

This report lists domains a queried domain is competing against in Google's paid search results with product listing ads.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*domain_shopping_shoppingA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
domain*example.comA unique name of a website you’d like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "ie" (google.ie), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "at" (google.at), "cl" (google.cl), "co" (google.co), "cz" (google.cz), "id" (google.id), "my" (google.my), "nz" (google.nz), "ph" (google.ph), "pt" (google.pt), "za" (google.za), "ae" (google.ae) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Dn,Cr,Np,Sh,Ad,At,Ac,Or Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort np_asc, np_desc, cr_asc, cr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.

Request example

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

Response example

Domain;Competitor Relevance;Common Keywords;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords google.com;4.09;116517;533391;4232822;7339817;3978600 walmart.com;1.63;42806;1719403;9612774;8403807;2280696 target.com;0.88;20039;1896520;4233539;3611890;969940 rakuten.com;1.11;18893;3089;12381;7801;29742 channelintelligence.com;0.68;17030;0;0;0;4 aliexpress.com;0.83;14704;33788;88658;23750;1109188 bestbuy.com;0.57;11929;246424;2258613;1828421;825689 newegg.com;0.64;10843;11659;89918;31316;475346 bhphotovideo.com;0.57;10036;77416;87332;68709;239031 bonanza.com;0.54;8864;1840;4408;11363;19277
Keyword Reports
Price: 10 API units per line

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_allA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database; if this parameter is not specified, your request will be sent to all regional databases.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Db, Ph, Nq, Cp, Co Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.

Request example

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

Response example

Database;Phrase;Search Volume;CPC;Competition
us;search engine optimization;22200;19.37;0.96
Price: 10 API units per line Historical Price: 50 API units per line

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_thisA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Nq, Cp, Co, Nr Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_organicA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Ur Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

This report lists domains that are ranking in Google's paid search results with a requested keyword.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_adwordsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Dn, Ur Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_relatedA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Nq, Cp, Co, Nr, Td Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, Nq, Cp, Co, Nr Filters for columns.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_adwords_historicalA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Dn, Dt, Po, Ur, Tt, Ds, Vu, At, Ac, Ad Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_fullsearchA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phraseA keyword or keyword expression you'd like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
export_columns Ph, Nq, Cp, Co, Nr, Td Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_filter Ph, Nq, Cp, Co, Nr Filters for columns.

Request example

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

Response example

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

This report provides keyword difficulty, an index that helps to estimate how difficult it would be to seize competitors' positions in organic search within the Google's top 20 with an indicated search term.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*phrase_kdiA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
phrase*phrasePhrase (from 1 to 100 keywords separated by semicolons)
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_columns Ph, Kd Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.

Request example

http://api.semrush.com/?type=phrase_kdi&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Ph,Kd&phrase=ebay;seo&database=us

Response example

Keyword;Keyword Difficulty Index ebay;95.10 seo;78.35
URL Reports
Price: 10 API units per line Historical Price: 50 API units per line

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

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*url_organicA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
url*http://example.com/The URL of a landing page you'd like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

This report lists keywords that bring users to a URL via Google's paid search results.

Endpoint

http://api.semrush.com/

Request parameters

NameValueDescription
type*url_adwordsA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
url*http://example.com/The URL of a landing page you'd like to investigate.
database* "us" (google.com), "uk" (google.co.uk), "ca" (google.ca), "ru" (google.ru), "de" (google.de), "fr" (google.fr), "es" (google.es), "it" (google.it), "br" (google.com.br), "au" (google.com.au), "bing-us" (bing.com), "ar" (google.com.ar), "be" (google.be), "ch" (google.ch), "dk" (google.dk), "fi" (google.fi), "hk" (google.com.hk), "ie" (google.ie), "il" (google.co.il), "mx" (google.com.mx), "nl" (google.nl), "no" (google.no), "pl" (google.pl), "se" (google.se), "sg" (google.com.sg), "tr" (google.com.tr), "mobile-us" (google.com), "jp" (google.co.jp), "in" (google.co.in), "hu" (google.hu), "af" (google.af), "al" (google.al), "dz" (google.dz), "ao" (google.ao), "am" (google.am), "at" (google.at), "az" (google.az), "bh" (google.bh), "bd" (google.bd), "by" (google.by), "bz" (google.bz), "bo" (google.bo), "ba" (google.ba), "bw" (google.bw), "bn" (google.bn), "bg" (google.bg), "cv" (google.cv), "kh" (google.kh), "cm" (google.cm), "cl" (google.cl), "co" (google.co), "cr" (google.cr), "hr" (google.hr), "cy" (google.cy), "cz" (google.cz), "cd" (google.cd), "do" (google.do), "ec" (google.ec), "eg" (google.eg), "sv" (google.sv), "ee" (google.ee), "et" (google.et), "ge" (google.ge), "gh" (google.gh), "gr" (google.gr), "gt" (google.gt), "gy" (google.gy), "ht" (google.ht), "hn" (google.hn), "is" (google.is), "id" (google.id), "jm" (google.jm), "jo" (google.jo), "kz" (google.kz), "kw" (google.kw), "lv" (google.lv), "lb" (google.lb), "lt" (google.lt), "lu" (google.lu), "mg" (google.mg), "my" (google.my), "mt" (google.mt), "mu" (google.mu), "md" (google.md), "mn" (google.mn), "me" (google.me), "ma" (google.ma), "mz" (google.mz), "na" (google.na), "np" (google.np), "nz" (google.nz), "ni" (google.ni), "ng" (google.ng), "om" (google.om), "py" (google.py), "pe" (google.pe), "ph" (google.ph), "pt" (google.pt), "ro" (google.ro), "sa" (google.sa), "sn" (google.sn), "rs" (google.rs), "sk" (google.sk), "si" (google.si), "za" (google.za), "kr" (google.kr), "lk" (google.lk), "th" (google.th), "bs" (google.bs), "tt" (google.tt), "tn" (google.tn), "ua" (google.ua), "ae" (google.ae), "uy" (google.uy), "ve" (google.ve), "vn" (google.vn), "zm" (google.zm), "zw" (google.zw), "ly" (google.ly), "mobile-uk" (google.com), "mobile-ca" (google.ca), "mobile-de" (google.de), "mobile-fr" (google.fr), "mobile-es" (google.es), "mobile-it" (google.it), "mobile-br" (google.com.br), "mobile-au" (google.com.au), "mobile-dk" (google.dk), "mobile-mx" (google.com.mx), "mobile-nl" (google.nl), "mobile-se" (google.se), "mobile-tr" (google.com.tr), "mobile-in" (google.co.in), "mobile-id" (google.co.id), "mobile-il" (google.co.il) A regional database (one value from the list).
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_escape1If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode1 or 0If this parameter uses the value "0", the response will be sent as a URL-encoded string; if "1", the response will not be converted.
display_date date in format "YYYYMM15" A date on which a report will be shown. You can roll back to the past or choose an actual date. By indicating a date in the past, you can build reports by using historical data that are available for 11 databases** dating back to January 2012 and for 15 new regional databases*** containing data gathered after December 2013.
export_columns Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td, Tt, Ds Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
Fields marked by an asterisk (*) are required
** The United States (Google and Bing), the United Kingdom, Canada, Australia, France, Italy, Germany, Spain, Russia, Brazil.
*** Belgium, the Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong (China), and Singapore.

Request example

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

Response example

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

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

Endpoint

http://api.semrush.com/analytics/da/v2/

Request parameters

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

Request example

http://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=urbandictionary.com&type=publisher_text_ads

Response example

title;text;first_seen;last_seen;times_seen;visible_url Diabetes II Insulin;Get Complete Info on Diabetes Medication And Treatments.;1467072000000;1471478400000;985369;everydayhealth.com/Insulin FICA;Federally Insured Cash Account Official Site of the FICA Account;1460073600000;1468627200000;693521;ficaaccount.com 米国暮らしでも映画は無理;アメリカに住んでるだけじゃ映画の 英語は聞き取れません。なぜ?;1461801600000;1468627200000;664230;mogomogobuster.com Free Downloadable Videos;Download The Most Viewed End Time Bible Prophecy Videos Online Today!;1459900800000;1467936000000;528229;worldslastchance.com Learn English Online Free »;How to learn english fast and easy? Learn english grammar online free!;1459900800000;1462406400000;463272;learn-english-online.us Type 2 Diabetes Recipes;Sign Up for Weight Loss Tips & More Try our Customized Meal Planner Now;1466985600000;1468022400000;432721;everydayhealth.com/Type-2-Diabetes Download a Book Free »;Download Allatra - worth reading Most extraordinary book of century;1466467200000;1468540800000;432453;allatra-book.org/Download_Free Insulin Dependent;Learn About the Causes, Symptoms And Treatment of Type 2 Diabetes.;1467072000000;1468627200000;409819;everydayhealth.com/Insulin Parmesan Meatball Sliders;Get Cooking With Hunt's - Make This Delicious Baked Dish Tonight!;1459900800000;1468281600000;363474;hunts.com BANKSY MINI WALL MURAL;Banksy Mural on Concrete Texture 12x12x3, for Wall or Table Top;1466121600000;1468627200000;314699;designproject.net
 
publisher_advertisers
Price: 50 API units per line

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

Endpoint

http://api.semrush.com/analytics/da/v2/

Request parameters

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

Request example

http://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=urbandictionary.com&type=publisher_advertisers

Response example

domain;ads_count;first_seen;last_seen;times_seen stylewe.com;3243;1459900800000;1471046400000;13912898 arabmatchmaking.com;13788;1459900800000;1468627200000;10674727 facebook.com;145903;1369440000000;1468627200000;9581288 truthfinder.com;136;1461801600000;1468627200000;4455000 everydayhealth.com;699;1459900800000;1471478400000;2932806 instantcheckmate.com;49;1396137600000;1468627200000;2790630 bestbackground-1191.appspot.com;125;1459987200000;1468540800000;2479866 muslims4marriage.com;53663;1459900800000;1468627200000;1473834 mogomogobuster.com;20;1461801600000;1468627200000;1240533 newlife24h.com;6;1461456000000;1468540800000;1121633
 
advertiser_publishers
Price: 100 API units per line

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

Endpoint

http://api.semrush.com/analytics/da/v2/

Request parameters

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

Request example

http://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=wayfair.com&type=advertiser_publishers

Response example

domain;ads_count;first_seen;last_seen;times_seen thisnext.com;10837;1388880000000;1471910400000;888747 antiquesnavigator.com;7410;1439424000000;1471910400000;518508 antiques.com;7945;1459900800000;1471910400000;364953 cotedetexas.blogspot.com;10980;1401235200000;1471910400000;212340 toynewsi.com;1449;1459900800000;1471910400000;176293 epicsports.com;3762;1461628800000;1471910400000;168701 lampsusa.com;1174;1459900800000;1465862400000;149453 blueridgenow.com;5130;1459900800000;1471910400000;137279 christmas.com;5293;1459900800000;1471824000000;122658 aquasupercenter.com;5045;1459900800000;1471910400000;121911
 
advertiser_text_ads
Price: 100 API units per line

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

Endpoint

http://api.semrush.com/analytics/da/v2/

Request parameters

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

Request example

http://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&type=advertiser_text_ads

Response example

title;text;first_seen;last_seen;times_seen;visible_url Dakota Digital Products »;Free shipping on U.S. orders $150+ Digital Dash/Gauges, Cruise Control;1461801600000;1471910400000;76233;stores.ebay.com/Phoenix-Tuning Star Wars Vintage Figures »;Huge selection of Vintage 1977-1985 Star Wars Figures,Vehicles,Playsets;1462320000000;1471910400000;44121;solossmugglersshop.com Gfo $17/Lb Free Shipping »;Prevent Algae In Aquariums Lowest Prices On Gfo Anywhere;1459900800000;1469923200000;42029;ebay.com PlatinumPool online store;Best online swimming pool store Lowest prices and free shipping;1466726400000;1470441600000;22003;stores.ebay.com Strip Curtains $99/roll »;Phthalate Free Clear PVC Save Energy & Money;1459900800000;1469923200000;19863;ebay.com Great Furniture »;Home Goods Furniture;1461801600000;1471910400000;13936;stores.ebay.com/doordirect/ Kathymac Jewelry »;Indian Jewelry,Silver Turquoise Pendants, Earrings, Fashion Jewelry;1465948800000;1471910400000;11956;stores.ebay.com/Kathymac-Jewelry Kia & Hyundai OEM Parts »;Low cost Original Equipment Parts Free shipping;1459900800000;1470009600000;8093;ebay.com/usr/phd_auto_parts Ducati Used Parts;European and American Sportbike Used Parts and Accessories;1459900800000;1471305600000;7828;stores.ebay.com/imperialsportbikes ACECLUB - eBay Stores;Welceom to ACECLUB. We carries auto parts, Mobil1 oil, LED strips etc.;1461801600000;1468972800000;7234;stores.ebay.com/aceclub
 
advertiser_landings
Price: 100 API units per line

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

Endpoint

http://api.semrush.com/analytics/da/v2/

Request parameters

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

Request example

http://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&type=advertiser_landings

Response example

target_url;first_seen;last_seen;times_seen;ads_count http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=profootballtalk.nbcsports.com&image=27571844;1465948800000;1471910400000;101584;1 http://www.wayfair.com/gateway.php?refid=GX56855779276.lampsusa.com~&position=none&network=d&pcrid=56855779276&device=c&placement=lampsusa.com;1459900800000;1465862400000;53535;1 http://www.wayfair.com/gateway.php?refid=GX49222149933.www.antiques.com~&position=none&network=d&pcrid=49222149933&device=t&placement=www.antiques.com;1459900800000;1471910400000;52003;1 http://www.wayfair.com/gateway.php?refid=GX56855779276.lampsusa.com~&position=none&network=d&pcrid=56855779276&device=t&placement=lampsusa.com;1459900800000;1465862400000;51424;1 http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=82baac0daefc2cb2.anonymous.google&image=27571844;1462406400000;1471910400000;43596;1 http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=bronxbaseballdaily.com&image=27571844;1462320000000;1471910400000;41458;1 http://www.wayfair.com/gateway.php?refid=GX62899178682.www.antiquesnavigator.com~&position=none&network=d&pcrid=62899178682&device=t&placement=www.antiquesnavigator.com&image=14557927;1459987200000;1471824000000;33808;1 http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=gotitans.com&image=27571844;1462320000000;1471910400000;32005;1 http://www.wayfair.com/gateway.php?refid=GX87595254316.Fixtures~&position=none&network=d&pcrid=87595254316&device=t&placement=www.celticslife.com&image=27571844;1468281600000;1471910400000;31344;1 http://www.wayfair.com/gateway.php?refid=GX60014892162.www.antiquesnavigator.com~&position=none&network=d&pcrid=60014892162&device=t&placement=www.antiquesnavigator.com&image=14982740;1460073600000;1471824000000;28714;1
 
advertiser_publisher_text_ads
Price: 100 API units per line

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

Endpoint

http://api.semrush.com/analytics/da/v2/

Request parameters

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

Request example

http://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&advertiser_domain=ebay.com&publisher_domain=urbandictionary.com&type=advertiser_publisher_text_ads

Response example

title;text;first_seen;last_seen;times_seen;visible_url Strip Curtains $99/roll »;Phthalate Free Clear PVC Save Energy & Money;1460160000000;1468627200000;415;ebay.com Kathymac Jewelry;Indian Jewelry,Silver Turquoise Pendants, Earrings, Fashion Jewelry;1466035200000;1468540800000;265;stores.ebay.com/Kathymac-Jewelry PlatinumPool online store »;Best online swimming pool store Lowest prices and free shipping;1467331200000;1468627200000;234;stores.ebay.com Discount Diamond Grind;Diamond Grind and ERGO Killer Prices and Free ship;1461801600000;1468627200000;211;grinderpalace.com Memories from the past;Memorablia from the 60s til today musicians boys bands, actors, teens;1461888000000;1467244800000;161;stores.ebay.com/teen-idol-heaven Muhammad Ali G.O.A.T.;Honor the Greatest of All Time! American Apparel G.O.A.T T-Shirt;1465948800000;1466726400000;157;ebay.com Car Headlight Fog Upgrade;Specialize Automotive Lighting Lamp Quality Brand item Replacement Bulb;1465948800000;1468627200000;115;stores.ebay.com/formulaj87/ Rev. Tye's Coin Stache »;Are you nikel-ish? Tons of certified buffalo nickels;1461801600000;1468195200000;88;stores.ebay.com/RevTyes-Coin-Stache Marine Emblem Bullet Pen;Made in USA by a Veteran. Well made with the Corps in mind.;1468195200000;1468540800000;74;ebay.com/itm/like/172037229785 RPG Books Great Price;Low Prices on New RPG Books From Mongoose & StarFleet;1461974400000;1467936000000;69;ebay.com
 
advertiser_rank
Price: 10 API units per line

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

Endpoint

http://api.semrush.com/analytics/da/v2/

Request parameters

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

Request example

http://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=ebay.com&type=advertiser_rank

Response example

domain;ads_overall;text_ads_overall;media_ads_overall;first_seen;last_seen;times_seen;domain_overall ebay.com;2932;2658;274;1364342400000;1471910400000;848588;37213
 
publisher_rank
Price: 10 API units per line

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

Endpoint

http://api.semrush.com/analytics/da/v2/

Request parameters

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

Request example

http://api.semrush.com/analytics/da/v2/?action=report&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&domain=urbandictionary.com&type=publisher_rank

Response example

domain;ads_overall;text_ads_overall;media_ads_overall;first_seen;last_seen;times_seen;domain_overall urbandictionary.com;1916819;1687303;229516;1368921600000;1471910400000;78970987;64985
Columns
Descriptions of reports' columns:
Value Description
Ab The place on a SERP where an ad appeared (top, side, or bottom blocks).
Ac Estimated budget spent buying keywords in Google AdWords for ads that appear in paid search results (monthly estimation).
Ad Keywords a website is buying in Google AdWords for ads that appear in paid search results.
Am Changes in the number of paid keywords.
At Traffic brought to the website via paid search results.
Bm Changes in paid traffic.
Cm Changes in paid traffic price.
Co Competitive density of advertisers using the given term for their ads. One (1) means the highest competition.
Cp Average price in US dollars advertisers pay for a user's click on an ad containing a particular keyword (Google AdWords).
Cr Competition level based on the total number of keywords of each domain and the number of keywords the domains have in common.
Cv Keyword coverage represents the percentage of ads displayed for a particular keyword in the last 12 months (100% = 12 months).
Db Regional database (US, UK, Italy, etc.)
Dn A website's position for a particular keyword in Google's top 20 organic search results.
Ds Ad text.
Dt Actual date.
Hs This columns shows whether or not a report's line returns historical data.
Ip IP address.
Lc Number of API units per line.
Li Number of lines requested for a report by a particular user.
Np Common keywords that domains are ranking for in Google's top 20 organic search results.
Nq The average number of times users have searched for a given keyword per month. We calculate this value over the last 12 months.
Nr The total number of organic results returned for a given keyword at the last date of collection.
Oc Estimated price of organic keywords in Google AdWords.
Of Value of a parameter display_offset requested by a particular user.
Om Changes in the number of organic keywords.
Or Keywords that bring users to a website via Google's top 20 organic search results.
Ot Traffic brought to a website via Google's top 20 organic search results.
P0 A position of the first queried domain for a particular keyword in Google's top 20 organic or paid search results.
P1 A position of the second queried domain for a particular keyword in Google's top 20 organic or paid search results.
P2 A position of the third queried domain for a particular keyword in Google's top 20 organic or paid search results.
P3 A position of the fourth queried domain for a particular keyword in Google's top 20 organic or paid search results.
P4 A position of the fifth queried domain for a particular keyword in Google's top 20 organic or paid search results.
Pc Number of keywords.
Pd The difference between the previous position a domain was earning with a particular keyword and its current position.
Ph Keyword bringing users to the website via Google's top 20 organic search results.
Po position a URL gets with a particular keyword in Google's top 20 organic or paid search results.
Pp A position a domain gets with a particular keyword in Google's top 20 organic or paid search results.
Pr Price of promoted product
Rh The SEMrush rating of the website's popularity based on organic traffic coming from Google's top 20 organic search results.
Rk The SEMrush rating of the website's popularity based on organic traffic coming from Google's top 20 organic search results.
Rt Report type.
Sh Number of keywords the website is using for product listing ads.
Sn Shop name
Sv Number of unique product listing ads (PLA Copies)
Tc The total amount spent on keywords in Google AdWords for which the domain is ranking in search results.
Td The interest of searchers in a particular keyword during the last 12 months. This metric is based on changes in the number of queries per month.
Tm Changes in organic traffic.
Tr The share of traffic driven to the website with a particular keyword for a specified period.
Ts UNIX Timestamp.
Tt Ad title.
Um Changes in organic traffic cost.
Ur The URL of the target page (Backlinks).
Vu Visible URL.
ads_count The total number of all types of display ads (media and text) during a specified period.
ads_overall The total number of all types of display ads (media and text) for all time.
advertisers_count The total number of advertisers on Google’s Display Network where a publisher promoted a website in the last 7 days.
advertisers_overall The total number of advertisers on Google’s Display Network where a publisher promoted a website.
anchor A clickable text of a backlink.
avg_positions An average position of an ad.
domain Domain name.
domain_overall The total number of advertisers on Google’s Display Network where a publisher promoted a website, or the total number of publishers’ websites where the display ads of an advertiser's website appeared during a whole period.
external_num The number of the source page’s links that point to other websites’ pages.
first_seen The timestamp on which SEMrush first noticed a backlink.
image_alt A URL of an image backlink's location.
internal_num The number of the source page’s links that point to webpages of the same website.
last_seen The timestamp on which SEMrush last noticed a backlink.
media_ads_count The total number of media display ads of an advertiser SEMrush has noticed during a specified period.
media_ads_overall The total number of an advertiser’s media display ads SEMrush has noticed for a whole period.
media_type The display ad’s type of media.
publishers_count The total number of publishers’ websites where display ads of an advertiser's website appeared in the last 7 days.
publishers_overall The total number of publishers’ websites where the display ads of an advertiser's website appeared during a whole period.
redirect_url The last URL in a redirect chain.
response_code Server response code.
source_title The title of the source page.
source_size The source page‘s size in bytes.
source_url The URL of the source page.
target_title The title of the target page.
target_url The URL of the target page (Backlinks).
target_url The landing page of a display ad (Display Advertising).
text The text of a display ad.
text_ads_count The total number of display ads during a specified period.
text_ads_overall The total number of display ads SEMrush noticed for a whole period.
times_seen The number of times SEMrush saw a display ad.
title The title of a display ad.
type Backlink type (follow, nofollow, image, form, text).
visible_url A visible URL of a display ad.
score This metric measures the importance of a domain using a 100-point scale (from 0 to 100) and is based on the quality and volume of links pointing to this domain. The higher the score, the higher the quality of the domain. Domain Score is calculated in the same way as Google's PageRank
trust_score This metric measures the trustworthiness of a particular domain using a 100-point scale (with ‘0’ indicating a low-trust site and ‘100’ indicating a highly trusted site) and is based on the number of backlinks from trusted sites pointing to the domain. If a site’s Trust Score is significantly lower than its Domain Score, this may be a sign that the latter was artificially inflated. Backlinks from such sites may trigger Google penalties.
neighbour A domain with a similar backlink profile to the analyzed domain.
similarity This metric is calculated based on the number of referring domains to each competitor and the total number of common referring domains to all competitors. If websites have a large number of common referring domains, they can be considered competitors.
common_refdomains The number of referring domains that link back to both the analyzed and competing domains.
domains_num The total number of domains, including common referring domains, linking to a given domain.
backlinks_num The number of backlinks to a given domain.
  • Column names can't be changed.
  • The order of columns can be changed.
  • The number of columns can be increased.
  • SEMrush will only remove old columns after notifying users.
Sortings
Description of sortings:
Value Description
am_ascsorting by changes in paid keywords in ascending order (Am)
am_descsorting by changes in paid keywords in descending order (Am)
bm_ascsorting by changes in paid traffic in ascending order (Bm)
bm_descsorting by changes in paid traffic in descending order (Bm)
cm_ascsorting by changes in ads traffic price in ascending order (Cm)
cm_descsorting by changes in ads traffic price in descending order (Cm)
co_ascsorting by competition in ascending order (Co)
co_descsorting by competition in descending order (Co)
cp_ascsorting by CPC in ascending order (Cp)
cp_descsorting by CPC in descending order (Cp)
cr_ascsorting by competition level in ascending order (Cr)
cr_descsorting by competition level in descending order (Cr)
cv_ascsorting by coverage in ascending order (Cv)
cv_descsorting by coverage in descending order (Cv)
dt_ascsorting by the date of the last update in ascending order (Ts)
dt_descsorting by the date of the last update in descending order (Ts)
np_ascsorting by common keywords in ascending order (Np)
np_descsorting by common keywords in descending order (Np)
nq_ascsorting by volume in ascending order (Nq)
nq_descsorting by volume in descending order (Nq)
nr_ascsorting by the number of results in ascending order (Nr)
nr_descsorting by the number of results in descending order (Nr)
om_ascsorting by changes in organic keywords in ascending order (Om)
om_descsorting by changes in organic keywords in descending order (Om)
p0_ascsorting by a position of the 1st domain in ascending order (P0)
p0_descsorting by a position of the 1st domain in descending order (P0)
p1_ascsorting by a position of the 2nd domain in ascending order (P1)
p1_descsorting by a position of the 2nd domain in descending order (P1)
p2_ascsorting by a position of the 3rd domain in ascending order (P2)
p2_descsorting by a position of the 3rd domain in descending order (P2)
p3_ascsorting by a position of the 4th domain in ascending order (P3)
p3_descsorting by a position of the 4th domain in descending order (P3)
p4_ascsorting by a position of the 5th domain in ascending order (P4)
p4_descsorting by a position of the 5th domain in descending order (P4)
po_ascsorting by a position in ascending order (Po)
po_descsorting by a position in descending order (Po)
tc_ascsorting by traffic cost in ascending order (Tc)
tc_descsorting by traffic cost in descending order (Tc)
tm_ascsorting by changes in organic traffic in ascending order (Tm)
tm_descsorting by changes in organic traffic in descending order (Tm)
tr_ascsorting by traffic in ascending order (Tr)
tr_descsorting by traffic in descending order (Tr)
um_ascsorting by changes in organic traffic price in ascending order (Um)
um_descsorting by changes in organic traffic price in descending order (Um)
last_seen_ascsorting by the last-seen date in ascending order (last_seen)
last_seen_descsorting by the last-seen date in descending order (last_seen)
first_seen_ascsorting by the first-seen date in ascending order (first_seen)
first_seen_descsorting by the first-seen date in descending order (first_seen)
times_seen_ascsorting by the number of times seen in ascending order (times_seen)
times_seen_descsorting by the number of times seen in descending order (times_seen)
ads_count_ascsorting by the number of display ads in ascending order (ads_count)
ads_count_descsorting by the number of display ads in descending order (ads_count)
Filters
To apply a filter to a report, you must add a parameter "display_filter" with a URL-encoded string that contains filters separated by "|" (maximum number: 25).
Please be aware that some ready-to-use functions might code the 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, ad, title, text, url
  • Metrical fields
  • Textual fields
  • Fields with fixed values
<operation> - possible operations: Eq, Gt, Lt, Bw, Ew, Co, Wm
  • For metrical fields
  • For textual fields
  • For fields with fixed values
<value> - value to filter
Error messages
Descriptions of error messages:
Value Description
ERROR 50 :: NOTHING FOUND We haven't found any information related to your request.
ERROR 40 :: MANDATORY PARAMETER action NOT SET OR EMPTY The required parameter action is missing or has been mistyped. Please add it to your request, or check the spelling.
ERROR 41 :: MANDATORY PARAMETER type NOT SET OR EMPTY The required parameter type is missing or has been mistyped. Please add it to your request, or check the spelling.
ERROR 42 :: MANDATORY PARAMETER domain NOT SET OR EMPTY The required parameter domain is missing, or its value is not set. Please add it to your request, or set its value.
ERROR 43 :: MANDATORY PARAMETER phrase NOT SET OR EMPTY The required parameter phrase is missing, or its value is not set. Please add it to your request, or set its value.
ERROR 44 :: MANDATORY PARAMETER url NOT SET OR EMPTY The required parameter url is missing, or its value is not set. Please add it to your request, or set its value.
ERROR 46 :: MANDATORY PARAMETER database NOT SET OR EMPTY The required parameter database is missing, or its value is not set. Please add it to your request, or set its value.
ERROR 120 :: WRONG KEY - ID PAIR You tried to use an unknown API key. Please go to your profile to find your correct API key.
ERROR 130 :: API DISABLED Your subscription doesn't allow you to use API.
ERROR 131 :: LIMIT EXCEEDED The API request limit for the requested report has been reached. (Valid for users of old API plans.)
ERROR 132 :: API UNITS BALANCE IS ZERO The API request limit has been reached. To continue using API, recharge your balance, or upgrade your subscription.
ERROR 133 :: DB ACCESS DENIED You are not allowed to access the requested database.
ERROR 134 :: TOTAL LIMIT EXCEEDED The API request limit has been reached. (Valid for users of old API plans.)
ERROR 135 :: API REPORT TYPE DISABLED You are not allowed to access the requested report.
Have a Suggestion?