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

Keyword reports

Analytics divider Last updated: August 18, 2021

Keyword Overview (All databases)

Price: 10 API units per line

This report provides a summary of a keyword, including its volume, CPC, competition, and the number of results in all regional databases.

Request parameters
Name Value/Type Description
type* phrase_all

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.

phrase* phrase

A keyword or keyword expression 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.

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.

export_columns Dt, Db, Ph, Nq, Cp, Co, Nr, In

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

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_all&key=YOUR_API_KEY&phrase=seo&export_columns=Dt,Db,Ph,Nq,Cp,Co,Nr

Response example

Date;Database;Keyword;Search Volume;CPC;Competition
201903;bo;seo;390;0.44;0.03
201903;hu;seo;1900;0.82;0.45
201903;th;seo;5400;0.96;0.49
201903;cr;seo;590;0.43;0.14

Keyword Overview (One database)

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

This report provides a summary of a keyword, including its volume, CPC, competition, and the number of results in a chosen regional database.

Request parameters
Name Value/Type Description
type* phrase_this

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.

phrase* phrase

A keyword or keyword expression 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 Ph, Nq, Cp, Co, Nr, Td, In

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

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_this&key=YOUR_API_KEY&phrase=seo&export_columns=Ph,Nq,Cp,Co,Nr,Td&database=us

Response example

Keyword;Search Volume;CPC;Competition;Number of Results;Trends
seo;110000;14.82;0.5;678000000;0.81,1.00,1.00,1.00,1.00,0.81,0.81,0.81,0.81,0.81,0.81,0.81

Batch Keyword Overview (One database)

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

This report provides a summary of up to 100 keywords, including its volume, CPC, competition, and the number of results in a chosen regional database.

Request parameters
Name Value/Type Description
type* phrase_these

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.

phrase* phrase

A keyword or keyword expression you'd like to investigate.

database* database

A regional database (one value from the list).

export_escape 1

1If 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 Ph, Nq, Cp, Co, Nr, Td, In

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

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_these&key=YOUR_API_KEY&phrase=ebay;seo&export_columns=Ph,Nq,Cp,Co,Nr,Td&database=us

Response example

Keyword;Search Volume;CPC;Competition;Number of Results
ebay;45500000;0.54;0.01;1880000000
seo;110000;14.82;0.5;678000000

Organic Results

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

This report lists domains that are ranking in Google's top 100 organic search results with a requested keyword.

Request parameters
Name Value/Type Description
type* phrase_organic

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.

phrase* phrase

A keyword or keyword expression 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.

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, Ur, Fk, Fp

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

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_organic&key=YOUR_API_KEY&phrase=seo&export_columns=Dn,Ur,Fk,Fp&database=us&display_limit=10

Response example

Domain;Url;Keywords SERP Features;SERP Features
moz.com;https://moz.com/beginners-guide-to-seo;1;6
moz.com;https://moz.com/learn/seo/what-is-seo;1;
searchengineland.com;https://searchengineland.com/guide/what-is-seo;1;
google.com;https://developers.google.com/search/docs/beginner/seo-starter-guide;1;6
neilpatel.com;https://neilpatel.com/what-is-seo/;1;
wikipedia.org;https://en.wikipedia.org/wiki/Search_engine_optimization;1;
wordstream.com;https://www.wordstream.com/seo;1;
wordstream.com;https://www.wordstream.com/blog/ws/2015/04/30/seo-basics;1;
ahrefs.com;https://ahrefs.com/blog/seo-basics/;1;
searchenginewatch.com;https://www.searchenginewatch.com/2016/01/21/seo-basics-22-essentials-you-need-for-optimizing-your-site/;1;
Price: 20 API units per line info
Historical price:
100 API units per line

This report lists domains that are ranking in Google's paid search results with a requested keyword.

Request parameters
Name Value/Type Description
type* phrase_adwords

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.

phrase* phrase

A keyword or keyword expression 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.

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, Ur, Vu

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

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_adwords&key=YOUR_API_KEY&phrase=seo&export_columns=Dn,Ur,Vu&database=us&display_limit=10

Response example

Domain;Url;Visible Url
wix.com;http://www.wix.com/;www.wix.com/
webcreationus.com;http://amp.webcreationus.com/google/seo;amp.webcreationus.com/google/seo
wix.com;http://www.wix.com/;www.wix.com/
wix.com;http://www.wix.com/;www.wix.com/
brunnerworks.com;http://www.brunnerworks.com/;www.brunnerworks.com/
wix.com;http://www.wix.com/;www.wix.com/
brunnerworks.com;http://www.brunnerworks.com/;www.brunnerworks.com/
wix.com;http://www.wix.com/;www.wix.com/
rankingcoach.com;http://www.rankingcoach.com/;www.rankingcoach.com/
hinadm.com;http://www.hinadm.com/;www.hinadm.com/
Price: 40 API units per line

This report provides an extended list of related keywords, synonyms, and variations relevant to a queried term in a chosen database.

Request parameters
Name Value/Type Description
type* phrase_related

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.

phrase* phrase

A keyword or keyword expression 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.

export_columns Ph, Nq, Cp, Co, Nr, Td, Rr, Fk, In

Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.

display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_as…
nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc, rr_asc, rr_desc

This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.

display_filter Ph, Nq, Cp, Co, Nr, Wc, Fk

Filters for columns.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_related&key=YOUR_API_KEY&phrase=seo&export_columns=Ph,Nq,Cp,Co,Nr,Td,Rr,Fk&database=us&display_limit=10&display_sort=nq_desc&display_filter=%2B|Nq|Lt|1000

Response example

Keyword;Search Volume;CPC;Competition;Number of Results;Trends;Related Relevance;SERP Features
beginners guide;880;0;0.01;1750000000;0.82,1.00,0.82,1.00,0.82,0.82,0.67,0.82,1.00,1.00,1.00,1.00;0.05;1,6,7,20,21
best po sites;880;0.14;0.38;1040000000;0.67,0.67,0.67,1.00,0.67,0.20,0.20,0.25,0.25,0.04,0.01,0.02;0.05;15,20,21
best seo;880;6.55;0.33;631000000;0.45,0.77,1.00,0.45,0.77,0.77,1.00,0.68,0.45,0.55,0.68,0.55;0.15;4,6,11,22
how seo works;880;3.93;0.28;164000000;0.55,1.00,0.77,0.77,0.68,0.45,0.45,0.45,0.45,0.45,0.77,0.68;0.15;6,11,20,21,22
how to improve seo;880;2.9;0.34;233000000;1.00,0.88,0.88,0.88,0.88,0.88,0.72,0.72,0.72,0.72,1.00,0.88;0.1;11,20,21
page two of google;880;0;0;7640000000;0.00,0.00,0.00,0.00,0.00,0.00,1.00,0.36,0.20,0.13,0.55,0.13;0.05;5,9,21
search e;880;2.3;0.1;24160000000;0.88,0.72,0.88,0.72,0.72,0.72,0.88,1.00,0.88,1.00,0.88,0.72;0.05;4,6,8
search engine optimization definition;880;5.2;0.09;29800000;0.88,0.88,1.00,0.72,0.39,0.39,0.59,0.88,1.00,0.88,0.88,0.88;0.45;0,1,6,15,20,21,22
seo for beginners;880;2.45;0.29;18500000;0.68,0.68,1.00,1.00,0.77,0.77,0.55,0.45,0.45,0.45,0.55,0.68;0.3;6,11,20,21,22
seo for dummies;880;1.93;0.98;2850000;0.68,1.00,1.00,0.68,0.77,0.68,0.68,0.68,0.55,0.55,0.77,0.68;0.05;1,6,7,20,21

Keyword Ads History

Price: 100 API units per line

This report shows domains that have bid on a requested keyword in the last 12 months and their positions in paid search results.

Request parameters
Name Value/Type Description
type* phrase_adwords_historical

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.

phrase* phrase

A keyword or keyword expression 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.

export_columns Dn, Dt, Po, Ur, Tt, Ds, Vu, At, Ac, Ad

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

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_adwords_historical&key=YOUR_API_KEY&display_limit=1&export_columns=Dn,Dt,Po,Ur,Tt,Ds,Vu&phrase=movie&database=us

Response example

Domain;Date;Position;Url;Title;Description;Visible Url
blendedmovie.com;20140515;1;47.xg4ken.com/media/redir.php%3Fprof%3D626%26camp%3D58398%26affcode%3Dkw599%26cid%3D36205335494%26networkType%3Dsearch%26kdv%3Dc%26url%5B%5D%3Dhttp%253A%252F%252Fblendedmovie.com%252F%2523home&ved=0CBoQ0Qw;Blended Movie - blendedmovie.com;A wildly different family vacation. Out 5/23. Buy Tickets Today!;www.blendedmovie.com/
blendedmovie.com;20140415;;;;;
blendedmovie.com;20140315;;;;;
blendedmovie.com;20140215;;;;;
blendedmovie.com;20140115;;;;;
blendedmovie.com;20131215;;;;;
blendedmovie.com;20131115;;;;;
blendedmovie.com;20131015;;;;;
blendedmovie.com;20130915;;;;;
blendedmovie.com;20130815;;;;;
blendedmovie.com;20130715;;;;;
blendedmovie.com;20130615;;;;;

Broad Match Keyword

Price: 20 API units per line

The report provides a list of broad matches and alternate search queries, including particular keywords or keyword expressions.

Request parameters
Name Value/Type Description
type* phrase_fullsearch

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.

phrase* phrase

A keyword or keyword expression 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.

export_columns Ph, Nq, Cp, Co, Nr, Td, Fk, In

Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.

display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_as…
nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc

This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.

display_filter Ph, Nq, Cp, Co, Nr, Wc, Fk

Filters for columns.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_fullsearch&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&phrase=seo&export_columns=Ph,Nq,Cp,Co,Nr,Td,Fk&database=us&display_limit=10&display_sort=nq_desc&display_filter=%2B|Nq|Lt|1000

Response example

Keyword;Search Volume;CPC;Competition;Number of Results;Trends;SERP Features
affordable seo;880;13.91;0.22;29900000;0.45,0.55,0.30,0.45,0.81,1.00,0.63,0.45,0.55,0.63,0.55,0.45;6,7,22
affordable seo services;880;15.67;0.11;24000000;0.37,0.55,0.25,0.25,0.68,1.00,1.00,0.68,1.00,1.00,0.55,0.45;6,11,15,22
arizona seo;880;6.05;0.02;15900000;0.72,0.72,0.88,0.59,1.00,0.88,1.00,1.00,0.88,0.88,0.59,0.59;3,20
atlanta seo expert;880;17.99;0.13;4090000;0.25,1.00,1.00,0.20,0.20,0.20,0.30,0.20,0.16,0.11,0.09,0.11;6,7,9,20
best seo;880;6.55;0.33;631000000;0.77,1.00,0.45,0.77,0.77,1.00,0.68,0.45,0.55,0.68,0.55,0.55;4,6,11,22
best seo plugin for wordpress;880;2.74;0.1;11700000;0.77,0.68,0.55,0.55,0.68,0.55,0.55,0.55,0.55,1.00,0.77,0.77;11,20,21,22
best seo plugin wordpress;880;3.09;0.09;12800000;0.68,0.68,0.77,0.68,0.55,0.55,0.68,0.55,0.55,0.55,0.55,1.00;11,20,21,22
boca raton seo;880;7.58;0.11;2770000;1.00,1.00,0.25,0.16,0.37,0.30,0.20,0.11,0.11,0.16,0.16,0.16;3,5,6,20
boston seo agency;880;15.21;0.1;8630000;0.20,1.00,1.00,0.07,0.06,0.13,0.16,0.11,0.07,0.09,0.07,0.07;3,5,20,22
boston seo expert;880;12.73;0.04;4380000;0.25,1.00,1.00,0.13,0.13,0.11,0.45,0.20,0.13,0.13,0.09,0.09;6,9,20,22

Phrase questions

Price: 40 API units per line

The report provides a list of phrase questions relevant to a queried term in a chosen database.

Request parameters
Name Value/Type Description
type* phrase_questions

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.

phrase* phrase

A keyword or keyword expression 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.

export_columns Ph, Nq, Cp, Co, Nr, Td, In

Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.

display_sort nq_asc, nq_desc, cp_asc, cp_desc, co_as…
nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc

This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.

display_filter Ph, Nq, Cp, Co, Nr

Filters for columns.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_questions&key=YOUR_API_KEY&phrase=seo&export_columns=Ph,Nq,Cp,Co,Nr,Td&database=us&display_limit=10&display_sort=nq_desc&display_filter=%2B|Nq|Lt|1000

Response example

Keyword;Search Volume;CPC;Competition;Number of Results;Trends
how to seo;880;5.23;0.16;611000000;0.88,1.00,1.00,1.00,0.88,0.88,0.88,0.88,0.88,0.88,0.88,0.88
how does seo work;590;3.6;0.09;183000000;0.67,0.82,0.82,1.00,0.82,0.82,0.82,0.82,0.82,0.82,1.00,0.67
how to improve seo;590;7.11;0.4;135000000;0.82,0.82,1.00,0.82,0.82,1.00,0.82,0.82,0.82,0.82,1.00,0.82
what is seo and how it works;590;5.69;0.18;188000000;0.44,0.54,0.82,1.00,1.00,0.67,0.54,0.67,0.67,0.82,1.00,1.00
how seo works;480;6.62;0.24;163000000;0.81,1.00,1.00,1.00,1.00,0.81,0.81,0.81,0.81,0.66,1.00,1.00
kim min seo;480;0;0;51100000;0.55,0.55,0.36,0.36,0.36,0.55,0.44,0.67,0.44,0.55,1.00,0.67
what is seo writing;480;2.16;0.12;158000000;0.66,1.00,0.66,0.81,1.00,1.00,0.81,1.00,1.00,1.00,0.81,0.66
how much does seo cost;390;7.44;0.31;80300000;0.81,0.81,0.81,0.81,0.81,1.00,0.81,0.67,0.67,0.67,0.81,0.67
kim seo hyung;390;0;0;9000000;0.54,0.67,0.54,0.54,0.54,1.00,0.81,0.81,0.67,0.67,0.81,1.00
ko seo hyun;390;0;0.01;0;0.04,0.06,0.07,0.07,0.04,0.13,0.30,0.09,0.81,1.00,0.45,0.13

Keyword Difficulty

Price: 50 API units per line

This report provides keyword difficulty, an index that helps to estimate how difficult it would be to seize competitors' positions in organic search within the Google's top 100 with an indicated search term.

Request parameters
Name Value/Type Description
type* phrase_kdi

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.

phrase* phrase

Phrase (from 1 to 100 keywords separated by semicolons)

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_columns Ph, Kd

Ph, KdRequired 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

https://api.semrush.com/

Request example

https://api.semrush.com/?type=phrase_kdi&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&export_columns=Ph,Kd&phrase=ebay;seo&database=us

Response example

Keyword;Keyword Difficulty Index

ebay;95.10

seo;78.35