{"id":11207,"date":"2021-10-27T12:57:20","date_gmt":"2021-10-27T12:57:20","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=11207"},"modified":"2025-10-28T11:33:54","modified_gmt":"2025-10-28T11:33:54","slug":"keywords_data-google_ads-overview","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/keywords_data-google_ads-overview\/","title":{"rendered":"keywords_data\/google_ads\/overview"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h1 id=\"introduction\">Google Ads 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>Using <strong>Google Ads Keywords Data API<\/strong> you can:<\/p>\n<div style=\"width: 90%; padding: 0 28px; box-sizing: border-box;\">\n<ul>\n<li>Get <a href=\"\/v3\/keywords_data\/google_ads\/search_volume\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Search Volume<\/a> and other metrics for up to 1000 keywords<\/li>\n<li>Indicate a domain and obtain up to 2000 <a href=\"\/v3\/keywords_data\/google_ads\/keywords_for_site\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Keywords For Site<\/a><\/li>\n<li>Specify up to 20 terms and get up to 20,000 <a href=\"\/v3\/keywords_data\/google_ads\/keywords_for_keywords\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Keywords For Keywords<\/a><\/li>\n<li style=\" margin-bottom: 15px;\">Get impressions, CPC, and clicks for up to 1000 terms with <a href=\"\/v3\/keywords_data\/google_ads\/ad_traffic_by_keywords\/live\/\" target=\"_blank\" rel=\"noopener noreferrer\">Ad Traffic By Keywords<\/a><\/li>\n<\/ul>\n<\/div>\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 parameters indicated in the POST request. We use <a href=\"https:\/\/developers.google.com\/google-ads\/api\/docs\/start\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads API<\/a> as a data source. Thus, the locations supported in Google Ads Keyword Data API are identical to <a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/data\/geotargets\" target=\"_blank\" rel=\"noopener noreferrer\">Google Geographical Targeting.<\/a><\/p>\n<p>Subsequently the restrictions 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>. 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>Generally, Google updates keyword data in the middle of the month. Use the <a href=\"\/v3\/keywords_data\/google_ads\/status\/\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads Status\u200c<\/a> endpoint to check if Google updated keyword data for the previous month.<\/p>\n<h3>Methods<\/h3>\n<p>The cost of using Keywords Data endpoints depends on the selected method of task execution. Available methods 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<h4 style=\"color: #f44336; margin-bottom: 15px;\">Note: you can send no more than 12 requests per minute per account using Google Ads Live endpoints.<\/h4>\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.<\/p>\n<p>Learn more about task completion and obtaining a list of completed tasks in <a href=\"https:\/\/dataforseo.com\/help-center\/completed-tasks\" target=\"_blank\" rel=\"noopener noreferrer\">this help center article.<\/a><\/p>\n<p>You 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>\u200c<\/p>\n<h3>Cost<\/h3>\n<p>The cost can be calculated on the <a title=\"Pricing\" href=\"https:\/\/dataforseo.com\/pricing\/keywords-data\/google-ads\" 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 Google Ads 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] Google Ads Keywords Data API: Overview This API is the ultimate source of data for keyword analysis Using Google Ads Keywords Data API you can: Get Search Volume and other metrics for up to 1000 keywords Indicate a domain and obtain up to 2000 Keywords For Site Specify up to 20 terms and get [&hellip;]<\/p>\n","protected":false},"author":17,"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-11207","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/11207","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\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=11207"}],"version-history":[{"count":33,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/11207\/revisions"}],"predecessor-version":[{"id":23010,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/11207\/revisions\/23010"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=11207"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}