{"id":10506,"date":"2021-09-16T15:38:53","date_gmt":"2021-09-16T15:38:53","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=10506"},"modified":"2026-08-07T16:46:44","modified_gmt":"2026-08-07T16:46:44","slug":"keywords_data-google_ads-search_volume-live","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/keywords_data-google_ads-search_volume-live\/","title":{"rendered":"keywords_data\/google_ads\/search_volume\/live"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h2 id=\"setting-serp-tasks\">Setting Live &#8216;Google Ads Search Volume&#8217; Tasks<\/h2>\n<p>\u200c<br \/>\nNote 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>.<\/p>\n<p>This endpoint will provide you with search volume, monthly searches, competition, and other related data for up to 1000 keywords in a single request.<br \/>\n<strong>Note: you can send no more than 12 requests per minute per account using Google Ads Live endpoints.<\/strong><\/p>\n<p>Historical data is available for 4 years. <\/p>\n<p>[\/vc_column_text]    <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                    POST            <button class=\"btn-reset button-link copy-button\" data-href=\"https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/search_volume\/live\">\n                https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/search_volume\/live                <svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\">\n                    <use href=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/sprite.svg#layers\"><\/use>\n                <\/svg>\n            <\/button>\n            <\/div>\n    \t<article class=\"info-card info-card--yellow\">\n\t\t<header class=\"info-card__header\">\n\t\t\t<div class=\"info-card__icon\">\n\t\t\t\t<svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\">\n\t\t\t\t\t<use href=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/sprite.svg#label\"><\/use>\n\t\t\t\t<\/svg>\n\t\t\t<\/div>\n\t\t\t<div class=\"info-card__title\">Pricing<\/div>\n\t\t<\/header>\n\t\t<div class=\"info-card__content\">\n\t\t\t<p> Your account will be charged for each request.<br \/>\nThe 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.<\/p>\n\t\t<\/div>\n\t<\/article>\n\t[vc_column_text]All POST data should be sent in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON\">JSON<\/a> format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array.You can send up to 2000 API calls per minute, each Live API call can contain only one task. <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<p>You will get information for every single keyword in an array.<\/p>\n<p>You can send up to 1000 keywords in one\u00a0<code class=\"prettyprint\">keywords<\/code>\u00a0array. Our system will charge your account per each request, no matter what number of keywords an array has, the price for 1 or 1000 keywords will be the same.<\/p>\n<p>Below you will find a detailed description of the fields you can use for setting a task.<\/p>\n<p><strong>Description of the fields for setting a task:<\/strong><br \/>\n<div class=\"dfs-doc-container dfs-doc-request\"><table><thead><tr><th>Field name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr data-doc-id=\"keywords\"><td><code>keywords<\/code><\/td><td>array<\/td><td><p><em>keywords<\/em><br><strong>required field<\/strong><br>The maximum number of keywords you can specify: 1000<br>The maximum number of characters for each keyword: 80<br>The maximum number of words for each keyword phrase: 10<br>the keywords you specify will be converted to a lowercase format<br><strong>Note #1:<\/strong> <a href=\"https:\/\/dataforseo.com\/help-center\/no-search-volume-data-for-some-keywords\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads may return no data for certain groups of keywords<\/a>;<br><strong>Note #2:<\/strong> <a href=\"https:\/\/dataforseo.com\/help-center\/sv-broad-exact-phrase-match\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads provides combined search volume values for groups of similar keywords<\/a><br>to obtain search volume for similar keywords, we recommend submitting such keywords in separate requests;<br><strong>Note #3:<\/strong> Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;<br>to learn more about which symbols and characters can be used, please refer to <a href=\"https:\/\/dataforseo.com\/help-center\/using-symbols-in-keywords-when-setting-a-google-ads-task\" target=\"_blank\" rel=\"noopener noreferrer\">this article<\/a><p>learn more about rules and limitations of <code>keyword<\/code> and <code>keywords<\/code> fields in DataForSEO APIs in this <a href=\"https:\/\/dataforseo.com\/help-center\/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis\" rel=\"noopener noreferrer\" target=\"_blank\">Help Center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"location_name\"><td><code>location_name<\/code><\/td><td>string<\/td><td><p><em>full name of search engine location<\/em><br>optional field<br>if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br><strong>if you use this field, you don't need to specify <code>location_code<\/code> or <code>location_coordinate<\/code><\/strong><br>you can receive the list of available locations of the search engine with their <code>location_name<\/code> by making a separate request to <code><a href=\"https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/locations\">https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/locations<\/a><\/code><br>example:<br><code class=\"long-string\">London,England,United Kingdom<\/code><\/p><\/td><\/tr><tr data-doc-id=\"location_code\"><td><code>location_code<\/code><\/td><td>integer<\/td><td><p><em>search engine location code<\/em><br>optional field<br>if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br><strong>if you use this field, you don't need to specify <code>location_name<\/code> or <code>location_coordinate<\/code><\/strong>;<br>you can receive the list of available locations of the search engines with their <code>location_code<\/code> by making a separate request to <code><a href=\"https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/locations\">https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/locations<\/a><\/code><br>example:<br><code class=\"long-string\">2840<\/code><\/p><\/td><\/tr><tr data-doc-id=\"location_coordinate\"><td><code>location_coordinate<\/code><\/td><td>string<\/td><td><p><em>GPS coordinates of a location<\/em><br>optional field<br>if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br><strong>if you use this field, you don't need to specify <code>location_name<\/code> or <code>location_code<\/code><\/strong>;<br><code>location_coordinate<\/code> parameter should be specified in the <em>\"latitude,longitude\"<\/em> format;<br><strong>the data will be provided for the country the specified coordinates belong to<\/strong>;<br>example:<br><code class=\"long-string\">52.6178549,-155.352142<\/code><\/p><\/td><\/tr><tr data-doc-id=\"language_name\"><td><code>language_name<\/code><\/td><td>string<\/td><td><p><em>full name of search engine language<\/em><br>optional field<br>you can receive the list of available languages of the search engine with their <code>language_name<\/code> by making a separate request to <code><a href=\"https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/languages\">https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/languages<\/a><\/code><br>example:<br><code class=\"long-string\">English<\/code><\/p><\/td><\/tr><tr data-doc-id=\"language_code\"><td><code>language_code<\/code><\/td><td>string<\/td><td><p><em>search engine language code<\/em><br>optional field<br>you can receive the list of available languages of the search engine with their <code>language_code<\/code> by making a separate request to <code><a href=\"https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/languages\">https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/languages<\/a><\/code><br>example:<br><code class=\"long-string\">en<\/code><\/p><\/td><\/tr><tr data-doc-id=\"search_partners\"><td><code>search_partners<\/code><\/td><td>boolean<\/td><td><p><em>include Google search partners<\/em><br>optional field<br>if you specify <code class=\"prettyprint\">true<\/code>, the results will be delivered for owned, operated, and syndicated networks across <a href=\"https:\/\/support.google.com\/google-ads\/answer\/1722047?hl=en\" target=\"_blank\" rel=\"noopener noreferrer\">Google and partner sites<\/a> that host Google search;<br>default value: <code>false<\/code> - results are returned for Google search sites<\/p><\/td><\/tr><tr data-doc-id=\"date_from\"><td><code>date_from<\/code><\/td><td>string<\/td><td><p><em>starting date of the time range<\/em><br>optional field<br>date format: <code>\"yyyy-mm-dd\"<\/code><br>minimal value: 4 years from the current date<br>by default, data is returned for the past 12 months;<br><strong>Note<\/strong>: the indicated date cannot be greater than that specified in <code>date_to<\/code> and\/or yesterday's date;if <a href=\"\/v3\/keywords_data\/google_ads\/status\/\" target=\"_blank\" rel=\"noopener noreferrer\">Status endpoint<\/a> returns <code>false<\/code> in the <code>actual_data<\/code> field, <code>date_from<\/code> can be set to the month before last and prior;<br>if <a href=\"\/v3\/keywords_data\/google_ads\/status\/\" target=\"_blank\" rel=\"noopener noreferrer\">Status endpoint<\/a> returns <code>true<\/code> in the <code>actual_data<\/code> field, <code>date_from<\/code> can be set to the last month and prior<\/p><\/td><\/tr><tr data-doc-id=\"date_to\"><td><code>date_to<\/code><\/td><td>string<\/td><td><p><em>ending date of the time range<\/em><br>optional field<br><strong>Note:<\/strong> the indicated date cannot be greater than the past month, Google Ads does not return data on the current month;<br>if you don't specify this field, yesterday's date will be used by default<br>date format: <code>\"yyyy-mm-dd\"<\/code><br>example:<br><code>\"2022-11-30\"<\/code><\/p><\/td><\/tr><tr data-doc-id=\"include_adult_keywords\"><td><code>include_adult_keywords<\/code><\/td><td>boolean<\/td><td><p><em>include keywords associated with adult content<br><\/em>optional field<br>if set to<em><code>true<\/code>, adult keywords will be included in the response<br>default value:<\/em><code>false<\/code><br><strong>note<\/strong><em>that the API may return no data for such keywords due to<\/em><a href=\"https:\/\/support.google.com\/adspolicy\/answer\/6008942?hl=en\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads restrictions<\/a>n<\/p><\/td><\/tr><tr data-doc-id=\"sort_by\"><td><code>sort_by<\/code><\/td><td>string<\/td><td><p><em>results sorting parameters<\/em><br>optional field<br>use these parameters to sort the results by <code>relevance<\/code>, <code>search_volume<\/code>, <code>competition_index<\/code>, <code>low_top_of_page_bid<\/code>, or <code>high_top_of_page_bid<\/code> in the descending order<br>default value: <code>relevance<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tag\"><td><code>tag<\/code><\/td><td>string<\/td><td><p><em>user-defined task identifier<\/em><br>optional field<br><em>the character limit is 255<\/em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag<\/code> value in the <code>data<\/code> array of the response<\/p><\/td><\/tr><\/tbody><\/table><\/div>\n<p>As a response of the API server, you will receive <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON\">JSON<\/a>-encoded data containing a <code>tasks<\/code> array with the information specific to the set tasks.<\/p>\n<p><strong>Description of the fields in the results array:<\/strong><br \/>\n<div class=\"dfs-doc-container dfs-doc-response\"><div class=\"api-block-main\"><div class=\"api-section\"><table><thead><tr><th>Field name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr data-doc-id=\"version\"><td><code>version<\/code><\/td><td>string<\/td><td><p><em>the current version of the API<\/em><\/p><\/td><\/tr><tr data-doc-id=\"status_code\"><td><code>status_code<\/code><\/td><td>integer<\/td><td><p><i>general status code<\/i><br>you can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><br><strong>Note:<\/strong> we strongly recommend designing a necessary system for handling related exceptional or error conditions<\/p><\/td><\/tr><tr data-doc-id=\"status_message\"><td><code>status_message<\/code><\/td><td>string<\/td><td><p><em>general informational message<\/em><br>you can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a><\/p><\/td><\/tr><tr data-doc-id=\"time\"><td><code>time<\/code><\/td><td>string<\/td><td><p><em>execution time, seconds<\/em><\/p><\/td><\/tr><tr data-doc-id=\"cost\"><td><code>cost<\/code><\/td><td>float<\/td><td><p><em>total <i>tasks<\/i> cost, USD<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks_count\"><td><code>tasks_count<\/code><\/td><td>integer<\/td><td><p><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks_error\"><td><code>tasks_error<\/code><\/td><td>integer<\/td><td><p><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array returned with an error<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks\"><td><strong><code>tasks<\/code><\/strong><\/td><td>array<\/td><td><p><em>array of tasks<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-id\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>id<\/code><\/td><td>string<\/td><td><p><em>task identifier<\/em><br><strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\">UUID<\/a> format<\/strong><\/p><\/td><\/tr><tr data-doc-id=\"tasks-status_code\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>status_code<\/code><\/td><td>integer<\/td><td><p><em>status code of the task <\/em><br>generated by DataForSEO; can be within the following range: 10000-60000<br>you can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-status_message\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>status_message<\/code><\/td><td>string<\/td><td><p><em>informational message of the task<\/em><br>you can find the full list of general informational messages <a href=\"\/v3\/appendix-errors\/\">here<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>time<\/code><\/td><td>string<\/td><td><p><em>execution time, seconds<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-cost\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>cost<\/code><\/td><td>float<\/td><td><p><em>cost of the task, USD<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result_count\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>result_count<\/code><\/td><td>integer<\/td><td><p><em>number of elements in the <code>result<\/code> array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-path\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>path<\/code><\/td><td>array<\/td><td><p><em>URL path<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-data\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>data<\/code><\/td><td>array<\/td><td><p><em>contains the same parameters that you specified in the POST request<br><\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>result<\/code><\/strong><\/td><td>array<\/td><td><p><em>array of results<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-keyword\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>keyword<\/code><\/td><td>string<\/td><td><p><em>keyword<br><\/em><strong>keyword is returned with decoded %## (plus character '+' will be decoded to a space character)<\/strong><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-spell\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>spell<\/code><\/td><td>string<\/td><td><p><em>correct spelling of the keyword<\/em><br><strong>Note:<\/strong>if the keyword in the POST array appears to be misspelled, data will be returned for the correctly spelled keyword;<br>we use the functionality of Google Ads API to check and validate the spelling of keywords, <a href=\"https:\/\/support.google.com\/google-ads\/answer\/7476658\" target=\"_blank\" rel=\"noopener noreferrer\">learn more by this link<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-location_code\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>location_code<\/code><\/td><td>integer<\/td><td><p><em>location code in a POST array<\/em><br>if there is no data, then the value is_<code>null<\/code>n<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-language_code\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>language_code<\/code><\/td><td>string<\/td><td><p><em>language code in a POST array<\/em><br>if there is no data, then the value is_<code>null<\/code>n<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-search_partners\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_partners<\/code><\/td><td>boolean<\/td><td><p><em>indicates whether data from partner networks included in the response<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-competition\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>competition<\/code><\/td><td>string<\/td><td><p><em>competition<\/em><br>represents the relative amount of competition associated with the given keyword in paid SERP only;<br>this value is based on Google Ads data and can take the following values: <code>HIGH<\/code>, <code>MEDIUM<\/code>, <code>LOW<\/code>;<br>if there is no data the value is <code>null<\/code>;<br>learn more about the metric in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-competition\" target=\"_blank\" rel=\"noopener noreferrer\">this help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-competition_index\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>competition_index<\/code><\/td><td>integer<\/td><td><p><em>competition<\/em><br>represents the relative amount of competition associated with the given keyword in paid SERP only;<br>this value is based on Google Ads data and can be between 0 and 100 (inclusive);<br>if there is no data the value is <code>null<\/code>;<br>learn more about the metric in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-competition\" target=\"_blank\" rel=\"noopener noreferrer\">this help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>monthly average search volume rate;<br><\/em>represents either the (approximate) number of searches for the given keyword idea on google.com or google.com and partners, depending on the user\u2019s targeting;<br>if there is no data then the value is_<code>null<\/code>n<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-low_top_of_page_bid\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>low_top_of_page_bid<\/code><\/td><td>float<\/td><td><p><em>minimum bid for the ad to be displayed at the top of the first page<\/em><br>indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);<br>the value may differ depending on the location specified in a POST request<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-high_top_of_page_bid\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>high_top_of_page_bid<\/code><\/td><td>float<\/td><td><p><em>maximum bid for the ad to be displayed at the top of the first page<\/em><br>indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);<br>the value may differ depending on the location specified in a POST request<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-cpc\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>cpc<\/code><\/td><td>float<\/td><td><p><em>cost per click<\/em><br>indicates the amount paid (USD) for each click on the ad displayed for a given keyword<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-monthly_searches\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>monthly_searches<\/code><\/strong><\/td><td>array<\/td><td><p><em>monthly searches<\/em><br>represents the (approximate) number of searches on this keyword idea (as available for the past twelve months by default), targeted to the specified geographic locations;<br>if there is no data then the value is_<code>null<\/code>n<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-monthly_searches-year\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>year<\/code><\/td><td>integer<\/td><td><p><em>year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-monthly_searches-month\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>month<\/code><\/td><td>integer<\/td><td><p><em>month<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-monthly_searches-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>monthly average search volume rate<\/em><\/p><\/td><\/tr><\/tbody><\/table><\/div><\/div><\/div>\n<p>\u200c\u200c[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<blockquote><p>Instead of \u2018login\u2019 and \u2018password\u2019 use your credentials from https:\/\/app.dataforseo.com\/api-access<\/p><\/blockquote><div id=\"curl\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-bash hljs\"># Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access \r\nlogin=&quot;login&quot; \r\npassword=&quot;password&quot; \r\ncred=&quot;$(printf ${login}:${password} | base64)&quot; \r\ncurl --location --request POST &quot;https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/search_volume\/live&quot; \r\n--header &quot;Authorization: Basic ${cred}&quot;  \r\n--header &quot;Content-Type: application\/json&quot; \r\n--data-raw &#039;[\r\n    {\r\n        &quot;location_code&quot;: 2840,\r\n        &quot;keywords&quot;: [\r\n            &quot;buy laptop&quot;,\r\n            &quot;cheap laptops for sale&quot;,\r\n            &quot;purchase laptop&quot;\r\n        ],\r\n        &quot;date_from&quot;: &quot;2021-08-01&quot;,\r\n        &quot;search_partners&quot;: true \r\n    }\r\n]&#039;<\/code><\/pre><\/div><\/div><div id=\"php\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-php hljs\">&lt;?php\r\n\/\/ You can download this file from here https:\/\/cdn.dataforseo.com\/v3\/examples\/php\/php_RestClient.zip\r\nrequire(&#039;RestClient.php&#039;);\r\n$api_url = &#039;https:\/\/api.dataforseo.com\/&#039;;\r\ntry {\r\n\t\/\/ Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access\r\n\t$client = new RestClient($api_url, null, &#039;login&#039;, &#039;password&#039;);\r\n} catch (RestClientException $e) {\r\n\techo &quot;n&quot;;\r\n\tprint &quot;HTTP code: {$e-&gt;getHttpCode()}n&quot;;\r\n\tprint &quot;Error code: {$e-&gt;getCode()}n&quot;;\r\n\tprint &quot;Message: {$e-&gt;getMessage()}n&quot;;\r\n\tprint  $e-&gt;getTraceAsString();\r\n\techo &quot;n&quot;;\r\n\texit();\r\n}\r\n$post_array = array();\r\n\/\/ simple way to set a task\r\n$post_array[] = array(\r\n\t&quot;location_code&quot; =&gt; 2840,\r\n\t&quot;keywords&quot; =&gt; array(\r\n          &quot;buy laptop&quot;,\r\n          &quot;cheap laptops for sale&quot;,\r\n          &quot;purchase laptop&quot;\r\n\t),\r\n\t&quot;date_from&quot;=&gt; &quot;2021-08-01&quot;,\r\n\t&quot;search_partners&quot;=&gt; true \r\n);\r\ntry {\r\n\t\/\/ POST \/v3\/keywords_data\/google_ads\/search_volume\/live\r\n\t\/\/ the full list of possible parameters is available in documentation\r\n\t$result = $client-&gt;post(&#039;\/v3\/keywords_data\/google_ads\/search_volume\/live&#039;, $post_array);\r\n\tprint_r($result);\r\n\t\/\/ do something with post result\r\n} catch (RestClientException $e) {\r\n\techo &quot;n&quot;;\r\n\tprint &quot;HTTP code: {$e-&gt;getHttpCode()}n&quot;;\r\n\tprint &quot;Error code: {$e-&gt;getCode()}n&quot;;\r\n\tprint &quot;Message: {$e-&gt;getMessage()}n&quot;;\r\n\tprint  $e-&gt;getTraceAsString();\r\n\techo &quot;n&quot;;\r\n}\r\n$client = null;\r\n?&gt;<\/code><\/pre><\/div><\/div><div id=\"javascript\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-javascript hljs\">const post_array = [];\r\n\r\npost_array.push({\r\n  &quot;location_code&quot;: 2840,\r\n  &quot;keywords&quot;: [&quot;buy laptop&quot;, &quot;cheap laptops for sale&quot;, &quot;purchase laptop&quot;],\r\n  &quot;date_from&quot;: &quot;2021-08-01&quot;,\r\n  &quot;search_partners&quot;: true \r\n});\r\n\r\nconst axios = require(&#039;axios&#039;);\r\n\r\naxios({\r\n  method: &#039;post&#039;,\r\n  url: &#039;https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/search_volume\/live&#039;,\r\n  auth: {\r\n    username: &#039;login&#039;,\r\n    password: &#039;password&#039;\r\n  },\r\n  data: post_array,\r\n  headers: {\r\n    &#039;content-type&#039;: &#039;application\/json&#039;\r\n  }\r\n}).then(function (response) {\r\n  var result = response[&#039;data&#039;][&#039;tasks&#039;];\r\n  \/\/ Result data\r\n  console.log(result);\r\n}).catch(function (error) {\r\n  console.log(error);\r\n});<\/code><\/pre><\/div><\/div><div id=\"python\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-python hljs\">from client import RestClient\r\n# You can download this file from here https:\/\/cdn.dataforseo.com\/v3\/examples\/python\/python_Client.zip\r\nclient = RestClient(&quot;login&quot;, &quot;password&quot;)\r\npost_data = dict()\r\n# simple way to set a task\r\npost_data[len(post_data)] = dict(\r\n    location_code=2840,\r\n    keywords=[\r\n        &quot;buy laptop&quot;,\r\n        &quot;cheap laptops for sale&quot;,\r\n        &quot;purchase laptop&quot;\r\n    ],\r\n    date_from=&quot;2021-08-01&quot;,\r\n    search_partners=true \r\n)\r\n# POST \/v3\/keywords_data\/google_ads\/search_volume\/live\r\n# the full list of possible parameters is available in documentation\r\nresponse = client.post(&quot;\/v3\/keywords_data\/google_ads\/search_volume\/live&quot;, post_data)\r\n# you can find the full list of the response codes here https:\/\/docs.dataforseo.com\/v3\/appendix\/errors\r\nif response[&quot;status_code&quot;] == 20000:\r\n    print(response)\r\n    # do something with result\r\nelse:\r\n    print(&quot;error. Code: %d Message: %s&quot; % (response[&quot;status_code&quot;], response[&quot;status_message&quot;]))<\/code><\/pre><\/div><\/div><div id=\"csharp\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-csharp hljs\">using Newtonsoft.Json;\r\nusing System;\r\nusing System.Collections.Generic;\r\nusing System.Net.Http;\r\nusing System.Net.Http.Headers;\r\nusing System.Text;\r\nusing System.Threading.Tasks;\r\n\r\nnamespace DataForSeoDemos\r\n{\r\n    public static partial class Demos\r\n    {\r\n        public static async Task keywords_data_search_volume_live()\r\n        {\r\n            var httpClient = new HttpClient\r\n            {\r\n                BaseAddress = new Uri(&quot;https:\/\/api.dataforseo.com\/&quot;),\r\n                \/\/ Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access\r\n                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue(&quot;Basic&quot;, Convert.ToBase64String(Encoding.ASCII.GetBytes(&quot;login:password&quot;))) }\r\n            };\r\n            var postData = new List&lt;object&gt;();\r\n            postData.Add(new\r\n            {\r\n                location_code = 2840,\r\n                keywords = new[]\r\n                {\r\n                    &quot;buy laptop&quot;,\r\n                    &quot;cheap laptops for sale&quot;,\r\n                    &quot;purchase laptop&quot;\r\n                },\r\n                date_from: &quot;2021-08-01&quot;,\r\n                search_partners: true \r\n            });\r\n            \/\/ POST \/v3\/keywords_data\/google_ads\/search_volume\/live\r\n            \/\/ the full list of possible parameters is available in documentation\r\n            var taskPostResponse = await httpClient.PostAsync(&quot;\/v3\/keywords_data\/google_ads\/search_volume\/live&quot;, new StringContent(JsonConvert.SerializeObject(postData)));\r\n            var result = JsonConvert.DeserializeObject&lt;dynamic&gt;(await taskPostResponse.Content.ReadAsStringAsync());\r\n            \/\/ you can find the full list of the response codes here https:\/\/docs.dataforseo.com\/v3\/appendix\/errors\r\n            if (result.status_code == 20000)\r\n            {\r\n                \/\/ do something with result\r\n                Console.WriteLine(result);\r\n            }\r\n            else\r\n                Console.WriteLine($&quot;error. Code: {result.status_code} Message: {result.status_message}&quot;);\r\n        }\r\n    }\r\n}<\/code><\/pre><\/div><\/div><blockquote><p>The above command returns JSON structured like this:<\/p><\/blockquote><div class=\"example example--json\"><div class=\"example__content\"><div class=\"example__code example__code-json\"><pre><code class=\"language-json hljs\">{\r\n  &quot;version&quot;: &quot;0.1.20231117&quot;,\r\n  &quot;status_code&quot;: 20000,\r\n  &quot;status_message&quot;: &quot;Ok.&quot;,\r\n  &quot;time&quot;: &quot;1.9903 sec.&quot;,\r\n  &quot;cost&quot;: 0.075,\r\n  &quot;tasks_count&quot;: 1,\r\n  &quot;tasks_error&quot;: 0,\r\n  &quot;tasks&quot;: [\r\n    {\r\n      &quot;id&quot;: &quot;11301935-1535-0367-0000-b44e4432f0be&quot;,\r\n      &quot;status_code&quot;: 20000,\r\n      &quot;status_message&quot;: &quot;Ok.&quot;,\r\n      &quot;time&quot;: &quot;1.8689 sec.&quot;,\r\n      &quot;cost&quot;: 0.075,\r\n      &quot;result_count&quot;: 3,\r\n      &quot;path&quot;: [\r\n        &quot;v3&quot;,\r\n        &quot;keywords_data&quot;,\r\n        &quot;google_ads&quot;,\r\n        &quot;search_volume&quot;,\r\n        &quot;live&quot;\r\n      ],\r\n      &quot;data&quot;: {\r\n        &quot;api&quot;: &quot;keywords_data&quot;,\r\n        &quot;function&quot;: &quot;search_volume&quot;,\r\n        &quot;se&quot;: &quot;google_ads&quot;,\r\n        &quot;language_code&quot;: &quot;en&quot;,\r\n        &quot;location_code&quot;: 2840,\r\n        &quot;keywords&quot;: [\r\n          &quot;buy laptop&quot;,\r\n          &quot;cheap laptops for sale&quot;,\r\n          &quot;purchase laptop&quot;\r\n        ],\r\n        &quot;date_from&quot;: &quot;2021-08-01&quot;\r\n      },\r\n      &quot;result&quot;: [\r\n        {\r\n          &quot;keyword&quot;: &quot;buy laptop&quot;,\r\n          &quot;spell&quot;: null,\r\n          &quot;location_code&quot;: 2840,\r\n          &quot;language_code&quot;: &quot;en&quot;,\r\n          &quot;search_partners&quot;: false,\r\n          &quot;competition&quot;: &quot;HIGH&quot;,\r\n          &quot;competition_index&quot;: 100,\r\n          &quot;search_volume&quot;: 2900,\r\n          &quot;low_top_of_page_bid&quot;: 1.69,\r\n          &quot;high_top_of_page_bid&quot;: 10.04,\r\n          &quot;cpc&quot;: 7.95,\r\n          &quot;monthly_searches&quot;: [\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 2400\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 2900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 7,\r\n              &quot;search_volume&quot;: 2900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 6,\r\n              &quot;search_volume&quot;: 2400\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 5,\r\n              &quot;search_volume&quot;: 2900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 4,\r\n              &quot;search_volume&quot;: 2900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 3,\r\n              &quot;search_volume&quot;: 2900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 2,\r\n              &quot;search_volume&quot;: 2900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 1,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 12,\r\n              &quot;search_volume&quot;: 2900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 11,\r\n              &quot;search_volume&quot;: 4400\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 7,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 6,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 5,\r\n              &quot;search_volume&quot;: 5400\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 4,\r\n              &quot;search_volume&quot;: 4400\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 3,\r\n              &quot;search_volume&quot;: 4400\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 2,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 1,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 12,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 11,\r\n              &quot;search_volume&quot;: 4400\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 3600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 4400\r\n            }\r\n          ]\r\n        },\r\n        {\r\n          &quot;keyword&quot;: &quot;cheap laptops for sale&quot;,\r\n          &quot;spell&quot;: null,\r\n          &quot;location_code&quot;: 2840,\r\n          &quot;language_code&quot;: &quot;en&quot;,\r\n          &quot;search_partners&quot;: false,\r\n          &quot;competition&quot;: &quot;HIGH&quot;,\r\n          &quot;competition_index&quot;: 100,\r\n          &quot;search_volume&quot;: 6600,\r\n          &quot;low_top_of_page_bid&quot;: 0.38,\r\n          &quot;high_top_of_page_bid&quot;: 2.78,\r\n          &quot;cpc&quot;: 1.25,\r\n          &quot;monthly_searches&quot;: [\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 7,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 6,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 5,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 4,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 3,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 2,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 1,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 12,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 11,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 7,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 6,\r\n              &quot;search_volume&quot;: 6600\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 5,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 4,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 3,\r\n              &quot;search_volume&quot;: 9900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 2,\r\n              &quot;search_volume&quot;: 9900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 1,\r\n              &quot;search_volume&quot;: 9900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 12,\r\n              &quot;search_volume&quot;: 12100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 11,\r\n              &quot;search_volume&quot;: 12100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 8100\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 9900\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 12100\r\n            }\r\n          ]\r\n        },\r\n        {\r\n          &quot;keyword&quot;: &quot;purchase laptop&quot;,\r\n          &quot;spell&quot;: null,\r\n          &quot;location_code&quot;: 2840,\r\n          &quot;language_code&quot;: &quot;en&quot;,\r\n          &quot;search_partners&quot;: false,\r\n          &quot;competition&quot;: &quot;HIGH&quot;,\r\n          &quot;competition_index&quot;: 99,\r\n          &quot;search_volume&quot;: 110,\r\n          &quot;low_top_of_page_bid&quot;: 2.07,\r\n          &quot;high_top_of_page_bid&quot;: 15.43,\r\n          &quot;cpc&quot;: 12.74,\r\n          &quot;monthly_searches&quot;: [\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 110\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 110\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 170\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 7,\r\n              &quot;search_volume&quot;: 110\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 6,\r\n              &quot;search_volume&quot;: 140\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 5,\r\n              &quot;search_volume&quot;: 140\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 4,\r\n              &quot;search_volume&quot;: 170\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 3,\r\n              &quot;search_volume&quot;: 140\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 2,\r\n              &quot;search_volume&quot;: 110\r\n            },\r\n            {\r\n              &quot;year&quot;: 2023,\r\n              &quot;month&quot;: 1,\r\n              &quot;search_volume&quot;: 70\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 12,\r\n              &quot;search_volume&quot;: 70\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 11,\r\n              &quot;search_volume&quot;: 140\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 90\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 110\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 90\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 7,\r\n              &quot;search_volume&quot;: 110\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 6,\r\n              &quot;search_volume&quot;: 170\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 5,\r\n              &quot;search_volume&quot;: 170\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 4,\r\n              &quot;search_volume&quot;: 140\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 3,\r\n              &quot;search_volume&quot;: 210\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 2,\r\n              &quot;search_volume&quot;: 140\r\n            },\r\n            {\r\n              &quot;year&quot;: 2022,\r\n              &quot;month&quot;: 1,\r\n              &quot;search_volume&quot;: 140\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 12,\r\n              &quot;search_volume&quot;: 90\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 11,\r\n              &quot;search_volume&quot;: 110\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 10,\r\n              &quot;search_volume&quot;: 140\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 9,\r\n              &quot;search_volume&quot;: 90\r\n            },\r\n            {\r\n              &quot;year&quot;: 2021,\r\n              &quot;month&quot;: 8,\r\n              &quot;search_volume&quot;: 110\r\n            }\r\n          ]\r\n        }\r\n      ]\r\n    }\r\n  ]\r\n}<\/code><\/pre><\/div><\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"<p>[vc_row][vc_column][vc_column_text] Setting Live &#8216;Google Ads Search Volume&#8217; Tasks \u200c Note that Google Ads Keywords Data API is based on the latest version of the Google Ads API that has replaced legacy Google AdWords API. If you\u2019re using DataForSEO Google AdWords API, you need to upgrade to DataForSEO Google Ads API. This endpoint will provide you [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"parameters:\n  - name: keywords\n    type: array\n    description: |\n      <em>keywords<\/em><br><strong>required field<\/strong><br>The maximum number of keywords you can specify: 1000<br>The maximum number of characters for each keyword: 80<br>The maximum number of words for each keyword phrase: 10<br>the keywords you specify will be converted to a lowercase format<br><strong>Note #1:<\/strong> <a href=\"https:\/\/dataforseo.com\/help-center\/no-search-volume-data-for-some-keywords\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads may return no data for certain groups of keywords<\/a>;<br><strong>Note #2:<\/strong> <a href=\"https:\/\/dataforseo.com\/help-center\/sv-broad-exact-phrase-match\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads provides combined search volume values for groups of similar keywords<\/a><br>to obtain search volume for similar keywords, we recommend submitting such keywords in separate requests;<br><strong>Note #3:<\/strong> Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;<br>to learn more about which symbols and characters can be used, please refer to <a href=\"https:\/\/dataforseo.com\/help-center\/using-symbols-in-keywords-when-setting-a-google-ads-task\" target=\"_blank\" rel=\"noopener noreferrer\">this article<\/a><p>learn more about rules and limitations of <code>keyword<\/code> and <code>keywords<\/code> fields in DataForSEO APIs in this <a href=\"https:\/\/dataforseo.com\/help-center\/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis\" rel=\"noopener noreferrer\" target=\"_blank\">Help Center article<\/a>\n  - name: location_name\n    type: string\n    description: |\n      <em>full name of search engine location<\/em><br>optional field<br>if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br><strong>if you use this field, you don't need to specify <code>location_code<\/code> or <code>location_coordinate<\/code><\/strong><br>you can receive the list of available locations of the search engine with their <code>location_name<\/code> by making a separate request to <code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/locations<\/code><br>example:<br><code class=\"long-string\">London,England,United Kingdom<\/code>\n  - name: location_code\n    type: integer\n    description: |\n      <em>search engine location code<\/em><br>optional field<br>if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br><strong>if you use this field, you don't need to specify <code>location_name<\/code> or <code>location_coordinate<\/code><\/strong>;<br>you can receive the list of available locations of the search engines with their <code>location_code<\/code> by making a separate request to <code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/locations<\/code><br>example:<br><code class=\"long-string\">2840<\/code>\n  - name: location_coordinate\n    type: string\n    description: |\n      <em>GPS coordinates of a location<\/em><br>optional field<br>if you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br><strong>if you use this field, you don't need to specify <code>location_name<\/code> or <code>location_code<\/code><\/strong>;<br><code>location_coordinate<\/code> parameter should be specified in the <em>\"latitude,longitude\"<\/em> format;<br><strong>the data will be provided for the country the specified coordinates belong to<\/strong>;<br>example:<br><code class=\"long-string\">52.6178549,-155.352142<\/code>\n  - name: language_name\n    type: string\n    description: |\n      <em>full name of search engine language<\/em><br>optional field<br>you can receive the list of available languages of the search engine with their <code>language_name<\/code> by making a separate request to <code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/languages<\/code><br>example:<br><code class=\"long-string\">English<\/code>\n  - name: language_code\n    type: string\n    description: |\n      <em>search engine language code<\/em><br>optional field<br>you can receive the list of available languages of the search engine with their <code>language_code<\/code> by making a separate request to <code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/google_ads\/languages<\/code><br>example:<br><code class=\"long-string\">en<\/code>\n  - name: search_partners\n    type: boolean\n    description: |\n      <em>include Google search partners<\/em><br>optional field<br>if you specify <code class=\"prettyprint\">true<\/code>, the results will be delivered for owned, operated, and syndicated networks across <a href=\"https:\/\/support.google.com\/google-ads\/answer\/1722047?hl=en\" target=\"_blank\" rel=\"noopener noreferrer\">Google and partner sites<\/a> that host Google search;<br>default value: <code>false<\/code> - results are returned for Google search sites\n  - name: date_from\n    type: string\n    description: |\n      <em>starting date of the time range<\/em><br>optional field<br>date format: <code>\"yyyy-mm-dd\"<\/code><br>minimal value: 4 years from the current date<br>by default, data is returned for the past 12 months;<br><strong>Note<\/strong>: the indicated date cannot be greater than that specified in <code>date_to<\/code> and\/or yesterday's date;if <a href=\"\/v3\/keywords_data\/google_ads\/status\/\" target=\"_blank\" rel=\"noopener noreferrer\">Status endpoint<\/a> returns <code>false<\/code> in the <code>actual_data<\/code> field, <code>date_from<\/code> can be set to the month before last and prior;<br>if <a href=\"\/v3\/keywords_data\/google_ads\/status\/\" target=\"_blank\" rel=\"noopener noreferrer\">Status endpoint<\/a> returns <code>true<\/code> in the <code>actual_data<\/code> field, <code>date_from<\/code> can be set to the last month and prior\n  - name: date_to\n    type: string\n    description: |\n      <em>ending date of the time range<\/em><br>optional field<br><strong>Note:<\/strong> the indicated date cannot be greater than the past month, Google Ads does not return data on the current month;<br>if you don't specify this field, yesterday's date will be used by default<br>date format: <code>\"yyyy-mm-dd\"<\/code><br>example:<br><code>\"2022-11-30\"<\/code>\n  - name: include_adult_keywords\n    type: boolean\n    description: \"<em>include keywords associated with adult content<br><\/em>optional field<br>if set to_<code>true<\/code>, adult keywords will be included in the response<br>default value:_<code>false<\/code><br><strong>note<\/strong>_that the API may return no data for such keywords due to_<a href=\"https:\/\/support.google.com\/adspolicy\/answer\/6008942?hl=en\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads restrictions<\/a>n\"\n  - name: sort_by\n    type: string\n    description: |\n      <em>results sorting parameters<\/em><br>optional field<br>use these parameters to sort the results by <code>relevance<\/code>, <code>search_volume<\/code>, <code>competition_index<\/code>, <code>low_top_of_page_bid<\/code>, or <code>high_top_of_page_bid<\/code> in the descending order<br>default value: <code>relevance<\/code>\n  - name: tag\n    type: string\n    description: |\n      <em>user-defined task identifier<\/em><br>optional field<br><em>the character limit is 255<\/em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag<\/code> value in the <code>data<\/code> array of the response","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"parameters:\n  - name: version\n    type: string\n    description: |\n      <em>the current version of the API<\/em>\n  - name: status_code\n    type: integer\n    description: |\n      <i>general status code<\/i><br>you can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><br><strong>Note:<\/strong> we strongly recommend designing a necessary system for handling related exceptional or error conditions\n  - name: status_message\n    type: string\n    description: |\n      <em>general informational message<\/em><br>you can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a>\n  - name: time\n    type: string\n    description: |\n      <em>execution time, seconds<\/em>\n  - name: cost\n    type: float\n    description: |\n      <em>total <i>tasks<\/i> cost, USD<\/em>\n  - name: tasks_count\n    type: integer\n    description: |\n      <em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array<\/em>\n  - name: tasks_error\n    type: integer\n    description: |\n      <em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array returned with an error<\/em>\n  - name: tasks\n    type: array\n    description: |\n      <em>array of tasks<\/em>\n    items:\n      children:\n        - name: id\n          type: string\n          description: |\n            <em>task identifier<\/em><br><strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\">UUID<\/a> format<\/strong>\n        - name: status_code\n          type: integer\n          description: |\n            <em>status code of the task <\/em><br>generated by DataForSEO; can be within the following range: 10000-60000<br>you can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a>\n        - name: status_message\n          type: string\n          description: |\n            <em>informational message of the task<\/em><br>you can find the full list of general informational messages <a href=\"\/v3\/appendix-errors\/\">here<\/a>\n        - name: time\n          type: string\n          description: |\n            <em>execution time, seconds<\/em>\n        - name: cost\n          type: float\n          description: |\n            <em>cost of the task, USD<\/em>\n        - name: result_count\n          type: integer\n          description: |\n            <em>number of elements in the <code>result<\/code> array<\/em>\n        - name: path\n          type: array\n          description: |\n            <em>URL path<\/em>\n        - name: data\n          type: array\n          description: |\n            <em>contains the same parameters that you specified in the POST request<br><\/em>\n        - name: result\n          type: array\n          description: |\n            <em>array of results<\/em>\n          items:\n            children:\n              - name: keyword\n                type: string\n                description: |\n                  <em>keyword<br><\/em><strong>keyword is returned with decoded %## (plus character '+' will be decoded to a space character)<\/strong>\n              - name: spell\n                type: string\n                description: |\n                  <em>correct spelling of the keyword<\/em><br><strong>Note:<\/strong>if the keyword in the POST array appears to be misspelled, data will be returned for the correctly spelled keyword;<br>we use the functionality of Google Ads API to check and validate the spelling of keywords, <a href=\"https:\/\/support.google.com\/google-ads\/answer\/7476658\" target=\"_blank\" rel=\"noopener noreferrer\">learn more by this link<\/a>\n              - name: location_code\n                type: integer\n                description: \"<em>location code in a POST array<\/em><br>if there is no data, then the value is_<code>null<\/code>n\"\n              - name: language_code\n                type: string\n                description: \"<em>language code in a POST array<\/em><br>if there is no data, then the value is_<code>null<\/code>n\"\n              - name: search_partners\n                type: boolean\n                description: |\n                  <em>indicates whether data from partner networks included in the response<\/em>\n              - name: competition\n                type: string\n                description: |\n                  <em>competition<\/em><br>represents the relative amount of competition associated with the given keyword in paid SERP only;<br>this value is based on Google Ads data and can take the following values: <code>HIGH<\/code>, <code>MEDIUM<\/code>, <code>LOW<\/code>;<br>if there is no data the value is <code>null<\/code>;<br>learn more about the metric in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-competition\" target=\"_blank\" rel=\"noopener noreferrer\">this help center article<\/a>\n              - name: competition_index\n                type: integer\n                description: |\n                  <em>competition<\/em><br>represents the relative amount of competition associated with the given keyword in paid SERP only;<br>this value is based on Google Ads data and can be between 0 and 100 (inclusive);<br>if there is no data the value is <code>null<\/code>;<br>learn more about the metric in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-competition\" target=\"_blank\" rel=\"noopener noreferrer\">this help center article<\/a>\n              - name: search_volume\n                type: integer\n                description: \"<em>monthly average search volume rate;<br><\/em>represents either the (approximate) number of searches for the given keyword idea on google.com or google.com and partners, depending on the user\u2019s targeting;<br>if there is no data then the value is_<code>null<\/code>n\"\n              - name: low_top_of_page_bid\n                type: float\n                description: |\n                  <em>minimum bid for the ad to be displayed at the top of the first page<\/em><br>indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);<br>the value may differ depending on the location specified in a POST request\n              - name: high_top_of_page_bid\n                type: float\n                description: |\n                  <em>maximum bid for the ad to be displayed at the top of the first page<\/em><br>indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);<br>the value may differ depending on the location specified in a POST request\n              - name: cpc\n                type: float\n                description: |\n                  <em>cost per click<\/em><br>indicates the amount paid (USD) for each click on the ad displayed for a given keyword\n              - name: monthly_searches\n                type: array\n                description: \"<em>monthly searches<\/em><br>represents the (approximate) number of searches on this keyword idea (as available for the past twelve months by default), targeted to the specified geographic locations;<br>if there is no data then the value is_<code>null<\/code>n\"\n                items:\n                  children:\n                    - name: year\n                      type: integer\n                      description: |\n                        <em>year<\/em>\n                    - name: month\n                      type: integer\n                      description: |\n                        <em>month<\/em>\n                    - name: search_volume\n                      type: integer\n                      description: |\n                        <em>monthly average search volume rate<\/em>","footnotes":""},"class_list":["post-10506","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/10506","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\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=10506"}],"version-history":[{"count":52,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/10506\/revisions"}],"predecessor-version":[{"id":26322,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/10506\/revisions\/26322"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=10506"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}