URL reports
Jump to URL Overview (one database)URL Overview (one database)
Price: 10 API units per line
Price for historical data: 50 API units per line
This report provides live or historical data on a URL’s keyword rankings in both organic and paid search in a chosen regional database.
About the Domain Overview report ›
Jump to EndpointEndpoint
Request Parameters
typeRequired
Value/Type: url_rank
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
urlRequired
Value/Type: https://example.com/shop/gift-cards
databaseRequired
Regional database (one value from the list).
For details, refer to Databases.
Value/Type: database
export_escape
If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).
Value/Type: 1
export_decode
If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response will not be converted.
Value/Type: 1 or 0
display_date
Date for which the report will be shown. You can roll back to a date in the past or choose the current date.
Value/Type: date in format "YYYYMM15"
export_columns
Use this parameter to choose which columns to include in the response. List the column names, separated by commas.
If you don’t set this parameter, the default columns will be sent: Rk, Or, Ot, Oc, Ad, At, Ac.
Note that Rk (Rank) returns 0 for URLs, subfolders, and subdomains. It only returns data for domains.
For details, refer to Columns.
Value/Type: Dn, Or, Xn, Ot, Oc, Ad, At, Ac, FKn, FPn, Ipu, Ip0, Ip1, Ip2, Ip3, Itu, It0, It1, It2, It3, Icu, Ic0, Ic1, Ic2, Ic3, Sr, Srb, St, Stb, Sc, Srn, Srl, Rk
https://api.semrush.com/?type=url_rank&key=API_KEY&export_columns=Or,Ot,Oc,Ad,At,Ac&url=https%3A%2F%2Fwww.ebay.com%2Fsignin%2F&database=usOrganic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost
507;394412;89819;1;15;2Jump to URL Overview (history)URL Overview (history)
Price: 10 API units per line
This report provides live and historical data on a URL’s keyword rankings in both organic and paid search in a chosen database.
About the Domain Overview report ›
Jump to EndpointEndpoint
Request Parameters
typeRequired
Value/Type: url_rank_history
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
urlRequired
Value/Type: https://example.com/shop/gift-cards
databaseRequired
Regional database (one value from the list).
For details, refer to Databases.
Value/Type: database
display_limit
Number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.
The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.
The maximum value for display_limit is 4,000,000.
Value/Type: integer
display_offset
This parameter allows you to skip a specified number of results before sending a report.
Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.
If you need more than the first 100,000 results, add the display_offset value to display_limit.
Keep in mind that the display_limit value must not exceed 4,000,000.
Value/Type: integer
export_escape
If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).
Value/Type: 1
Export_decode
If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response won’t be converted.
Value/Type: 1 or 0
display_daily
This parameter lets you get daily updates on position changes that occurred in the last 30 days or more. If the parameter isn’t specified, your report will show monthly results for the current and previous months.
Value/Type: 1
export_columns
Use this parameter to choose which columns to include in the response. List the column names, separated by commas.
If you don’t set this parameter, the default columns will be sent: Rk, Or, Ot, Oc, Ad, At, Ac, Dt.
Note that Rk (Rank) returns 0 for URLs, subfolders, and subdomains. It only returns data for domains.
For details, refer to Columns.
Value/Type: Or, Xn, Ot, Oc, Ad, At, Ac, Dt, FKn, FPn, Sr, Srb, St, Stb, Sc, Rk
display_sort
This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.
For details, refer to Sortings.
Value/Type: dt_asc, dt_desc
https://api.semrush.com/?type=url_rank_history&key=API_KEY&display_limit=10&export_columns=Or,Ot,Oc,Ad,At,Ac,Dt&url=https%3A%2F%2Fwww.ebay.com%2Fsignin%2F&database=usOrganic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Date
494;391514;101183;2;65;34;20230215
465;390692;112406;3;66;174;20230115
470;343142;639184;2;62;160;20221215
426;336945;617395;0;0;0;20221115
412;335270;47027;0;0;0;20221015
384;325031;56978;0;0;0;20220915
368;315269;46653;0;0;0;20220815
382;330839;59404;0;0;0;20220715Jump to URL Overview (all databases)URL Overview (all databases)
Price: 10 API units per line
Price for historical data: 50 API units per line
This report provides live or historical data on a URL’s keyword rankings in both organic and paid search in all regional databases.
About the Domain Overview report ›
Jump to EndpointEndpoint
Request Parameters
typeRequired
Value/Type: url_ranks
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
urlRequired
Value/Type: https://example.com/shop/gift-cards
database
Regional database. If this parameter isn’t specified, your request will be sent to all regional databases.
For details, refer to Databases.
Value/Type: database
display_limit
Number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.
The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.
The maximum value for display_limit is 4,000,000.
Value/Type: integer
display_offset
This parameter lets you skip a specified number of results before sending a report.
Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.
If you need more than the first 100,000 results, add the display_offset value to display_limit.
Keep in mind that the display_limit value must not exceed 4,000,000.
Value/Type: integer
export_escape
If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).
Value/Type: 1
display_date
Date for which the report will be shown. You can roll back to a date in the past or choose the current date.
Value/Type: date in format "YYYYMM15"
export_columns
Use this parameter to choose which columns to include in the response. List the column names, separated by commas.
If you don’t set this parameter, the default columns will be sent: Db, Rk, Dn, Or, Ot, Oc, Ad, At, Ac, Sh, Sv.
For details, refer to Columns.
Value/Type: Db, Dt, Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sh, Sv, FKn, FPn, Sr, Srb, St, Stb, Sc, Srn, Srl
display_sort
This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.
For details, refer to Sortings.
Value/Type: rk_asc, rk_desc, or_asc, or_desc, ot_asc, ot_desc, oc_asc, oc_desc, ad_asc, ad_desc, at_asc, at_desc, ac_asc, ac_desc
https://api.semrush.com/?key=API_KEY&type=url_ranks&export_columns=Db,Dn,Or,Ot,Oc,Ad,At,Ac,Sh,Sv&url=https%3A%2F%2Fwww.ebay.com%2Fsignin%2F&database=usDatabase;Domain;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;PLA keywords;PLA uniques
us;ebay.com;507;394412;89819;1;15;2;0;0Jump to URL organic search keywordsURL organic search keywords
Price: 10 API units per line
Price for historical data: 50 API units per line
This report lists keywords that bring users to a URL via Google’s top 100 organic search results.
About the Organic Research Overview report ›
Jump to EndpointEndpoint
Request Parameters
typeRequired
Value/Type: url_organic
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
urlRequired
Value/Type: http://example.com/
databaseRequired
Regional database (one value from the list).
For details, refer to Databases.
Value/Type: database
display_limit
Number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.
The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.
The maximum value for display_limit is 4,000,000.
Value/Type: integer
display_offset
This parameter lets you skip a specified number of results before sending a report.
Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.
If you need more than the first 100,000 results, add the display_offset value to display_limit.
Keep in mind that the display_limit value must not exceed 4,000,000.
Value/Type: integer
export_escape
If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).
Value/Type: 1
export_decode
If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response won’t be converted.
Value/Type: 1 or 0
display_date
Date for which the report will be shown. You can roll back to the past or choose the current date.
Value/Type: date in format "YYYYMM15"
export_columns
Use this parameter to choose which columns to include in the response. List the column names, separated by commas.
If you don’t set this parameter, the default columns will be sent: Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td, Fp, Ts.
For details, refer to Columns.
Value/Type: Ph, Po, Pp, Nq, Cp, Co, Kd, Tr, Tg, Tc, Nr, Td, Fp, Fk, Ts, In, Pt
display_sort
This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.
For details, refer to Sortings.
Value/Type: po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc
display_filter
Filters for columns.
For details, refer to Filters.
Value/Type: Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd, Fp, Fk, In, Br
display_positions_type
The organic value indicates keywords for which the URL ranks only in the traditional SERP positions. This is the default value.
all indicates keywords for which the URL ranks in the traditional positions and the SERP Features.
serp_features indicates keywords for which the URL ranks only in the SERP Features.
Value/Type: organic, all, serp_features
https://api.semrush.com/?type=url_organic&key=API_KEY&display_limit=10&export_columns=Ph,Po,Nq,Cp,Co,Tr,Tc,Nr,Td&url=http://tools.seobook.com/&database=usKeyword;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.00Jump to URL paid search keywordsURL paid search keywords
Price: 20 API units per line
Price for historical data: 100 API units per line
This report lists keywords that bring users to a URL via Google’s paid search results.
About the Advertising Research Positions report ›
Jump to EndpointEndpoint
Request Parameters
typeRequired
Value/Type: url_adwords
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
urlRequired
Value/Type: http://example.com/
databaseRequired
Regional database (one value from the list).
For details, refer to Databases.
Value/Type: database
display_limit
Number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.
The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.
The maximum value for display_limit is 4,000,000.
Value/Type: integer
display_offset
This parameter allows you to skip a specified number of results before sending a report.
Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.
If you need more than the first 100,000 results, add the display_offset value to display_limit.
Keep in mind that the display_limit value must not exceed 4,000,000.
Value/Type: integer
export_escape
If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).
Value/Type: 1
export_decode
If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response won’t be converted.
Value/Type: 1 or 0
display_date
Date for which the report will be shown. You can roll back to a date in the past or choose the current date.
Value/Type: date in format "YYYYMM15"
export_columns
Use this parameter to choose which columns to include in the response. List the column names, separated by commas.
If you don’t set this parameter, the default columns will be sent: Ph, Po, Nq, Cp, Co, Tr, Tc, Nr, Td, Tt, Ds.
For details, refer to Columns.
Value/Type: Ph, Po, Nq, Cp, Co, Tg, Tr, Tc, Nr, Td, Tt, Ds, Ts
display_sort
This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.
For details, refer to Sortings.
Value/Type: po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc
display_filter
Filters for columns.
For details, refer to Filters.
Value/Type: Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd
https://api.semrush.com/?type=url_adwords&key=API_KEY&display_limit=5&export_columns=Ph,Po,Nq,Cp,Co,Tr,Tc,Nr,Td,Tt,Ds&url=http://www.amazon.com/&database=usKeyword;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.Last updated: January 26, 2026