Get started API units balance

Need help? dropdown button

contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

10:00 AM - 6:00 PM (EST/EDT)

Monday - Friday

mobile-menu

URL reports

Analytics divider Last updated: August 18, 2021

URL organic search keywords

Price: 10 API units per line info
Historical price:
50 API units per line

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

Request parameters
Name Value/Type Description
type* url_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.
url* http://example.com/

The URL of a landing page 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 Ph, Po, Pp, Nq, Cp, Co, Kd, Tr, Tg, Tc,…
Ph, Po, Pp, Nq, Cp, Co, Kd, Tr, Tg, Tc, Nr, Td, Fp, Fk, Ts, In

Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
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.
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.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example 

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

Response example 

Keyword;Position;Search Volume;CPC;Competition;Traffic (%);Traffic Cost;Number of Results;Trends
seo tools;4;8100;10.54;0.54;3.21;5976;226000000;0.67,0.82,0.82,1.00,0.82,0.82,0.67,0.67,0.67,0.67,0.82,0.82
free seo tools;6;1600;7.18;0.60;0.45;574;209000000;0.68,0.84,1.00,1.00,1.00,0.84,0.84,1.00,1.00,0.84,1.00,0.84
seo book keyword suggestion tool free download;1;70;0.00;0.14;0.31;0;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
seo tools search engine software;2;210;0.00;0.02;0.15;0;37600000;0.54,1.00,1.00,0.81,0.65,0.81,1.00,0.81,0.81,0.81,0.54,0.35
tools seobook;1;30;16.96;0.29;0.13;407;162000;0.27,0.08,0.04,0.04,0.04,0.04,0.04,0.04,0.54,1.00,1.00,0.04
seo tools software;7;480;5.66;0.11;0.10;108;152000000;0.54,0.81,0.81,0.81,0.81,1.00,1.00,1.00,0.66,0.81,1.00,0.54
free seo;7;480;4.09;0.54;0.10;78;727000000;0.81,1.00,0.81,1.00,1.00,0.66,0.81,0.81,0.81,0.81,1.00,1.00
search engine optimization tools;4;260;9.58;0.45;0.10;174;80600000;1.00,0.81,0.66,0.81,0.66,0.66,0.81,0.81,0.81,0.66,1.00,1.00
seo optimization tools;4;210;8.21;0.33;0.07;120;56300000;0.81,1.00,0.81,0.81,0.81,0.81,0.65,0.81,0.65,0.65,0.81,1.00
seo optimization software;6;210;21.58;0.13;0.05;226;59100000;0.54,0.81,0.54,0.54,0.81,0.81,0.81,0.54,0.65,0.81,1.00,1.00

URL paid search keywords

Price: 20 API units per line info
Historical price:
100 API units per line

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

Request parameters
Name Value/Type Description
type* url_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.
url* http://example.com/

The URL of a landing page 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 Ph, Po, Nq, Cp, Co, Tg, Tr, Tc, Nr, Td,…
Ph, Po, Nq, Cp, Co, Tg, Tr, Tc, Nr, Td, Tt, Ds, 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, 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.
display_filter Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co,…
Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd

Filters for columns.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example 

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

Response example 

Keyword;Position;Search Volume;CPC;Competition;Traffic (%);Traffic Cost;Number of Results;Trends;Title;Description
amazon;1;83100000;0.02;0.16;0.68;78114;81;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;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.
amazon;1;83100000;0.02;0.16;0.68;78114;75;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;Amazon.com Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Shop Our Huge Selection. Try Prime for Free.
amazon;1;83100000;0.02;0.16;0.68;78114;2680000000;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;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.
amazon;1;83100000;0.02;0.16;0.68;78114;84;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;Amazon® Official Site | Huge Selection & Great Prices;Free Two-Day Shipping with Prime. Shop Our Huge Selection. Fast Shipping. Read Ratings & Reviews. Shop Best Sellers & Deals. Stream Videos Instantly. Save with Our Low Prices.
amazon;1;83100000;0.02;0.16;0.68;78114;76;1.00,0.67,0.67,0.67,0.67,0.67,0.67,0.81,0.67,0.67,0.67,0.81;Amazon.com Official Site | Free 2-Day Shipping with Prime;Earth's biggest selection of books, electronics, apparel & more at low prices.