Overview reports
Jump to Domain Overview (all databases)Domain 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 domain’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: domain_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
domainRequired
Value/Type: example.com
database
Regional database (one value from the list). For details, refer to Databases.
If this parameter isn’t specified, your request will be sent to all regional databases. You can expect to get about 140 lines in the response, depending on the databases you have access to.
Value/Type: database
display_limit
The 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.
Keep in mind 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.
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
A date for which the report will be shown. You can roll back to a date in the past or choose the current date.
For example, for December 2023, set this parameter to 20231215. If you want to get the most recent data, don’t use this parameter or leave the value empty.
Value/Type: date in format "YYYYMM15"
export_columns
This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.
If this parameter isn’t specified, the default columns will be sent (Db, Dn, Rk, 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’d 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=domain_ranks&export_columns=Db,Dn,Rk,Or,Ot,Oc,Ad,At,Ac,Sh,Sv&domain=apple.com&database=usDatabase;Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;PLA keywords;PLA uniques
us;apple.com;17;16464474;149904314;169865994;128201;2419518;2807373;38208;1583Jump to Domain Overview (one database)Domain 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 domain’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: domain_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
domainRequired
Value/Type: example.com
databaseRequired
Regional database (one value from the list).
For details, refer to Databases.
Value/Type: database
export_escape
If the parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).
Value/Type: 1
export_decode
If the parameter is set to 0, the response will be sent as a URL-encoded string; if it’s 1, the response won’t be converted.
Value/Type: 1 or 0
display_date
A date for which the report will be shown. You can roll back to a date in the past or choose the current date.
For example, for December 2023, set this parameter to 20231215. If you want to get the most recent data, don’t use this parameter or leave the value empty.
Value/Type: date in format "YYYYMM15"
export_columns
This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.
If this parameter isn’t specified, the default columns will be sent (Dn, Rk, Or, Ot, Oc, Ad, At, Ac).
For details, refer to Columns.
Value/Type: Dn, Rk, 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
https://api.semrush.com/?type=domain_rank&key=API_KEY&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=seobook.com&database=usDomain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost
seobook.com;24041;5249;37332;143496;0;0;0Jump to Domain Overview (history)Domain Overview (history)
Price: 10 API units per line
This report provides live and historical data on the requested domain’s keyword rankings in both organic and paid search in a chosen database. You can get monthly rankings from as far back as 2012–2016, depending on the database, or daily rankings for the last 31 days (with display_daily).
About the Domain Overview report ›
Jump to EndpointEndpoint
Request Parameters
typeRequired
Report type.
In comparison with domain_rank and domain_ranks, the domain_rank_history report returns monthly historical data for a domain. All three can return the same data when querying for the same domain and time frame.
Value/Type: domain_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
domainRequired
Value/Type: example.com
databaseRequired
Regional database (one value from the list).
For details, refer to Databases.
Value/Type: database
display_limit
The 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.
Keep in mind 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.
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_daily
This parameter lets you get daily updates on position changes in the last 31 days. If the parameter isn’t specified, your report will show monthly results for the current and previous months.
Value/Type: 1
export_columns
This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.
If this parameter isn’t specified, the default columns will be sent (Rk, Or, Ot, Oc, Ad, At, Ac, Dt).
For details, refer to Columns.
Value/Type: Rk, Or, Xn, Ot, Oc, Ad, At, Ac, Dt, FKn, FPn, Sr, Srb, St, Stb, Sc
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=domain_rank_history&key=API_KEY&display_limit=10&export_columns=Rk,Or,Ot,Oc,Ad,At,Ac,Dt&domain=ebay.com&database=usRank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Date
19;31504470;130638193;86905921;855962;25237906;18531300;20181215
19;31428334;130546351;87216370;781997;24688558;18258152;20181115
20;34087220;132189007;87847948;681771;18793935;14881683;20181015
24;36261896;108559244;79568188;596593;18348335;13814442;20180915
17;35872063;145322220;98773137;459219;17132356;11858911;20180815
22;31971728;126192213;83310184;396048;14714089;10535151;20180715
22;32150402;129064157;85648349;656471;17195723;11821757;20180615
22;32233111;129012619;87024318;572933;16868825;11620251;20180515
22;33578371;129326683;86572478;568862;16842916;11609684;20180415
23;34324832;128669039;85257252;565697;16847760;11621421;20180315Jump to Winners and LosersWinners and Losers
Price: 20 API units per line
Price for historical data: 100 API units per line
This report shows changes in the number of keywords, traffic, and budget estimates of the most popular websites in Google’s top 100 organic and paid search results.
About the Winners and Losers report ›
Jump to EndpointEndpoint
Request Parameters
typeRequired
Value/Type: rank_difference
keyRequired
Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.
Value/Type: API_KEY
databaseRequired
Regional database (one value from the list).
For details, refer to Databases.
Value/Type: database
display_limit
The 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.
Keep in mind 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.
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
A date for which the report will be shown. You can roll back to a date in the past or choose the current date.
For example, for December 2023, set this parameter to 20231215. If you want to get the most recent data, don’t use this parameter or leave the value empty.
Value/Type: date in format "YYYYMM15"
export_columns
This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.
If this parameter isn’t specified, the default columns will be sent (Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Tm, Um, Am, Bm, Cm).
For details, refer to Columns.
Value/Type: Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Om, Tm, Um, Am, Bm, Cm, Sr, St, Sc, Srm, Stm, Scm
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: om_asc, om_desc, tm_asc, tm_desc, um_asc, um_desc, am_asc, am_desc, bm_asc, bm_desc, cm_asc, cm_desc, srm_desc, srm_asc, stm_desc, stm_asc, scm_desc, scm_asc
https://api.semrush.com/?type=rank_difference&key=API_KEY&display_limit=5&database=usDomain;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
wikipedia.org;1;83084012;1953530514;1766901500;98;6375;9285;469000;176196;-1008051;1;3;13
sites-domme.com;82912;356281;17749;18861;0;0;0;329506;16924;18008;0;0;0
namvideo.com;32556;996641;56717;37766;0;0;0;251320;9382;2923;0;0;0
suziequimpertraiteur.com;83918;472690;17493;23327;0;0;0;173988;-11050;-12218;0;0;0
pinterest.es;4684;4842602;531065;176004;0;0;0;155799;24012;-2499;0;0;0Jump to Semrush RankSemrush Rank
Price: 10 API units per line
Price for historical data: 50 API units per line
This report lists the most popular domains ranked by traffic originating from Google’s top 100 organic search results.
About the Semrush Rank report ›
Jump to EndpointEndpoint
Request Parameters
typeRequired
Value/Type: 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
databaseRequired
Regional database (one value from the list).
For details, refer to Databases.
Value/Type: database
display_limit
The 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.
Keep in mind 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.
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
A date for which the report will be shown. You can roll back to a date in the past or choose the current date.
For example, for December 2023, set this parameter to 20231215. If you want to get the most recent data, don’t use this parameter or leave the value empty.
Value/Type: date in format "YYYYMM15"
export_columns
This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.
If this parameter isn’t specified, the default columns will be sent (Dn, Rk, Or, Ot, Oc, Ad, At, Ac).
For details, refer to Columns.
Value/Type: Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sr, St, Sc
https://api.semrush.com/?key=API_KEY&type=rank&display_limit=10&database=usDomain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost
wikipedia.org;1;83084012;1953530514;1766901500;98;6375;9285
youtube.com;2;71381392;874589621;496405761;68366;63473756;29516519
amazon.com;3;76392627;677301991;516247065;7674897;606923091;363744884
facebook.com;4;59801076;629787192;375601566;86015;33960778;26585075
google.com;5;298085025;613488552;566022367;1595846;281663489;487303722
imdb.com;6;17461526;483977535;412200555;6339;560097;106539
twitter.com;7;32510040;385551377;360045590;9697;2709637;2624519
pornhub.com;8;5153670;256082593;63910755;0;0;0
merriam-webster.com;9;2491950;213086954;188495487;88;157540;58197
craigslist.org;10;6979245;206372423;286510568;139;63063;69747Last updated: January 27, 2026