Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Need help?
Telephone
United States
United States
Canada
United Kingdom
Spain
France
Italy
Germany
Australia
+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 | 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 is not specified, your request will be sent to all regional databases. |
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 |
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 |
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 must be separated by commas; if this parameter is not specified, 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 either ascending or descending order. |
* Fields marked by an asterisk (*) are required
Endpoint
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
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 | 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 (one value from the list). |
export_escape | 1 | If this parameter uses the value |
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 |
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 is not specified, default columns will be sent. |
* Fields marked by an asterisk (*) are required
Endpoint
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
This report provides live and historical data on a domain’s keyword rankings in both organic and paid search in a chosen database.
Name | Value/Type | Description |
---|---|---|
type* | domain_rank_history | 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 (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 |
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_daily | 1 | This parameter allows you to get daily updates on position changes that occurred in the last 30 days or more. If the parameter is not specified, your report will show monthly results for the current month and for 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
|
Required columns must be separated by commas; if this parameter is not specified, default columns will be sent. |
display_sort | dt_asc, dt_desc | This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. |
* Fields marked by an asterisk (*) are required
Endpoint
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
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.
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 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 |
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" for historica…
date in format "YYYYMM15" for historical data or "YYYYMMDD" for the last 30 days
|
A date on which a report will be shown. You can roll back to the past or choose an actual 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
|
Required columns must be separated by commas; if this parameter is not specified, 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 either ascending or descending order. |
* Fields marked by an asterisk (*) are required
Endpoint
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
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 | 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 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 |
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" for historica…
date in format "YYYYMM15" for historical data or "YYYYMMDD" for the last 30 days
|
A date on which a report will be shown. You can roll back to the past or choose an actual date. |
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
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