{"id":6010,"date":"2022-03-21T11:07:22","date_gmt":"2022-03-21T10:07:22","guid":{"rendered":"https:\/\/help.marketingminer.com\/?post_type=kb&#038;p=6010"},"modified":"2026-03-09T09:34:14","modified_gmt":"2026-03-09T08:34:14","slug":"keyword-suggestions-api","status":"publish","type":"kb","link":"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/","title":{"rendered":"Keyword Suggestions API"},"content":{"rendered":"\n<p>The Marketing Miner database contains a large number of keywords for multiple countries (listed below). Thanks to our API and large database, you can quickly analyze data in bulk and find keyword suggestions for queries searched in different countries.&nbsp;<\/p>\n\n\n\n<div class=\"center1\"><a href=\"https:\/\/colab.research.google.com\/drive\/1wwMTg51KkJ-W7boP6liG7HvTD3Vl3d7r?usp=sharing\" target=\"_blank\" rel=\"noopener noreferrer\"><button class=\"test\">\ud83d\udcca View API script example usage<\/button><\/a><\/div>\n\n\n\n<p><\/p>\n\n\n\n<p>Current statistics of the Marketing Miner\u2019s keyword database:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Country<\/strong><\/td><td><strong>Number of searched keywords in DBS<\/strong><\/td><\/tr><tr><td>United States (US)<\/td><td>163,732,422<\/td><\/tr><tr><td>United Kingdom (UK)<\/td><td>150,777,045<\/td><\/tr><tr><td>Czech Republic<\/td><td>38,449,748<\/td><\/tr><tr><td>Poland<\/td><td>26,791,197<\/td><\/tr><tr><td>Slovakia<\/td><td>7,761,013<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2>Keyword Suggestions API common uses&nbsp;<\/h2>\n\n\n\n<ul>\n<li>Collecting data for keyword research<\/li>\n\n\n\n<li>Creating content clusters for new content&nbsp;<\/li>\n<\/ul>\n\n\n\n<h2>API documentation<\/h2>\n\n\n\n<pre class=\"wp-block-preformatted\"><a href=\"https:\/\/profilers-api.marketingminer.com\/docs#\/keywords\/Keywords_suggestions_list_keywords_suggestions_get\">https:\/\/profilers-api.marketingminer.com\/docs#\/keywords\/Keywords_suggestions_list_keywords_suggestions_get<\/a><\/pre>\n\n\n\n<h3>API Endpoint URL<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\"><a href=\"https:\/\/profilers-api.marketingminer.com\/keywords\/suggestions\">https:\/\/profilers-api.marketingminer.com\/keywords\/suggestions<\/a><\/pre>\n\n\n\n<h3>Required parameters<\/h3>\n\n\n\n<ul>\n<li><strong>api_token<\/strong> &#8211; Your API key. You can generate your API key after upgrading to any paid subscription plan with at least 1 million credits (Digger, Machine or Custom plans). To get an API key, navigate to the <a href=\"https:\/\/www.marketingminer.com\/cs\/settings\/api\">user profile<\/a> section.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"505\" src=\"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2021\/10\/api-keys-in-marketing-miner-1024x505.png\" alt=\"API token (key) in user_profile\" class=\"wp-image-5711\" srcset=\"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2021\/10\/api-keys-in-marketing-miner-1024x505.png 1024w, https:\/\/help.marketingminer.com\/wp-content\/uploads\/2021\/10\/api-keys-in-marketing-miner-300x148.png 300w, https:\/\/help.marketingminer.com\/wp-content\/uploads\/2021\/10\/api-keys-in-marketing-miner-768x378.png 768w, https:\/\/help.marketingminer.com\/wp-content\/uploads\/2021\/10\/api-keys-in-marketing-miner-150x74.png 150w, https:\/\/help.marketingminer.com\/wp-content\/uploads\/2021\/10\/api-keys-in-marketing-miner.png 1167w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul>\n<li><strong>lang<\/strong> &#8211; Enter the country for which you want to obtain data (currently available: us, gb, cs, sk, pl).<\/li>\n\n\n\n<li><strong>keyword<em> <\/em><\/strong>&#8211; Add the keyword for which you want to retrieve data.&nbsp;<\/li>\n<\/ul>\n\n\n\n<h3>Example request&nbsp;&nbsp;<\/h3>\n\n\n\n<ul>\n<li><img decoding=\"async\" src=\"https:\/\/lh6.googleusercontent.com\/9JNYQLFKqWpsG9GkNrDQXcUCtDlPoZAkN-VTBZhPMomxCe6_yhDllI-H5_JpIkPAAv-6FiuQsBmaHDFcpsAfpbt651v1BrgYIptojadR5U_Bx-IjYZN5XynlC0hUhUHVNA-Coa2L\" style=\"width: 20px;\"><a href=\"https:\/\/colab.research.google.com\/drive\/1wwMTg51KkJ-W7boP6liG7HvTD3Vl3d7r?usp=sharing\" target=\"_blank\" rel=\"noreferrer noopener\">&nbsp;Python<\/a><\/li>\n\n\n\n<li>PHP (TBC)<\/li>\n<\/ul>\n\n\n\n<p><\/p>\n\n\n\n<p><strong>Sample keyword suggestions endpoint URL <\/strong>(just add your API key):<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><a href=\"https:\/\/profilers-api.marketingminer.com\/keywords\/suggestions?lang=us&amp;keyword=seo&amp;api_token=[API_TOKEN]\">https:\/\/profilers-api.marketingminer.com\/keywords\/suggestions?lang=us&amp;keyword=seo&amp;api_token=[API_TOKEN]<\/a><\/pre>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"665\" height=\"863\" src=\"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2022\/03\/keyword-suggestions-api-output.png\" alt=\"Keyword Suggestions API output\" class=\"wp-image-5987\" srcset=\"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2022\/03\/keyword-suggestions-api-output.png 665w, https:\/\/help.marketingminer.com\/wp-content\/uploads\/2022\/03\/keyword-suggestions-api-output-231x300.png 231w, https:\/\/help.marketingminer.com\/wp-content\/uploads\/2022\/03\/keyword-suggestions-api-output-150x195.png 150w\" sizes=\"(max-width: 665px) 100vw, 665px\" \/><\/figure><\/div>\n\n\n<h3>Limits and prices<\/h3>\n\n\n\n<p>Each API request will cost you credits. We also limited the speed of sending queries to ensure the continuous operation of our APIs for all clients.&nbsp;<\/p>\n\n\n\n<ul>\n<li>API restriction: 60 keywords per minute<\/li>\n\n\n\n<li>API price: 10 credits per keyword&nbsp;<\/li>\n<\/ul>\n\n\n\n<h2>Keyword Suggestions API use cases<\/h2>\n\n\n\n<p><em>* There is currently no content for this section.<\/em>&nbsp;<\/p>\n\n\n<div class=\"mkb-shortcode-container\">        <div class=\"mkb-tip\">\n            <div class=\"mkb-tip__icon\">\n                <i class=\"fa fa-lg fa-lightbulb-o\"><\/i>\n            <\/div>\n            <div class=\"mkb-tip__content\">\n                <strong>INFO: <\/strong>Please get in touch if you want to share examples of how you automatize your keyword research with the Keyword Suggestions API that might be of help to others. Email us at\u00a0 <a href=\"mailto:info@marketingminer.com\">info@marketingminer.com<\/a>, and we will be happy to add your usage examples.            <\/div>\n        <\/div>\n        <\/div>","protected":false},"excerpt":{"rendered":"<p>The Marketing Miner database contains a large number of keywords for multiple countries (listed below). Thanks to our API and large database, you can quickly analyze data in bulk and find keyword suggestions for queries searched in different countries.&nbsp; &eth;&#159;&#147;&#138; View API script example usage Current statistics of the Marketing Miner&rsquo;s keyword database: Country Number &#8230; <a title=\"Keyword Suggestions API\" class=\"read-more\" href=\"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/\" aria-label=\"More on Keyword Suggestions API\">Read more<\/a><\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":[],"kbtopic":[114,49],"kbtag":[90,84],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v20.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Keyword Suggestions API - Marketing Miner Knowledge Base<\/title>\n<meta name=\"description\" content=\"The Marketing Miner database contains a large number of keywords for multiple countries (listed below). Thanks to our API and large database, you can\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Keyword Suggestions API - Marketing Miner Knowledge Base\" \/>\n<meta property=\"og:description\" content=\"The Marketing Miner database contains a large number of keywords for multiple countries (listed below). Thanks to our API and large database, you can\" \/>\n<meta property=\"og:url\" content=\"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/\" \/>\n<meta property=\"og:site_name\" content=\"Marketing Miner Knowledge Base\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/marketingminer\/\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-09T08:34:14+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2022\/03\/keyword-suggestions-api.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1428\" \/>\n\t<meta property=\"og:image:height\" content=\"802\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:image\" content=\"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2022\/03\/keyword-suggestions-api.png\" \/>\n<meta name=\"twitter:site\" content=\"@marketingminer\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/\",\"url\":\"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/\",\"name\":\"Keyword Suggestions API - Marketing Miner Knowledge Base\",\"isPartOf\":{\"@id\":\"https:\/\/help.marketingminer.com\/en\/#website\"},\"datePublished\":\"2022-03-21T10:07:22+00:00\",\"dateModified\":\"2026-03-09T08:34:14+00:00\",\"description\":\"The Marketing Miner database contains a large number of keywords for multiple countries (listed below). Thanks to our API and large database, you can\",\"breadcrumb\":{\"@id\":\"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/help.marketingminer.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Keyword Suggestions API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/help.marketingminer.com\/en\/#website\",\"url\":\"https:\/\/help.marketingminer.com\/en\/\",\"name\":\"Marketing Miner Knowledge Base\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/help.marketingminer.com\/en\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/help.marketingminer.com\/en\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/help.marketingminer.com\/en\/#organization\",\"name\":\"Marketing Miner\",\"url\":\"https:\/\/help.marketingminer.com\/en\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/help.marketingminer.com\/en\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2020\/06\/cropped-Logo-01@3x.png\",\"contentUrl\":\"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2020\/06\/cropped-Logo-01@3x.png\",\"width\":4098,\"height\":819,\"caption\":\"Marketing Miner\"},\"image\":{\"@id\":\"https:\/\/help.marketingminer.com\/en\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/marketingminer\/\",\"https:\/\/twitter.com\/marketingminer\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Keyword Suggestions API - Marketing Miner Knowledge Base","description":"The Marketing Miner database contains a large number of keywords for multiple countries (listed below). Thanks to our API and large database, you can","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/","og_locale":"en_US","og_type":"article","og_title":"Keyword Suggestions API - Marketing Miner Knowledge Base","og_description":"The Marketing Miner database contains a large number of keywords for multiple countries (listed below). Thanks to our API and large database, you can","og_url":"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/","og_site_name":"Marketing Miner Knowledge Base","article_publisher":"https:\/\/www.facebook.com\/marketingminer\/","article_modified_time":"2026-03-09T08:34:14+00:00","og_image":[{"width":1428,"height":802,"url":"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2022\/03\/keyword-suggestions-api.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_image":"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2022\/03\/keyword-suggestions-api.png","twitter_site":"@marketingminer","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/","url":"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/","name":"Keyword Suggestions API - Marketing Miner Knowledge Base","isPartOf":{"@id":"https:\/\/help.marketingminer.com\/en\/#website"},"datePublished":"2022-03-21T10:07:22+00:00","dateModified":"2026-03-09T08:34:14+00:00","description":"The Marketing Miner database contains a large number of keywords for multiple countries (listed below). Thanks to our API and large database, you can","breadcrumb":{"@id":"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/help.marketingminer.com\/en\/article\/keyword-suggestions-api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/help.marketingminer.com\/en\/"},{"@type":"ListItem","position":2,"name":"Keyword Suggestions API"}]},{"@type":"WebSite","@id":"https:\/\/help.marketingminer.com\/en\/#website","url":"https:\/\/help.marketingminer.com\/en\/","name":"Marketing Miner Knowledge Base","description":"","publisher":{"@id":"https:\/\/help.marketingminer.com\/en\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/help.marketingminer.com\/en\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/help.marketingminer.com\/en\/#organization","name":"Marketing Miner","url":"https:\/\/help.marketingminer.com\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/help.marketingminer.com\/en\/#\/schema\/logo\/image\/","url":"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2020\/06\/cropped-Logo-01@3x.png","contentUrl":"https:\/\/help.marketingminer.com\/wp-content\/uploads\/2020\/06\/cropped-Logo-01@3x.png","width":4098,"height":819,"caption":"Marketing Miner"},"image":{"@id":"https:\/\/help.marketingminer.com\/en\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/marketingminer\/","https:\/\/twitter.com\/marketingminer"]}]}},"_links":{"self":[{"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/kb\/6010"}],"collection":[{"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/kb"}],"about":[{"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/types\/kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/comments?post=6010"}],"version-history":[{"count":9,"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/kb\/6010\/revisions"}],"predecessor-version":[{"id":11529,"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/kb\/6010\/revisions\/11529"}],"wp:attachment":[{"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/media?parent=6010"}],"wp:term":[{"taxonomy":"kbtopic","embeddable":true,"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/kbtopic?post=6010"},{"taxonomy":"kbtag","embeddable":true,"href":"https:\/\/help.marketingminer.com\/en\/wp-json\/wp\/v2\/kbtag?post=6010"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}