Semrush Developers

Price: 10 API units per line info

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

Request parameters

Name	Value/Type	Description
type*	domain_organic	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list). Databases
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value `"1"`, the report’s columns will be wrapped in double quotation marks (").
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.
display_daily	1	This 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. This option is applied only when display_positions is set.
export_columns	Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tg, Tc,… Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tg, Tc, Co, Nr, Td, Kd, Fp, Fk, Ts, In	Required columns must be separated by commas; if this parameter is not specified, default columns will be sent. Columns
display_sort	po_asc, po_desc, tg_asc, tg_desc, tr_as… po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc, co_asc, co_desc, kd_asc, kd_desc, cp_asc, cp_desc, nr_asc, nr_desc, ts_asc, ts_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Sortings
display_positions	new, lost, rise or fall	The value "new" indicates keywords with which a domain entered Google's top 100 organic or paid search results; "lost" indicates keywords that no longer bring a domain to Google's top 100 organic or paid search results; "rise" indicates keywords that helped a domain to get a higher ranking in Google's top 100 organic or paid search results; "fall" indicates keywords that are currently helping a domain remain in the Google top 100, though its ranking may have decreased.
display_filter	Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co,… Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd, Fp, Fk, In	Filters for columns. Filters

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_organic&key=YOUR_API_KEY&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;9;10;1;110000;14.82;http://www.seobook.com/;17.53;44.40;0.50;0;0.81,1.00,1.00,1.00,1.00,0.81,0.81,0.81,0.81,0.81,0.81,0.81
seobook;1;1;0;1300;4.54;http://www.seobook.com/;5.52;4.28;0.32;379000;0.62,0.81,0.62,0.81,0.81,0.62,0.62,0.81,0.81,0.62,1.00,0.81
seo tools;6;6;0;8100;10.54;http://tools.seobook.com/;2.15;3.87;0.54;321000000;0.67,0.82,0.82,1.00,0.82,0.82,0.67,0.67,0.67,0.67,0.82,0.82
seo basics;2;2;0;1600;6.84;http://www.seobook.com/learn-seo/seo-basics/;1.10;1.29;0.22;42500000;0.81,1.00,1.00,1.00,1.00,1.00,1.00,1.00,1.00,0.81,1.00,0.81
seo book keyword tool;1;1;0;110;16.73;http://tools.seobook.com/keyword-tools/seobook/;0.46;1.33;0.34;5340000;0.41,0.41,0.52,0.52,0.65,0.82,0.65,1.00,1.00,0.82,0.65,0.41
seo book keyword density;1;1;0;110;6.64;http://tools.seobook.com/general/keyword-density/;0.46;0.53;0.15;539000;0.14,0.43,0.43,0.33,0.33,0.24,0.52,0.67,0.81,0.81,1.00,1.00
free seo tools;6;6;0;1600;7.18;http://tools.seobook.com/;0.42;0.52;0.60;204000000;0.68,0.84,1.00,1.00,1.00,0.84,0.84,1.00,1.00,0.84,1.00,0.84
learn seo;8;8;0;1900;7.76;http://www.seobook.com/learn-seo/;0.30;0.40;0.47;396000000;0.67,0.79,0.79,0.79,0.79,0.79,1.00,0.79,0.79,0.67,0.79,0.67
aaron seo;1;1;0;70;0.00;http://www.seobook.com/;0.29;0.00;0.03;16300000;0.22,0.56,0.11,0.44,0.11,0.11,0.11,0.33,0.11,1.00,0.78,0.22
seo book keyword suggestion tool free download;1;1;0;70;0.00;http://tools.seobook.com/;0.29;0.00;0.14;775000;0.29,1.00,0.00,0.43,0.00,0.00,0.14,0.00,0.14,0.00,0.00,0.43

Price: 20 API units per line info

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

Request parameters

Name	Value/Type	Description
type*	domain_adwords	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list). Databases
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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.
export_columns	Ph, Po, Pp, Pd, Ab, Nq, Cp, Tg, Tr, Tc,… Ph, Po, Pp, Pd, Ab, Nq, Cp, Tg, Tr, Tc, Co, Nr, Td, Tt, Ds, Vu, Ur, Ts, Un	Required columns must be separated by commas; if this parameter is not specified, default columns will be sent. Columns
display_sort	po_asc, po_desc, tg_asc, tg_desc, tr_as… po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Sortings
display_positions	new, lost, rise or fall	The value "new" indicates keywords with which a domain entered Google's top 100 organic or paid search results; "lost" indicates keywords that no longer bring a domain to Google's top 100 organic or paid search results; "rise" indicates keywords that helped a domain to get a higher ranking in Google's top 100 organic or paid search results; "fall" indicates keywords that are currently helping a domain remain in the Google top 100, though its ranking may have decreased.
display_filter	Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co,… Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd, Un	Filters for columns. Filters

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_adwords&key=YOUR_API_KEY&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
g tube pads amazon;1;1;0;30;0.36;www.ebay.com/;0.00;0;0.88;3130000;0.14,0.14,0.43,0.14,0.71,0.14,0.57,0.14,1.00,0.14,0.14,0.14
13.8 v power supply;1;1;0;140;1.24;www.ebay.com/;0.00;8;1.00;9750000;0.82,0.82,0.52,1.00,0.82,0.65,0.65,0.65,0.82,0.82,0.82,1.00
ruger 22 250 magazine;1;1;0;10;0.02;www.ebay.com/22+250+magazine;0.00;0;0.64;1370000;1.00,0.60,0.80,0.40,0.20,0.20,0.20,0.20,0.20,0.20,0.20,0.40
nike roshe run woven rainbow buy online;1;1;0;50;0.00;www.ebay.com/;0.00;0;0.00;34;0.00,0.00,0.00,0.00,0.00,0.00,0.00,1.00,0.00,0.00,0.00,0.00
wildside under the influence vinyl;1;1;0;30;0.00;;0.00;0;0.00;83;0.11,0.11,1.00,0.11,0.33,0.22,0.00,0.11,0.00,0.11,0.11,0.11
rca 45 record player;1;1;0;10;0.20;www.ebay.com/;0.00;0;1.00;1170000;0.03,0.13,0.03,0.08,0.03,0.03,0.03,0.08,0.03,0.18,0.18,1.00
uber store;1;1;0;720;2.43;www.ebay.com/Uber+store;0.00;82;0.52;149000000;0.67,0.82,0.55,0.67,0.67,0.67,0.82,1.00,0.82,0.82,0.82,0.82
mouse maze for sale;1;1;0;40;0.16;;0.00;0;1.00;7410000;1.00,0.50,0.50,1.00,0.50,0.50,0.50,1.00,0.50,0.50,0.50,1.00
air britain;1;1;0;140;0.64;www.ebay.com/;0.00;4;0.08;64200000;1.00,1.00,1.00,1.00,0.82,0.82,0.82,1.00,0.82,0.82,0.82,0.53
esoterica stonehaven;1;1;0;140;0.02;;0.00;0;0.08;67;0.81,0.81,0.35,0.65,0.42,0.27,0.27,0.35,0.54,0.54,1.00,0.54

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.

Request parameters

Name	Value/Type	Description
type*	domain_adwords_unique	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list). Databases
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value `"1"`, the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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,Un,Tt,Ds,Vu,Ur,Pc,Ts	Required columns must be separated by commas; if this parameter is not specified, default columns will be sent. Columns
display_sort	pc_asc, pc_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Sortings
display_filter	Tt, Ds, Vu	Filters for columns. Filters

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_adwords_unique&key=YOUR_API_KEY&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

Price: 40 API units per line info

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

Request parameters

Name	Value/Type	Description
type*	domain_organic_organic	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list).
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value `"1"`, the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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.
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. Columns
display_sort	np_desc, np_asc, cr_desc, cr_asc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Sortings

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_organic_organic&key=YOUR_API_KEY&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
seochat.com;0.13;338;11021;5640;9690;0
seocentro.com;0.12;237;2196;8091;43478;0
internetmarketingninjas.com;0.12;323;15751;16182;30168;20
webconfs.com;0.12;265;6689;4291;14093;0
link-assistant.com;0.12;326;18255;13089;51583;26
wordtracker.com;0.12;289;7685;11254;51352;1
keywordtool.io;0.11;337;19247;103615;145337;1
kwfinder.com;0.10;259;4885;8260;33067;2
seoreviewtools.com;0.10;240;4537;7181;32502;0
smallseotools.com;0.10;469;21126;299488;450094;10

Price: 40 API units per line info

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

Request parameters

Name	Value/Type	Description
type*	domain_adwords_adwords	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list). Databases
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value `"1"`, the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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.
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. Columns
display_sort	np_desc, np_asc, cr_desc, cr_asc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Sortings

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_adwords_adwords&key=YOUR_API_KEY&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
bestdeals.today;0.07;192427;4180961;231702687;219085005;98743
amazon.com;0.07;337566;7674897;606923091;363744884;76392627
discount99.us;0.04;21583;82580;486315;307513;0
netdeals.com;0.03;27343;740384;38400483;28864800;6
walmart.com;0.03;21533;558633;146423426;31455771;19967088
blackfridaydeals2016.co;0.02;23660;1091009;75093364;65877087;0
informationvine.com;0.02;25758;1377703;86672506;90105545;0
target.com;0.02;21805;1037283;52256534;51634896;9181821
savesmart.com;0.02;11659;151845;5477272;5183214;8
shop411.com;0.02;29103;1896105;84369570;98212347;0

Price: 100 API units per line info

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

Request parameters

Name	Value/Type	Description
type*	domain_adwords_historical	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list). Databases
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value `"1"`, the report’s columns will be wrapped in double quotation marks (").
export_columns	Ph, Dt, Po, Cp, Nq, Tr, Ur, Tt, Ds, Vu,… 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. Sortings
display_filter	Ph, Nq, Cp, Tr	Filters for columns. Filters

* Fields marked by an asterisk (*) are required

Request example

https://api.semrush.com/?type=domain_adwords_historical&key=YOUR_API_KEY&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;20181215;1;0.02;83100000;3905700;https://www.amazon.com/;Amazon.com Official Site | Free 2-Day Shipping with Prime Ad www.amazon.com/;Earth's biggest selection of books, electronics, apparel & more at low prices. Fast Shipping. Try Prime for Free. Save with Our Low Prices. Explore Amazon Devices. Read Ratings & Reviews. Shop Our Huge Selection. Shop Best Sellers & Deals.;
amazon;20181115;1;0.02;83100000;3905700;https://www.amazon.com/;Amazon.com® Official Site | Huge Selection & Great Prices Ad www.amazon.com/;Free Two-Day Shipping with Prime. Read Ratings & Reviews. Explore Amazon Devices. Fast Shipping.;
amazon;20181015;1;0.02;83100000;3905700;http://www.amazon.com/;Amazon.com Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Read Ratings & Reviews. Try Prime for Free. Explore Amazon Devices. Shop Best Sellers & Deals. Save with Our Low Prices. Shop Our Huge Selection. Fast Shipping.;www.amazon.com/
amazon;20180915;1;0.02;83100000;3905700;http://www.amazon.com/;Amazon.com Official Site | Free 2-Day Shipping with Prime;Earth's biggest selection of books, electronics, apparel & more at low prices.;www.amazon.com/
amazon;20180815;1;0.02;83100000;3905700;http://www.amazon.com/;Amazon.com | Amazon® Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Explore Amazon Devices. Shop Our Huge Selection. Read Ratings & Reviews. Try Prime for Free. Fast Shipping. Save with Our Low Prices.;www.amazon.com/
amazon;20180715;1;0.02;83100000;3905700;http://www.amazon.com/;amazon - Official Site | Huge Selection at amazon.com;Discounted Contemporary Furniture at amazon .com;www.amazon.com/
amazon;20180615;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music
amazon;20180515;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music
amazon;20180415;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music
amazon;20180315;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music
amazon;20180215;1;0.02;83100000;3905700;http://www.amazon.com/;;Free Two-Day Shipping with Prime.;www.amazon.com/
amazon;20180115;1;0.02;83100000;3905700;http://www.amazon.com/music;Amazon.com - Amazon Music Unlimited - 3 months for 99¢;Limited-time offer! 3 months of music streaming for $0.99. Alexa ready. Try now.;www.amazon.com/music

Price: 80 API units per line info

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.

Request parameters

Name	Value/Type	Description
type*	domain_domains	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domains*	string	A 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*	database	A regional database (one value from the list). Databases
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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.
export_columns	Ph, P0, P1, P2, P3, P4, Nr, Cp, Nq, Kd,… Ph, P0, P1, P2, P3, P4, Nr, Cp, Nq, Kd, Co, Td	Required columns must be separated by commas; if this parameter is not specified, default columns will be sent. Columns
display_sort	p0_asc, p0_desc, p1_asc, p1_desc, p2_as… 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. Sortings
display_filter	Ph, P0, P1, P2, P3, P4, Nq, Cp, Co, Nr	Filters for columns. Filters

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_domains&key=YOUR_API_KEY&database=us&display_limit=10&domains=*|or|nike.com|*|or|adidas.com|*|or|reebok.com&export_columns=Ph,P0,P1,P2,Co,Nq,Cp

Response example

Keyword;nike.com;adidas.com;reebok.com;Competition;Search Volume;CPC
shoes;69;33;81;1.00;1500000;0.91
basketball shoes;1;11;14;1.00;368000;0.39
man;30;41;68;0.00;301000;0.22
running;26;31;33;0.01;301000;1.26
shoes for men;44;25;49;1.00;301000;0.71
shoes for women;60;27;39;1.00;301000;0.77
running shoes;2;21;22;1.00;201000;0.88
soccer cleats;5;6;74;1.00;165000;0.35
hoodies for men;51;44;53;1.00;135000;0.92
kids shoes;7;21;38;1.00;135000;0.72

Price: 30 API units per line info

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

Request parameters

Name	Value/Type	Description
type*	domain_shopping	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list).
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	1	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value `"1"`, the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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_as… 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.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_shopping&key=YOUR_API_KEY&domain=ebay.com&database=us&display_limit=3&display_sort=nq_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
apple watch;5;0;-5;1830000;eBay;http://www.ebay.com/i/123473122981;Apple Watch Series 2 - 38MM - Aluminum Case - White Sport Band - Smartwatch;169.99;1548155351
playstation;5;0;-5;673000;eBay;http://www.ebay.com/i/113408567972;877 Fully Tested Ps Vita PCH-1100 AB01 Crystal Black Console System Fw 3.68;95.94;1548148745
playstation;7;0;-7;673000;eBay;http://www.ebay.com/i/113493854733;Sony PlayStation 2 PS2 Fat Console Controller W/ Cords - Boots Up Refurbished;34.07;1548148745

Price: 60 API units per line info

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

Request parameters

Name	Value/Type	Description
type*	domain_shopping_unique	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list). Databases
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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,Un,Ts	Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_sort	pr_asc, pr_desc, pc_asc, pc_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Sortings
display_filter	Tt,Pr	Filters for columns. Columns

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

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

Response example

Title;Product Price;Url;Number of Keywords
Windows 7 Professional 32/64 Bit Activation Key;6.1;http://www.ebay.com/i/323416369252;390
Microsoft Windows 7 Ultimate 32/64 Bit SP1&2 Download Link & MS Activation Key;4.99;http://www.ebay.com/i/202550754305;245
1080P DIY Spy Hidden Nanny Micro Pinhole Built-in Battery HD Camera DVR Recorder;32;http://www.ebay.com/i/192495737640;236

Price: 60 API units per line info

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

Request parameters

Name	Value/Type	Description
type*	domain_shopping_shopping	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list).
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value `"1"`, the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_shopping_shopping&key=YOUR_API_KEY&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
walmart.com;0.17;316712;555313;145469121;30624447;19966933
amazon.com;0.13;488457;7126039;568143801;329123277;76322373
etsy.com;0.08;117812;38328;22363968;3015402;9654230
newegg.com;0.05;61108;11250;6273638;2207224;2190128
jet.com;0.05;60721;9777;151975;161632;634721
target.com;0.05;62272;1037704;51821814;51369601;9143593
homedepot.com;0.04;67022;492858;103685779;56643236;7106954
zoro.com;0.04;60008;56711;1996755;1891827;304263
poshmark.com;0.04;52296;10435;5570134;1155108;2321101
bestbuy.com;0.04;45126;96379;54662964;20450677;5160927

Price: 10 API units per line info

This report shows unique pages of the analyzed domain ranking in Google's top 100 results organic search results

Request parameters

Name	Value/Type	Description
type*	domain_organic_unique	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list).
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value "1", the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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.
export_columns	Ur, Pc, Tg, Tr, Ipu, Ip0, Ip1, Ip2, Ip3… Ur, Pc, Tg, Tr, Ipu, Ip0, Ip1, Ip2, Ip3, Itu, It0, It1, It2, It3	Required columns must be separated by commas; if this parameter is not specified, default columns will be sent. Columns
display_sort	Pc, Tg, Tr	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Sortings
display_filter	Ur, Pc, Tg, Tr, Ipu, Ip0, Ip1, Ip2, Ip3	Filters for columns. Filters

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_organic_unique&key=YOUR_API_KEY&display_filter=%2B%7CPc%7CGt%7C100&display_limit=10&export_columns=Ur,Pc,Tg,Tr&domain=seobook.com&display_sort=tr_desc&database=us

Response example

Url;Number of Keywords;Traffic;Traffic (%)
http://www.seobook.com/;317;2488;15.14
http://tools.seobook.com/meta-medic/;492;1289;7.84
http://tools.seobook.com/robots-txt/generator/;197;1133;6.89
http://tools.seobook.com/;588;1015;6.17
http://tools.seobook.com/ppc-tools/free-ppc-ad-coupons.html;930;916;5.57
http://tools.seobook.com/general/keyword-density/;417;794;4.83
http://tools.seobook.com/keyword-tools/seobook/;262;729;4.43
http://tools.seobook.com/server-header-checker/;322;722;4.39
http://tools.seobook.com/robots-txt/;319;583;3.54
http://tools.seobook.com/keyword-list/generator.php;103;469;2.85

Price: 10 API units per line info

This report shows subdomains of the analyzed domain ranking in Google's top 100 organic search results

Request parameters

Name	Value/Type	Description
type*	domain_organic_subdomains	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
domain*	example.com	A unique name of a website you’d like to investigate.
database*	database	A regional database (one value from the list).
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines. Please keep in mind that the max number of the returned results is 100,000. If you need more results, refer to display_offset.
display_offset	integer	This 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. Please keep in mind that if you need more than the first 100,000 results, add the value of display_offset to the value of display_limit.
export_escape	1	If this parameter uses the value `"1"`, the report’s columns will be wrapped in double quotation marks (").
export_decode	1 or 0	If 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.
export_columns	Ur, Pc, Tg, Tr	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

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=domain_organic_subdomains&key=YOUR_API_KEY&display_limit=10&export_columns=Ur,Pc,Tg,Tr&domain=apple.com&database=us

Response example

Url;Number of Keywords;Traffic;Traffic (%)
itunes.apple.com;12576097;80811145;53.47
www.apple.com;1461853;43132944;28.54
support.apple.com;1255701;21914725;14.50
discussions.apple.com;1042589;2163623;1.43
trailers.apple.com;67190;799797;0.53
developer.apple.com;125007;713958;0.47
secure.store.apple.com;3036;482174;0.32
checkcoverage.apple.com;4368;210723;0.14
beta.apple.com;1113;205472;0.14
appleid.apple.com;351;139299;0.09

Domain reports

Domain Organic Search Keywords

Request parameters

Domain Paid Search Keywords

Request parameters

Ads Copies

Request parameters

Competitors in Organic Search

Request parameters

Competitors in Paid Search

Request parameters

Domain Ad History

Request parameters

Domain vs. Domain

Request parameters

Domain PLA Search Keywords

Request parameters

PLA Copies

Request parameters

PLA Competitors

Request parameters

Domain Organic Pages

Request parameters

Domain Organic Subdomains

Request parameters