Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Need help?
Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
This report provides live or historical data on a domain's keyword rankings in both organic and paid search in all regional databases.
Name | Value/Type | Description |
---|---|---|
type* | domain_ranks | Report type. |
key* | API_KEY | Identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page. |
domain* | example.com | Unique name of the website you'd like to investigate. |
database | database | Regional database (one value from the list). 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. Learn more › |
display_limit | integer | 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, use the The max. value for |
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 If you need more than the first 100,000 results, add the |
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
|
Month for which the report will be shown. You can roll back to a month in the past or choose the current month. |
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
|
Required columns, separated by commas. If this parameter isn't specified, the default columns are 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 which column you'd like to sort your results by in ascending or descending order. |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
Request example
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=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
This report provides live or historical data on a domain’s keyword rankings in both organic and paid search in a chosen regional database.
Name | Value/Type | Description |
---|---|---|
type* | domain_rank | Report type. |
key* | API_KEY | Identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page. |
domain* | example.com | Unique name of a website you'd like to investigate. |
database* | database | Regional database (one value from the list). |
export_escape | 1 | If the parameter is set to |
export_decode | 1 or 0 | If the 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
|
Date for which a report will be shown. You can roll back to a date in 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. Columns › |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
Request example
https://api.semrush.com/?type=domain_rank&key=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
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
).
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, use the The max. value for |
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 If you need more than the first 100,000 results, add the |
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 following columns are shown by default: |
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 (GET)
Request example
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=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
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.
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, use the The max. value for |
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 If you need more than the first 100,000 results, add the |
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 a date in 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 (GET)
Request example
https://api.semrush.com/?type=rank_difference&key=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
This report lists the most popular domains ranked by traffic originating from Google's top 100 organic search results.
Name | Value/Type | Description |
---|---|---|
type* | rank | Report type. |
key* | API_KEY | Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units. |
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, use the The max. value for |
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 If you need more than the first 100,000 results, add the |
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 month for which the report will be shown. You can roll back to a month in the past or choose the current month. |
export_columns |
Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sr, St,…
Dn, Rk, Or, Ot, Oc, Ad, At, Ac, Sr, St, Sc
|
Required columns must be separated by commas; if this parameter is not specified, default columns will be sent. |
display_filter | Or, Ot, Oc, Sr, St, Sc | Filters for columns. |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
Request example
https://api.semrush.com/?key=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