Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 6: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 - 6:00 PM (EST/EDT)
Monday - Friday
This report provides a summary of a keyword, including its volume, CPC, competition, and the number of results in all regional databases.
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, Kd | 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=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
This report provides a summary of a keyword, including its volume, CPC, competition, and the number of results in a chosen regional database.
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, Kd | 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=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
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.
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, Kd | 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=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
This report lists domains that are ranking in Google's top 100 organic search results with a requested keyword.
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
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;
This report lists domains that are ranking in Google's paid search results with a requested keyword.
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
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/
This report provides an extended list of related keywords, synonyms, and variations relevant to a queried term in a chosen database.
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 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, Kd | 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, kd_asc, kd_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, Kd | Filters for columns. |
* Fields marked by an asterisk (*) are required
Endpoint
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
This report shows domains that have bid on a requested keyword in the last 12 months and their positions in paid search results.
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 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
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;;;;;
The report provides a list of broad matches and alternate search queries, including particular keywords or keyword expressions.
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 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, Kd | 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, kd_asc, kd_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, Kd | Filters for columns. |
* Fields marked by an asterisk (*) are required
Endpoint
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
The report provides a list of phrase questions relevant to a queried term in a chosen database.
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 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, Kd | 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, kd_asc, kd_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, Kd | Filters for columns. |
* Fields marked by an asterisk (*) are required
Endpoint
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
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.
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
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