SEMrush.com -> API

Want to use our API?

We have a special subscription designed for those users who require extensive use of SEMrush API. This plan includes 300,000 API units.

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

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

Summary reports

Main report

domain_rank

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

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	domain_rank	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Dn, Rk, Or, Ot, Oc, On, Ol, Oe, Oi, Ad, At, Ac, An, Al, Ae, Ai	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost seobook.com;9158;8139;70745;411708;0;0;0

Summary values history

domain_rank_history

Price 10 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)

Request example

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

Request parameters

Name	Value	Description
type*	domain_rank_history	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Rk, Or, Ot, Oc, On, Ol, Oe, Oi, Ad, At, Ac, An, Al, Ae, Ai, Dt	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Difference report

rank_difference

Price 20 API units per line Historical Price 100 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

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

Response example

Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Organic Keywords Difference;Organic Traffic Difference;Organic Cost Difference;Adwords Keywords Difference;Adwords Traffic Difference;Adwords Cost Difference facebook.com;2;8328083;306965011;659681812;24498;101658;115411;356553;-53917144;-203683568;-13769;-62533;-140201 wikipedia.org;1;18110580;850114195;1060747503;132;764;492;280102;15948255;48066305;4;-37;-599 pinterest.com;34;2017864;19157937;15409297;137;417;317;202800;1914056;-1421976;-20;-2260;-187 amazon.com;7;12275347;122235239;105835754;4980133;10697932;7573015;198323;-2130528;-145943;-2365239;-6480593;-5721300 digsitevalue.net;520;178049;1455731;1477317;0;0;0;178049;1455731;1477317;0;0;0

SEMrush rank

rank

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

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

http://us.backend.semrush.com/?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&action=report&type=rank&display_sort=om_desc&display_limit=10&export=api

Request parameters

Name	Value	Description
type*	rank	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
export*	api
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Dn, Rk, Or, Ot, Oc, Ad, At, Ac	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Reports for domain

Organic Keywords report

domain_organic

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

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	domain_organic	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr, Td	required fields separated by commas; if parameter is not specified default columns will be sent
display_sort	tr_asc, tr_desc, po_asc, po_desc, tc_asc or tc_desc
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted
display_positions	new, lost, rise or fall	new - show keywords which appeared in current month lost - show keywords which disappeared in current month rise - show keywords which improved their positions in current month fall - show keywords which declined their positions in current month
display_filter		filter for columns Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr, Td

Response example

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

AdWords keywords report

domain_adwords

Price 20 API units per line Historical Price 100 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	domain_adwords	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Ph, Po, Pp, Pd, Nq, Cp, Vu, Tr, Tc, Co, Nr, Td, Ur, Tt, Ds, Vu, Ur	required fields separated by commas; if parameter is not specified default columns will be sent
display_sort	tr_asc, tr_desc, po_asc, po_desc, tc_asc or tc_desc
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted
display_positions	new, lost, rise or fall	new - show keywords which appeared in current month lost - show keywords which disappeared in current month rise - show keywords which improved their positions in current month fall - show keywords which declined their positions in current month
display_filter		filter for columns Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr, Td

Response example

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

Competitors in organic search report

domain_organic_organic

Price 40 API units per line Historical Price 200 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	domain_organic_organic	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Dn, Cr, Np, Or, Ot, Oc, Ad	required fields separated by commas; if parameter is not specified default columns will be sent
display_sort	np_desc or cr_desc
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Competitors in AdWords search report

domain_adwords_adwords

Price 40 API units per line Historical Price 200 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	domain_adwords_adwords	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Dn, Cr, Np, Ad, At, Ac, Or	required fields separated by commas; if parameter is not specified default columns will be sent
display_sort	np_desc or cr_desc
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Potential ad/traffic buyers report

domain_organic_adwords

Price 40 API units per line Historical Price 200 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

http://us.api.semrush.com/?action=report&type=domain_organic_adwords&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Dn,Np,Ad,At,Ac,Or&domain=ebay.com

Request parameters

Name	Value	Description
type*	domain_organic_adwords	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Dn, Np, Ad, At, Ac, Or	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Potential ad/traffic sellers report

domain_adwords_organic

Price 40 API units per line Historical Price 200 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

http://us.api.semrush.com/?action=report&type=domain_adwords_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=10&export=api&export_columns=Dn,Np,Or,Ot,Oc,Ad&domain=ebay.com

Request parameters

Name	Value	Description
type*	domain_adwords_organic	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Dn, Np, Or, Ot, Oc, Ad	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Ads history for domain

domain_adwords_historical

Price 100 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)

Request example

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

Request parameters

Name	Value	Description
type*	domain_adwords_historical	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Ph, Dt, Po, Cp, Nq, Tr, Ur, Tt, Ds, Vu	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Comparison of domains

domain_domains

Price 80 API units per line Historical Price 400 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	domain_domains	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domains*	string	urlencoded string which contains domains in specified format separated by "\|". Domain consists of <sign>\|<type>\|<domain>, where <sign> - possible operations: "+", "-", "*", "/" <type> - "or" for organic or "ad" for adwords <domain> - domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Ph, P0, P1, P2, P3, P4, Nr, Cp, Nq	required fields separated by commas; if parameter is not specified default columns will be sent
display_sort	p0_asc, p0_desc, p1_asc, p1_desc, p2_asc, p2_desc, p3_asc, p3_desc, p4_asc, p4_desc, nq_asc, nq_desc, co_asc, co_desc, cp_asc, cp_desc, nr_asc, or nr_desc
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted
display_filter		filter for columns Ph, P0, P1, P2, P3, P4, Nq, Cp, Co, Nr

Response example

Keyword;Positions;Number of Results;CPC;Average vol. youtube;0,1;6760000000;0.16;83100000 chase;18,0;319000000;2.00;7480000 face;8,0;2130000000;0.10;6120000 imdb;1,0;291000000;0.70;3350000 tmz;8,0;33200000;0.10;3350000 firefox;12,0;568000000;0.32;2240000 nick;20,0;733000000;0.57;2240000 letmewatchthis;11,0;4670000;0.10;1830000 fandango;6,0;21200000;0.63;1830000 abc;17,0;738000000;0.62;1830000

Reports for keywords

Main keyword report

phrase_this

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

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

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

Response example

Keyword;Search Volume;CPC;Competition;Number of Results search engine optimization;33100;17.41;0.92;111000000

Organic results

phrase_organic

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

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	phrase_organic	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
phrase*	phrase	phrase
export*	api
display_limit	integer	number of results returned
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Dn, Ur	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

Domain;Url wikipedia.org;http://en.wikipedia.org/wiki/Search_engine_optimization seomoz.org;http://www.seomoz.org/beginners-guide-to-seo searchengineland.com;http://searchengineland.com/guide/what-is-seo google.com;http://support.google.com/webmasters/bin/answer.py%3Fhl%3Den%26answer%3D35291 seo.com;http://www.seo.com/ mashable.com;http://mashable.com/category/seo/ seo-usa.org;http://www.seo-usa.org/ seobook.com;http://tools.seobook.com/ wisdek-seo.com;http://www.wisdek-seo.com/ searchenginewatch.com;http://searchenginewatch.com/seo

Related keyword report

phrase_related

Price 40 API units per line Historical Price 200 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	phrase_related	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	example.com	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Ph, Nq, Cp, Co, Nr, Td	required fields separated by commas; if parameter is not specified default columns will be sent
display_sort	nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc or nr_desc
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted
display_filter		filter for columns Ph, Nq, Cp, Co, Nr

Response example

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

Ads history for keyword

phrase_adwords_historical

Price 100 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)

Request example

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

Request parameters

Name	Value	Description
type*	phrase_adwords_historical	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
phrase*	phrase	phrase
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Dn, Dt, Po, Rh, Ur, Tt, Ds, Vu	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Phrase match report

phrase_fullsearch

Price 20 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)

Request example

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

Request parameters

Name	Value	Description
type*	phrase_fullsearch	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
phrase*	phrase	phrase
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Ph, Nq, Cp, Co, Nr, Td	required fields separated by commas; if parameter is not specified default columns will be sent
display_sort	nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc or nr_desc
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted
display_filter		filter for columns Ph, Nq, Cp, Co, Nr

Response example

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

Reports for URL

Organic URL report

url_organic

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

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	url_organic	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	http://example.com/	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

AdWords URL report

url_adwords

Price 20 API units per line Historical Price 100 API units per line

Requested URL

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

Name	Value	Description
DB*	"us" (Google.com), "uk" (Google.co.uk), "ca" (Google.ca), "ru" (Google.ru), "de" (Google.de), "fr" (Google.fr), "es" (Google.es), "it" (Google.it), "br" (Google.com.br), "au" (Google.com.au) or "us.bing" (Bing.com)	requested database (one value from the list)
DATE	date in format "YYYYMM15"	allow to request reports for past periods

Request example

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

Request parameters

Name	Value	Description
type*	url_adwords	type of the request
key*	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX	user identification key - available through your profile on the site
domain*	http://example.com/	domain
export*	api
display_limit	integer	number of results returned
display_offset	integer	instructs to skip a specified number of results before beginning to return results to you
export_escape	1	value "1" means that columns will be wrapped in double quotes
export_columns	Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td, Tt, Ds	required fields separated by commas; if parameter is not specified default columns will be sent
export_decode	1 or 0	0 means that response will be given as urlencoded string 1 means that response will not be converted

Response example

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

Columns

Description of columns from response:

Ac - Estimated expenses the site has for advertising in Ads (per month)

Ad - Keywords this site has in the TOP20 Ads results

Am - Number of adwords keywords changes

At - Estimated number of visitors coming from Ads (per month)

Bm - Adwords traffic changes

Cm - Adwords traffic price changes

Co - Competition of advertisers for that term (the higher the number - the greater the competition)

Cp - Average price of a click on an Ad for this search query (in U.S. dollars)

Cr - Competition level based on keywords

Dn - A site name.

Ds - Ad text

Dt - Actual date

Np - The number of keywords for which the site is displayed in search results in common with the analyzed site

Nq - Exact number of queries for the keyword per month (for the corresponding local version of search engine)

Nr - The number of search results - how many results does the search engine return for this query

Oc - Estimated cost of purchasing the same number of visitors through Ads

Om - Number of organic keywords changes

Or - Keywords this site has in the TOP20 organic results

Ot - Estimated number of visitors coming from the first 20 search results (per month)

P0 - The position of fisrt domain for this keyword in organic or Ads results

P1 - The position of second domain for this keyword in organic or Ads results

P2 - The position of third domain for this keyword in organic or Ads results

P3 - The position of fourth domain for this keyword in organic or Ads results

P4 - The position of fifth domain for this keyword in organic or Ads results

Ph - The search query the site has within the first 20 search results

Po - The position of this URL for this keyword in organic or Ads results

Pp - The site's position for the search query (at the time of prior data collection)

Pt - An estimation of how much traffic site would get if it was ranked #1

Rh - Rating of sites by the number of visitors coming from the first 20 search results

Rk - Rating of sites by the number of visitors coming from the first 20 search results

Tc - The ratio of the estimated cost of buying the same number of visitors for this search query to the estimated cost of purchasing the same number of targeted visitors coming to this URL

Td - Dynamics of change in the number of search queries in the past 12 months (estimated)

Tm - Organic traffic changes

Tr - The ratio of the number of visitors coming to the URL from this keyword to all visitors coming

Tt - Ad Title

Um - Organic traffic cost changes

Ur - Target URL

Vu - Visible URL

Column names never change
Order of columns may be changed
Number of columns may be increased
Old columns may be removed only after notification

Sortings

Description of sortings:

am_asc - sorting by changes in adwords keywords, in ascending order (Am)

am_desc - sorting by changes in adwords keywords, in descending order (Am)

bm_asc - sorting by changes in adwords traffic, in ascending order (Bm)

bm_desc - sorting by changes in adwords traffic, in descending order (Bm)

cm_asc - sorting by changes in adwords trafic price, in ascending order (Cm)

cm_desc - sorting by changes in adwords trafic price, in descending order (Cm)

co_asc - sorting by competition, in ascending order (Co)

co_desc - sorting by competition, in descending order (Co)

cp_asc - sorting by cpc, in ascending order (Cp)

cp_desc - sorting by cpc, in descending order (Cp)

cr_desc - sorting by competitor relevance, in descending order (Cr)

np_desc - sorting by common keywords, in descending order (Np)

nq_asc - sorting by volume, in ascending order (Nq)

nq_desc - sorting by volume, in descending order (Nq)

nr_asc - sorting by number of results, in ascending order (Nr)

nr_desc - sorting by number of results, in descending order (Nr)

om_asc - sorting by changes in organic keywords, in ascending order (Om)

om_desc - sorting by changes in organic keywords, in descending order (Om)

p0_asc - sorting by position of 1st domain, in ascending order (P0)

p0_desc - sorting by position of 1st domain, in descending order (P0)

p1_asc - sorting by position of 2nd domain, in ascending order (P1)

p1_desc - sorting by position of 2nd domain, in descending order (P1)

p2_asc - sorting by position of 3rd domain, in ascending order (P2)

p2_desc - sorting by position of 3rd domain, in descending order (P2)

p3_asc - sorting by position of 4th domain, in ascending order (P3)

p3_desc - sorting by position of 4th domain, in descending order (P3)

p4_asc - sorting by position of 5th domain, in ascending order (P4)

p4_desc - sorting by position of 5th domain, in descending order (P4)

po_asc - sorting by position, in ascending order (Po)

po_desc - sorting by position, in descending order (Po)

tc_asc - sorting by traffic cost, in ascending order (Tc)

tc_desc - sorting by traffic cost, in descending order (Tc)

tm_asc - sorting by changes in organic traffic, in ascending order (Tm)

tm_desc - sorting by changes in organic traffic, in descending order (Tm)

tr_asc - sorting by traffic, in ascending order (Tr)

tr_desc - sorting by traffic, in descending order (Tr)

um_asc - sorting by changes in organic trafic price, in ascending order (Um)

um_desc - sorting by changes in organic trafic price, in descending order (Um)

Filters

To apply a filter to the report you should add parameter display_filter with an urlencoded string which contains filters separated by "|" (maximum number - 25).
A filter consists of <sign>|<field>|<operation>|<value>, where

<sign> - "+" or "-" (include/exclude)

<field> - possible fields: Ph, P0, P1, P2, P3, P4, Po, Pp, Nq, Cp, Ur, Vu, Tr, Tc, Co, Nr

Metrical fields

P0 - The position of fisrt domain for this keyword in organic or Ads results

P1 - The position of second domain for this keyword in organic or Ads results

P2 - The position of third domain for this keyword in organic or Ads results

P3 - The position of fourth domain for this keyword in organic or Ads results

P4 - The position of fifth domain for this keyword in organic or Ads results

Po - The position of this URL for this keyword in organic or Ads results

Pp - The position of the Ad at the time of previous data collection

Nq - Exact number of queries for the keyword per month (for the corresponding local version of search engine)

Cp - Average price of a click on an Ad for this search query (in U.S. dollars)

Tr - The ratio of the number of visitors coming to the URL from this keyword to all visitors coming

Tc - The ratio of the estimated cost of buying the same number of visitors for this search query to the estimated cost of purchasing the same number of targeted visitors coming to this URL

Co - Competition of advertisers for that term (the higher the number - the greater the competition)

Nr - The number of search results - how many results does the search engine return for this query
Textual fields

Ph - Search query that the URL has within the first 20 organic or Ads results

Ur - URL of a page on the site displayed in search results for this query (landing page)

Vu - Display URL. This is the URL displayed on your Ad, identifying your site for users

<operation> - possible operations: Eq, Gt, Lt, Bw, Ew, Co

For metrical fields

Eq - equals

Gt - greater than

Lt - less than
For textual fields

Bw - starts with

Ew - ends with

Eq - exactly matching

Co - containing

Wm - word matching

<value> - value to filter

Price in API units

$1 = 20,000 API units. View our API products ›

All prices displayed are per each line of results.

Type	Description	API units, per line	Historical data
domain_rank	Domain: Rank	10	50
domain_rank_history	Domain: Rank history	10	-
domain_organic	Domain: Organic keywords	10	50
domain_adwords	Domain: Ads keywords	20	100
domain_organic_organic	Domain: Organic competitors	40	200
domain_organic_adwords	Domain: Potential ads buyers	40	200
domain_adwords_organic	Domain: Potential ads sellers	40	200
domain_adwords_adwords	Domain: Ads competitors	40	200
phrase_fullsearch	Phrase: Phrase match report	20	-
phrase_related	Phrase: Related keywords report	40	200
phrase_organic	Phrase: Organic results	10	50
phrase_adwords	Phrase: Ads results	20	100
phrase_this	Phrase: General info	10	50
domain_domains	Domain VS Domains	80	400
url_organic	URL: Organic report	10	50
url_adwords	URL: Ads report	20	100
rank_difference	Rank: Ups & Downs	20	100
domain_adwords_historical	Domain: Ads history	100	-
phrase_adwords_historical	Phrase: Ads history	100	-

If you would like to retrieve a large amount of data, please contact us for discounted rates.

Error Messages

ERROR 30 :: LIMIT EXCEEDED
ERROR 50 :: NOTHING FOUND
ERROR 70 :: API KEY HASH FAILURE
ERROR 40 :: MANDATORY PARAMETER "action" NOT SET OR EMPTY
ERROR 41 :: MANDATORY PARAMETER "type" NOT SET OR EMPTY
ERROR 42 :: MANDATORY PARAMETER "domain" NOT SET OR EMPTY
ERROR 43 :: MANDATORY PARAMETER "phrase" NOT SET OR EMPTY
ERROR 44 :: MANDATORY PARAMETER "url" NOT SET OR EMPTY
ERROR 45 :: MANDATORY PARAMETER "vs_domain" NOT SET OR EMPTY
ERROR 120 :: WRONG KEY - ID PAIR
ERROR 121 :: WRONG FORMAT OR EMPTY HASH
ERROR 122 :: WRONG FORMAT OR EMPTY KEY
ERROR 130 :: API DISABLED
ERROR 131 :: LIMIT EXCEEDED
ERROR 132 :: API UNITS BALANCE IS ZERO
ERROR 133 :: DB ACCESS DENIED
ERROR 134 :: TOTAL LIMIT EXCEEDED
ERROR 135 :: API REPORT TYPE DISABLED

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

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

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

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

Integration scripts examples

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

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

PERL SEMrush API integration example script - perl_example.zip
PHP SEMrush API integration example script - php_example.zip
JavaScript SEMrush API integration example script - js_example.zip - Using this method, your API key will be visible to anyone who views your page source!!!

Billing example

Let’s suppose that you would like to receive 100 results of “domain_organic” report for the domain seobook.com. The request would appear as the following:

http://ca.api.semrush.com/?action=report&type=domain_organic&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_limit=100&export=api&export_columns=Ph,Po,Pp,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&domain=seobook.com&display_sort=tr_desc

A single line of results for the “domain_organic” report costs 10 API units. Since 100 lines were requested, 100x10 = 1,000 API units that would be deducted from your account.

Check API units balance

http://www.semrush.com/ca/users/countapiunits.html?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

SEMrush API v 3.0

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

Requested URL

Request example

Request parameters

Response example

SEMrush API
v 3.0