Keyword reports

Jump to Keyword Overview (all databases)Keyword Overview (all databases)

Price: 10 API units per line

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

About the Keyword Overview report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_all

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

database

Regional database. If this parameter isn’t specified, your request is sent to all regional databases.

For details, refer to Databases.

Value/Type: database

export_escape

If this parameter uses the value 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

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.

Value/Type: 1 or 0

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Dt, Db, Ph, Nq, Cp, Co).

For details, refer to Columns.

Value/Type: Dt, Db, Ph, Nq, Cp, Co, Nr, In, Kd

Request example
https://api.semrush.com/?type=phrase_all&key=API_KEY&phrase=seo&export_columns=Dt,Db,Ph,Nq,Cp,Co,Nr
Response exampleCSV
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

Jump to Keyword Overview (one database)Keyword Overview (one database)

Price: 10 API units per line

Price for historical data: 50 API units per line

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

About the Keyword Overview report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_this

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

export_escape

If this parameter uses the value 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

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.

Value/Type: 1 or 0

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

For example, for December 2023, set this parameter to 20231215. If you want to get the most recent data, don’t use this parameter or leave the value empty.

Value/Type: date in format "YYYYMM15"

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Ph, Nq, Cp, Co, Nr).

For details, refer to Columns.

Value/Type: Ph, Nq, Cp, Co, Nr, Td, In, Kd

Request example
https://api.semrush.com/?type=phrase_this&key=API_KEY&phrase=seo&export_columns=Ph,Nq,Cp,Co,Nr,Td&database=us
Response exampleCSV
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

Jump to Batch Keyword Overview (one database)Batch Keyword Overview (one database)

Price: 10 API units per line

Price for historical data: 50 API units per line

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

About the bulk keyword analysis in Keyword Overview ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_these

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

export_escape

If this parameter uses the value 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

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.

Value/Type: 1 or 0

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

For example, for December 2023, set this parameter to 20231215. If you want to get the most recent data, don’t use this parameter or leave the value empty.

Value/Type: date in format "YYYYMM15"

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Ph, Nq, Cp, Co, Nr, Td).

For details, refer to Columns.

Value/Type: Ph, Nq, Cp, Co, Nr, Td, In, Kd

Request example
https://api.semrush.com/?type=phrase_these&key=API_KEY&phrase=ebay;seo&export_columns=Ph,Nq,Cp,Co,Nr,Td&database=us
Response exampleCSV
Keyword;Search Volume;CPC;Competition;Number of Results
ebay;45500000;0.54;0.01;1880000000
seo;110000;14.82;0.5;678000000

Jump to Organic ResultsOrganic Results

Price: 10 API units per line

Price for historical data: 50 API units per line

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

About the keyword organic value analysis in Keyword Overview ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_organic

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

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.

When using the positions_type parameter in the “all” type, the number of results returned by the request is limited by positions, not by rows.

The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.

Value/Type: integer

display_offset

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

Keep in mind 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.

Value/Type: integer

export_escape

If this parameter uses the value 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

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.

Value/Type: 1 or 0

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

For example, for December 2023, set this parameter to 20231215. If you want to get the most recent data, don’t use this parameter or leave the value empty.

Value/Type: date in format "YYYYMM15"

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Dn, Ur, Fk).

For details, refer to Columns.

Value/Type: Po, Pt, Dn, Ur, Fk, Fp, Fl

positions_type

The organic value indicates results with only the traditional organic positions on the SERP. This is the default value.

The all vale indicates results that contain the traditional organic positions and the SERP Features as positions. In that case, the Pt column will return -1 for the organic or SERP feature code.

Value/Type: organic, all

Request example
https://api.semrush.com/?type=phrase_organic&key=API_KEY&phrase=seo&export_columns=Dn,Ur,Fk,Fp&database=us&display_limit=10
Response exampleCSV
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

Price for historical data: 100 API units per line

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

About the keyword advertising value analysis in Keyword Overview ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_adwords

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

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.

Value/Type: integer

display_offset

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

Keep in mind 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.

Value/Type: integer

export_escape

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

Value/Type: 1

export_decode

If this parameter is set to 0, the response will be sent as a URL-encoded string; if it’s set to 1, the response will not be converted.

Value/Type: 1 or 0

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

For example, for December 2023, set this parameter to 20231215. If you want to get the most recent data, don’t use this parameter or leave the value empty.

Value/Type: date in the "YYYYMM15" format

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Dn, Vu).

For details, refer to Columns.

Value/Type: Dn, Ur, Vu

Request example
https://api.semrush.com/?type=phrase_adwords&key=API_KEY&phrase=seo&export_columns=Dn,Ur,Vu&database=us&display_limit=10
Response exampleCSV
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.

About the related keyword analysis in Keyword Overview ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_related

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

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.

Value/Type: integer

display_offset

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

Keep in mind 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.

Value/Type: integer

export_escape

If this parameter uses the value 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

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.

Value/Type: 1 or 0

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Ph, Nr, Cp, Co, Nq, Td, Rr).

For details, refer to Columns.

Value/Type: Ph, Nq, Cp, Co, Nr, Td, Rr, Fk, In, Kd

display_sort

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

For details, refer to Sortings.

Value/Type: nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc, rr_asc, rr_desc, kd_asc, kd_desc

display_filter

Filters for columns.

For details, refer to Filters.

Value/Type: Ph, Nq, Cp, Co, Nr, Wc, Fk, Kd

Request example
https://api.semrush.com/?type=phrase_related&key=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 exampleCSV
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

Jump to Keyword Ads HistoryKeyword 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.

About the keyword advertising value analysis in Keyword Overview ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_adwords_historical

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

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.

Value/Type: integer

display_offset

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

Keep in mind 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.

Value/Type: integer

export_escape

If this parameter uses the value 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

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.

Value/Type: 1 or 0

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Dn, Ad, At, Ac, Dt, Po, Ur, Tt, Vu).

For details, refer to Columns.

Value/Type: Dn, Dt, Po, Ur, Tt, Ds, Vu, At, Ac, Ad

Request example
https://api.semrush.com/?type=phrase_adwords_historical&key=API_KEY&display_limit=1&export_columns=Dn,Dt,Po,Ur,Tt,Ds,Vu&phrase=movie&database=us
Response exampleCSV
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;;;;;

Jump to Broad Match KeywordBroad Match Keyword

Price: 20 API units per line

The report lists broad matches and alternate search queries, including particular keywords or keyword expressions.

About the related keyword analysis in Keyword Overview ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_fullsearch

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

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.

Value/Type: integer

display_offset

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

Keep in mind 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.

Value/Type: integer

export_escape

If this parameter uses the value 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

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.

Value/Type: 1 or 0

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Ph, Nr, Cp, Co, Nq, Td).

For details, refer to Columns.

Value/Type: Ph, Nq, Cp, Co, Nr, Td, Fk, In, Kd

display_sort

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

For details, refer to Sortings.

Value/Type: nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc, kd_asc, kd_desc

display_filter

Filters for columns.

For details, refer to Filters.

Value/Type: Ph, Nq, Cp, Co, Nr, Wc, Fk, Kd

Request example
https://api.semrush.com/?type=phrase_fullsearch&key=API_KEY&phrase=seo&export_columns=Ph,Nq,Cp,Co,Nr,Td,Fk,In&database=us&display_limit=10&display_sort=nq_desc&display_filter=%2B|Nq|Lt|1000
Response exampleCSV
Keyword;Search Volume;CPC;Competition;Number of Results;Trends;SERP Features;Intent
actor lee seo jin;880;0;0;20900000;0.24,0.16,0.16,0.30,0.34,0.44,0.20,0.16,0.13,0.44,0.07,1.00;5,9,13,21,36;1
affordable seo packages;880;8.09;0.01;51100000;0.46,0.31,0.37,0.31,0.25,0.20,0.31,0.52,0.52,0.46,0.52,0.84;6,7,20,21,36,45,52;1
affordable seo services for small businesses;880;9.81;0.03;28200000;0.13,0.30,0.24,0.36,0.30,0.45,0.81,0.62,1.00,0.81,0.62,0.55;5,6,7,9,21,36,52;1
ahn seo-hyun;880;0;0;89;0.55,0.62,0.55,0.55,0.62,0.62,0.01,0.24,0.55,0.62,0.81,1.00;21,36;1
ai seo tool;880;6.63;0.3;162000000;0.20,0.16,0.65,0.08,0.20,1.00,0.44,0.24,0.11,0.24,0.11,0.13;6,7,9,21,36,38,52;1,0
amazon seo optimization;880;8.09;0.1;23700000;0.36,0.67,0.55,0.67,1.00,0.36,0.55,0.45,1.00,0.76,0.67,0.55;6,9,21,36,45;1
artificial intelligence seo;880;5.57;0.4;0;0.16,0.36,0.16,0.13,0.08,0.36,0.10,0.27,0.10,0.16,0.07,1.00;6,7,20,21,36,43,52;1
booster seo;880;8.37;0.12;141000000;0.31,0.08,1.00,0.46,0.68,0.13,0.25,0.00,0.84,0.02,0.52,0.84;6,7,9,21,36;1
cheap seo;880;11.21;0.04;73100000;0.55,0.67,0.76,0.55,0.36,0.55,0.36,0.45,0.76,0.76,1.00,0.76;6,7,9,20,21,36;1
cheap seo services;880;8.7;0.04;22800000;0.55,0.67,0.76,0.45,0.36,0.45,0.76,0.67,0.76,1.00,0.45,1.00;3,6,7,9,21,36,45;0

Jump to Phrase questionsPhrase questions

Price: 40 API units per line

The report lists phrase questions relevant to a queried term in a chosen database.

About the related keyword analysis in Keyword Overview ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_questions

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Keyword or keyword expression you’d like to investigate.

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

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.

Value/Type: integer

display_offset

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

Keep in mind 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.

Value/Type: integer

export_escape

If this parameter value is 1, the report’s columns are wrapped in double quotation marks (”).

Value/Type: 1

export_decode

If this parameter value is 0, the response is sent as a URL-encoded string. If it’s 1, the response isn’t converted.

Value/Type: 1 or 0

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Ph, Nr, Cp, Co, Nq, Td).

For details, refer to Columns.

Value/Type: Ph, Nq, Cp, Co, Nr, Td, In, Kd

display_sort

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

For details, refer to Sortings.

Value/Type: nq_asc, nq_desc, cp_asc, cp_desc, co_asc, co_desc, nr_asc, nr_desc, kd_asc, kd_desc

display_filter

Filters for columns.

For details, refer to Filters.

Value/Type: Ph, Nq, Cp, Co, Nr, Kd

Request example
https://api.semrush.com/?type=phrase_questions&key=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 exampleCSV
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

Jump to Keyword DifficultyKeyword 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 Google’s top 10 with a queried search term.

Learn more about keyword difficulty ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: phrase_kdi

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

phraseRequired

Phrase (from 1 to 100 keywords separated by semicolons).

Value/Type: phrase

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

export_escape

If this parameter uses the value 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_columns

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (Ph, Kd).

For details, refer to Columns.

Value/Type: Ph, Kd

Request example
https://api.semrush.com/?type=phrase_kdi&key=API_KEY&export_columns=Ph,Kd&phrase=ebay;seo&database=us
Response exampleCSV
Keyword;Keyword Difficulty Index

ebay;95.10

seo;78.35

Last updated: January 26, 2026

Was this page helpful?