Developer
Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Overview reports
Analytics
Last updated: April 16, 2024
Last updated: April 16, 2024
Domain Overview (All databases)
Historical price:
50 API units per line
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.
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | domain_ranks | 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; if this parameter isn't specified, your request will be sent to all regional databases. |
| display_limit | integer | The number of results returned to a request; if this parameter isn't specified or equals Keep in mind that the max. number of the returned results is 100,000. If you need more results, refer to display_offset. The max. value for display_limit is 4,000,000. |
| display_offset | integer | 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 or display_limit option, the value should be increased by the display_offset value. 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 is set to |
| display_date |
date in format "YYYYMM15" for historica…
date in format "YYYYMM15" for historical data or it should be skipped to get the current date
|
The date for which the report will be shown. You can roll back to the past or choose the current date. |
| export_columns |
Db, Dt, Dn, Rk, Or, Ot, Oc, Ad, At, Ac,…
Db, Dt, Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sh, Sv, FKn, FPn, Sr, Srb, St, Stb, Sc, Srn, Srl
|
The required columns must be separated by commas; if this parameter isn't specified, the default columns will be sent. |
| display_sort |
rk_asc, rk_desc, or_asc, or_desc, ot_as…
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
|
This parameter allows you to choose by which column you would like to sort your results in ascending or descending order. |
* Fields marked by an asterisk (*) are required
Endpoint
https://api.semrush.com/
Request example
https://api.semrush.com/?key=YOUR_API_KEY&type=domain_ranks&export_columns=Db,Dn,Rk,Or,Ot,Oc,Ad,At,Ac,Sh,Sv&domain=apple.com&database=us
Response example
Database;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;1583
Domain Overview (One database)
Historical price:
50 API units per line
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.
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | domain_rank | 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 | The unique name of a website you'd like to investigate. |
| database* | database | A regional database (one value from the list). |
| export_escape | 1 | If the value of this parameter is |
| export_decode | 1 or 0 | If the value of this parameter is |
| display_date |
date in format "YYYYMM15" for historica…
date in format "YYYYMM15" for historical data or it should be skipped to get the current date
|
The date for which a report will be shown. You can roll back to the past or choose the current date. |
| export_columns |
Dn, Rk, Or, Xn, Ot, Oc, Ad, At, Ac, FKn…
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
|
Required columns must be separated by commas; if this parameter isn't 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_rank&key=YOUR_API_KEY&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=seobook.com&database=us
Response example
Domain;Rank;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost seobook.com;24041;5249;37332;143496;0;0;0
Domain Overview (History)
Historical price:
free
free
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).
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | domain_rank_history | Report type. |
| key* | API_KEY | Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units. |
| domain* | example.com | Unique name of the website you'd like to investigate. |
| database* | database | Regional database (one value from the list). |
| display_limit | integer | The number of results returned to a request. If this parameter isn't specified or equals Keep in mind that the max. number of the returned results is 100,000. If you need more results, refer to The max. value for |
| display_offset | integer | This parameter allows you to skip a specified number of results before sending a report. If you use the If you need more than the first 100,000 results, add the value of |
| export_escape | 1 | If this parameter is set to |
| display_daily | 1 | 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. |
| export_columns |
Rk, Or, Xn, Ot, Oc, Ad, At, Ac, Dt, FKn…
Rk, Or, Xn, Ot, Oc, Ad, At, Ac, Dt, FKn, FPn, Sr, Srb, St, Stb, Sc
|
This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, the default columns are shown (Rk, Or, Ot, Oc, Ad, At, Ac, Dt). |
| display_sort | dt_asc, dt_desc | This parameter allows you to choose by which column you would like to sort your results in ascending or descending order. |
* Fields marked by an asterisk (*) are required
Endpoint
https://api.semrush.com/
Request example
https://api.semrush.com/?type=domain_rank_history&key=YOUR_API_KEY&display_limit=10&export_columns=Rk,Or,Ot,Oc,Ad,At,Ac,Dt&domain=ebay.com&database=us
Response example
Rank;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;20180315
Winners and Losers
Historical price:
100 API units per line
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 and paid search results.
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | rank_difference | The report type. |
| key* | API_KEY | A regional database (one value from the list). |
| database* | database | A regional database (one value from the list). |
| display_limit | integer | The number of results returned to a request; if this parameter isn't specified or equals Keep in mind that the max. number of the returned results is 100,000. If you need more results, refer to display_offset. The max. value for display_limit is 4,000,000. |
| display_offset | integer | 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 or display_limit option, the value should be increased by the display_offset value. 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 is set to |
| export_decode | 1 or 0 | If this parameter is set to |
| display_date |
date in format "YYYYMM15" for historica…
date in format "YYYYMM15" for historical data or it should be skipped to get the current date
|
A date for which the report will be shown. You can roll back to the past or choose the current date. |
| export_columns |
Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Om, Tm,…
Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Om, Tm, Um, Am, Bm, Cm, Sr, St, Sc, Srm, Stm, Scm
|
The required columns must be separated by commas; if this parameter isn't specified, the default columns will be sent. |
| display_sort |
om_asc, om_desc, tm_asc, tm_desc, um_as…
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
|
This parameter allows you to choose by which column you would like to sort your results in ascending or descending order. |
* Fields marked by an asterisk (*) are required
Endpoint
https://api.semrush.com/
Request example
https://api.semrush.com/?type=rank_difference&key=YOUR_API_KEY&display_limit=5&database=us
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 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;0
Semrush Rank
Historical price:
50 API units per line
50 API units per line
This report lists the most popular domains ranked by traffic originating from Google's top 100 organic search results.
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | rank | 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. |
| database* | database | A regional database (one value from the list). |
| display_limit | integer | The number of results returned to a request; if this parameter isn't specified or equals Keep in mind that the max. number of the returned results is 100,000. If you need more results, refer to display_offset. The max. value for display_limit is 4,000,000. |
| display_offset | integer | 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 or display_limit option, the value should be increased by the display_offset value. 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 is set to |
| export_decode | 1 or 0 | If this parameter is set to |
| display_date |
date in format "YYYYMM15" for historica…
date in format "YYYYMM15" for historical data or it should be skipped to get the current date
|
The date for which the report will be shown. You can roll back to the past or choose the current date. |
| export_columns |
Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sr, St,…
Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sr, St, Sc
|
The required columns must be separated by commas; if this parameter isn't specified, the default columns will be sent. |
| display_filter | Or, Ot, Oc, Sr, St, Sc | Filters for columns. |
* Fields marked by an asterisk (*) are required
Endpoint
https://api.semrush.com/
Request example
https://api.semrush.com/?key=YOUR_API_KEY&type=rank&display_limit=10&database=us
Response example
Domain;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;69747