{"id":1488,"date":"2019-11-27T14:49:21","date_gmt":"2019-11-27T14:49:21","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=1488"},"modified":"2025-04-23T13:08:40","modified_gmt":"2025-04-23T13:08:40","slug":"keywords-data-overview","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/keywords-data-overview\/","title":{"rendered":"keywords_data\/overview"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h1 id=\"introduction\">Keywords Data API: Overview<\/h1>\n    <div class=\"endpoint\">\n        <img decoding=\"async\" class=\"endpoint__icon\" src=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/checked-circle.svg\" alt=\"checked\">\n\n                    This API is the ultimate source of data for keyword analysis            <\/div>\n    \n<p><strong>Keywords Data API<\/strong> encompasses two datasources (Google and Bing) working with a broad range of endpoints:<\/p>\n<div style=\"width: 90%; margin-left: auto; margin-right: auto;\">\n<div class=\"wpb_column vc_column_container vc_col-lg-4 vc_col-md-6 vc_col-sm-1\">\n<ul>\n<li><strong>Google<\/strong><\/li>\n<li><a href=\"\/v3\/keywords_data\/google_ads\/search_volume\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Search Volume<\/a><\/li>\n<li><a href=\"\/v3\/keywords_data\/google_ads\/keywords_for_site\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Keywords For Site<\/a><\/li>\n<li><a href=\"\/v3\/keywords_data\/google_ads\/keywords_for_keywords\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Keywords For Keywords<\/a><\/li>\n<li><a href=\"\/v3\/keywords_data\/google_ads\/ad_traffic_by_keywords\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Ad Traffic By Keywords<\/a><\/li>\n<li><a href=\"\/v3\/keywords_data\/google_trends\/explore\/task_post\/\" target=\"_blank\" rel=\"noopener noreferrer\">Google Trends Explore<\/a><\/li>\n<\/ul>\n<\/div>\n<div class=\"wpb_column vc_column_container vc_col-lg-4 vc_col-md-6 vc_col-sm-1\">\n<ul>\n<li><strong>Bing<\/strong><\/li>\n<li><a href=\"\/v3\/keywords_data\/bing\/search_volume\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Search Volume<\/a><\/li>\n<li><a href=\"\/v3\/keywords_data\/bing\/keywords_for_site\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Keywords For Site<\/a><\/li>\n<li><a href=\"\/v3\/keywords_data\/bing\/keywords_for_keywords\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Keywords For Keywords<\/a><\/li>\n<li><a href=\"\/v3\/keywords_data\/bing\/keyword_performance\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Keyword Performance<\/a><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<\/div>\n<\/div>\n<h4 style=\"color: #f44336; margin-bottom: 15px;\">Note that Google Ads Keywords Data API is based on the latest version of the <a href=\"https:\/\/developers.google.com\/google-ads\/api\/docs\/start\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads API<\/a> that has replaced legacy Google AdWords API. If you\u2019re using <a href=\"\/v3\/keywords_data\/google\/overview\/?bash\" target=\"_blank\" rel=\"noopener noreferrer\">DataForSEO Google AdWords API<\/a>, you need to upgrade to <a href=\"\/v3\/keywords_data\/google_ads\/overview\/?bash\" target=\"_blank\" rel=\"noopener noreferrer\">DataForSEO Google Ads API<\/a>.<\/h4>\n<p>You can get the full list of available endpoints <a href=\"\/v3\/keywords_data\/endpoints\/\" target=\"_blank\" rel=\"noopener noreferrer\">here<\/a>. The returned results are specific to the indicated language, location, and other endpoint-specific parameters.<\/p>\n<p>The restrictions of Google and Bing endpoints of Keywords Data API are related to <a href=\"https:\/\/support.google.com\/adspolicy\/answer\/6014299?hl=en\/\" target=\"_blank\" rel=\"noopener noreferrer\">Google Advertising Policy<\/a> and <a href=\"https:\/\/about.ads.microsoft.com\/en-us\/resources\/policies\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft Advertising Ad Policies and Guidelines<\/a> accordingly. Consequently, we are not able to return data for keywords that fall into such categories as weapons, tobacco, drugs, violence, terrorism, etc. If you want to learn more about Google restrictions and prohibited categories, <a href=\"https:\/\/dataforseo.com\/google-restrictions-explained-why-you-do-not-get-any-search-volume-for-your-queries.html\" target=\"_blank\" rel=\"noopener noreferrer\">check the article on our blog.<\/a><\/p>\n<p>Please note that if you post, for instance, 100 keywords in a batch and at least one of them falls into one of the categories listed above, no data will be retrieved for the whole batch of keywords.<\/p>\n<p>To find answers on common questions about Keywords Data API and find guidance on efficient use of its features, <a href=\"https:\/\/dataforseo.com\/help-center\/category\/keyword-data-api\" target=\"_blank\" rel=\"noopener noreferrer\">visit our Help Center.<\/a><\/p>\n<h3>Methods<\/h3>\n<p>The cost of using Keywords Data endpoints depends on the selected method and priority of task execution. Available methods and priorities are described below.<\/p>\n<p>DataForSEO has two main methods to deliver the results: Standard and Live.<\/p>\n<p>If your system requires delivering instant results, <strong>the Live method<\/strong> is the best solution for you. Unlike the Standard method, this method doesn\u2019t require making separate POST and GET requests to the corresponding endpoints.<\/p>\n<p>If you don\u2019t need to receive data in real-time, you can use <strong>the Standard method<\/strong> of data retrieval. This method requires making separate POST and GET requests, but it\u2019s more affordable. Using this method, you can retrieve the results after our system collects them.<\/p>\n<p>\u200cAlternatively, you can specify <code>pingback_url<\/code> or <code>postback_url<\/code> when setting a task, and we will notify you on completion of tasks or send them to you respectively.<\/p>\n<p>If you need to set several tasks, you can receive the list of <code>id<\/code> for all completed tasks using <strong>&#8216;Tasks Ready&#8217; endpoint,<\/strong> and then collect the results of each separate task using &#8216;Task GET&#8217; endpoint.<br \/>\n\u200c<br \/>\nYou can send up to 2000 API calls per minute. Contact us if you would like to raise the limit.<\/p>\n<p><span style=\"font-weight: 400;\">Visit <\/span><a href=\"https:\/\/dataforseo.com\/help-center\/best-practices-for-handling-keywords-data-api-requests\" target=\"_blank\" rel=\"noopener noreferrer\"><span style=\"font-weight: 400;\">DataForSEO Help Center<\/span><\/a><span style=\"font-weight: 400;\"> to get practical tips for request handling depending on your Keyword Data API payload volume.<\/span><\/p>\n<h3>Cost<\/h3>\n<p>The price depends on the method of data retrieval. The cost can be calculated on the <a title=\"Pricing\" href=\"https:\/\/dataforseo.com\/pricing\/keywords-data\" target=\"_blank\" rel=\"noopener noreferrer\">Pricing<\/a> page. You can check your spending in your <a href=\"https:\/\/app.dataforseo.com\/api-access\" target=\"_blank\" rel=\"noopener noreferrer\">account dashboard<\/a> or by making a separate call to <a href=\"\/v3\/appendix\/user_data\/?php\" target=\"_blank\" rel=\"noopener noreferrer\">the User Data endpoint<\/a><\/p>\n<p>You can test Keywords Data API for free using DataForSEO <a href=\"\/v3\/appendix\/sandbox\/\">Sandbox.<\/a><br \/>\n[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>[vc_row][vc_column][vc_column_text] Keywords Data API: Overview This API is the ultimate source of data for keyword analysis Keywords Data API encompasses two datasources (Google and Bing) working with a broad range of endpoints: Google Search Volume Keywords For Site Keywords For Keywords Ad Traffic By Keywords Google Trends Explore Bing Search Volume Keywords For Site Keywords [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","footnotes":""},"class_list":["post-1488","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/1488","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=1488"}],"version-history":[{"count":48,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/1488\/revisions"}],"predecessor-version":[{"id":21460,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/1488\/revisions\/21460"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=1488"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}