Get started API units balance

Need help? dropdown button

contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

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

Monday - Friday

mobile-menu

Overview reports

Analytics divider Last updated: April 16, 2024

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.

About the Domain Overview report ›

Request parameters
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

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.
display_offset integer

This parameter allows you to skip a specified number of results before sending a report.

Remember 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.

Keep in mind that the display_limit value must not exceed 4,000,000.
export_escape 1

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

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 lets you choose which column you'd like to sort your results by, in ascending or descending order.

Sortings

* Fields marked by an asterisk (*) are required

Endpoint (GET)

https://api.semrush.com/

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

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.

About the Domain Overview report ›

Request parameters
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).

Databases
export_escape 1

If the parameter is set to 1, the report's columns will be wrapped in double quotation marks (").
export_decode 1 or 0

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

https://api.semrush.com/

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

Domain Overview (history)

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

About the Domain Overview report ›

Request parameters
Name Value/Type Description
type* domain_rank_history

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

Databases
display_limit integer

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.
display_offset integer

This parameter allows you to skip a specified number of results before sending a report.

Remember 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.

Keep in mind that the display_limit value must not exceed 4,000,000.
export_escape 1

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (").
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: Rk, Or, Ot, Oc, Ad, At, Ac, Dt.

Columns
display_sort dt_asc, dt_desc

This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.

Sortings

* Fields marked by an asterisk (*) are required

Endpoint (GET)

https://api.semrush.com/

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

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 organic and paid search results.

About the Winners and Losers report ›

Request parameters
Name Value/Type Description
type* rank_difference

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

Databases
display_limit integer

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.
display_offset integer

This parameter allows you to skip a specified number of results before sending a report.

Remember 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.

Keep in mind that the display_limit value must not exceed 4,000,000.
export_escape 1

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (").
export_decode 1 or 0

If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response won't be converted.
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.

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 lets you choose which column you would like to sort your results by, in ascending or descending order.

Sortings

* Fields marked by an asterisk (*) are required

Endpoint (GET)

https://api.semrush.com/

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

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.

About the Semrush Rank report ›

Request parameters
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).

Databases
display_limit integer

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.
display_offset integer

This parameter allows you to skip a specified number of results before sending a report.

Remember 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.

Keep in mind that the display_limit value must not exceed 4,000,000.
export_escape 1

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (").
export_decode 1 or 0

If this parameter is set to 0, the response will be sent as a URL-encoded string. Otherwise, the response won't be converted.
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.

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

Filters for columns.

Filters

* Fields marked by an asterisk (*) are required

Endpoint (GET)

https://api.semrush.com/

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