contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

10:00 AM - 6:00 PM (EST/EDT)

Monday - Friday

mobile-menu

Overview reports

Analytics divider Last updated: August 18, 2021

Domain Overview (All databases)

Price: 10 API units per line info
Historical price:
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 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 "1", the report’s columns will be wrapped in double quotation marks (").

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.

Columns

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.

Sortings

* 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)

Price: 10 API units per line info
Historical price:
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

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 "1", the report’s columns will be wrapped in double quotation marks (").

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.

Columns

* 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)

Price: 10 API units per line info
Historical price:
free

This report provides live and historical data on a domain’s keyword rankings in both organic and paid search in a chosen database.

Request parameters
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 "1", the report’s columns will be wrapped in double quotation marks (").

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.

Columns

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.

Sortings

* 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

Price: 20 API units per line info
Historical price:
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 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 "1", the report’s columns will be wrapped in double quotation marks (").

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.

Columns

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.

Sortings

* 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

Price: 10 API units per line info
Historical price:
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 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 "1", the report’s columns will be wrapped in double quotation marks (").

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.

Columns

display_filter Or, Ot, Oc, Sr, St, Sc

Filters for columns.

Filters

* 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