{"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":"2025-12-18T15:33:00","modified_gmt":"2025-12-18T15:33:00","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 24 months. <\/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. <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><\/p>\n<table style=\"width: 100%; height: 1259px;\">\n<thead>\n<tr style=\"height: 24px;\">\n<th style=\"width: 12.4003%; height: 24px;\">Field name<\/th>\n<th style=\"width: 3.91588%; height: 24px;\">Type<\/th>\n<th style=\"width: 82.9587%; height: 24px;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 192px;\"><code>keywords<\/code><\/td>\n<td style=\"width: 3.9884%; height: 192px;\">array<\/td>\n<td style=\"width: 82.8862%; height: 192px;\"><em>keywords<\/em><br \/>\n<strong>required field<\/strong><br \/>\nThe maximum number of keywords you can specify: 1000<br \/>\nThe maximum number of characters for each keyword: 80<br \/>\nThe maximum number of words for each keyword phrase: 10<br \/>\nthe keywords you specify will be converted to a lowercase format<br \/>\n<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 \/>\n<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 \/>\nto obtain search volume for similar keywords, we recommend submitting such keywords in separate requests;<br \/>\n<strong>Note #3:<\/strong> Google Ads doesn&#8217;t allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can&#8217;t use them when setting a task;<br \/>\nto 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>\n<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><\/td>\n<\/tr>\n<tr style=\"height: 10px;\">\n<td style=\"width: 12.4003%; height: 10px;\"><code>location_name<\/code><\/td>\n<td style=\"width: 3.91588%; height: 10px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 10px;\"><em>full name of search engine location<\/em><br \/>\noptional field<br \/>\nif you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br \/>\n<strong>if you use this field, you don&#8217;t need to specify <code>location_code<\/code> or <code>location_coordinate<\/code><\/strong><br \/>\nyou 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 \/>\nexample:<br \/>\n<code class=\"long-string\">London,England,United Kingdom<\/code><\/td>\n<\/tr>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 169px;\"><code>location_code<\/code><\/td>\n<td style=\"width: 3.91588%; height: 169px;\">integer<\/td>\n<td style=\"width: 82.9587%; height: 169px;\"><em>search engine location code<\/em><br \/>\noptional field<br \/>\nif you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br \/>\n<strong>if you use this field, you don&#8217;t need to specify <code>location_name<\/code> or <code>location_coordinate<\/code><\/strong>;<br \/>\nyou 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 \/>\nexample:<br \/>\n<code class=\"long-string\">2840<\/code><\/td>\n<\/tr>\n<tr style=\"height: 96px;\">\n<td style=\"width: 12.4003%; height: 96px;\"><code>location_coordinate<\/code><\/td>\n<td style=\"width: 3.91588%; height: 96px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 96px;\"><em>GPS coordinates of a location<\/em><br \/>\noptional field<br \/>\nif you do not indicate the location, you will receive worldwide results, i.e., for all available locations;<br \/>\n<strong>if you use this field, you don&#8217;t need to specify <code>location_name<\/code> or <code>location_code<\/code><\/strong>;<br \/>\n<code>location_coordinate<\/code> parameter should be specified in the <em>&#8220;latitude,longitude&#8221;<\/em> format;<br \/>\n<strong>the data will be provided for the country the specified coordinates belong to<\/strong>;<br \/>\nexample:<br \/>\n<code class=\"long-string\">52.6178549,-155.352142<\/code><\/td>\n<\/tr>\n<tr style=\"height: 168px;\">\n<td style=\"width: 12.4003%; height: 168px;\"><code>language_name<\/code><\/td>\n<td style=\"width: 3.91588%; height: 168px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 168px;\"><em>full name of search engine language<\/em><br \/>\noptional field<br \/>\nyou 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 \/>\nexample:<br \/>\n<code class=\"long-string\">English<\/code><\/td>\n<\/tr>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 163px;\"><code>language_code<\/code><\/td>\n<td style=\"width: 3.91588%; height: 163px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 163px;\"><em>search engine language code<\/em><br \/>\noptional field<br \/>\nyou 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 \/>\nexample:<br \/>\n<code class=\"long-string\">en<\/code><\/td>\n<\/tr>\n<tr style=\"height: 96px;\">\n<td style=\"width: 12.4003%; height: 77px;\"><code>search_partners<\/code><\/td>\n<td style=\"width: 3.91588%; height: 77px;\">boolean<\/td>\n<td style=\"width: 82.9587%; height: 77px;\"><em>include Google search partners<\/em><br \/>\noptional field<br \/>\nif 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 \/>\ndefault value: <code>false<\/code> &#8211; results are returned for Google search sites<\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 12.4003%; height: 48px;\"><code>date_from<\/code><\/td>\n<td style=\"width: 3.91588%; height: 48px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 48px;\"><em>starting date of the time range<\/em><br \/>\noptional field<br \/>\ndate format: <code>\"yyyy-mm-dd\"<\/code><br \/>\nminimal value: 4 years from the current date<br \/>\nby default, data is returned for the past 12 months;<br \/>\n<strong>Note<\/strong>: the indicated date cannot be greater than that specified in <code>date_to<\/code> and\/or yesterday&#8217;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 \/>\nif <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<\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 12.4003%; height: 48px;\"><code>date_to<\/code><\/td>\n<td style=\"width: 3.91588%; height: 48px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 48px;\"><em>ending date of the time range<\/em><br \/>\noptional field<br \/>\n<strong>Note:<\/strong> the indicated date cannot be greater than the past month, Google Ads does not return data on the current month;<br \/>\nif you don&#8217;t specify this field, yesterday&#8217;s date will be used by default<br \/>\ndate format: <code>\"yyyy-mm-dd\"<\/code><br \/>\nexample:<br \/>\n<code>\"2022-11-30\"<\/code><\/td>\n<\/tr>\n<tr>\n<td style=\"width: 12.4003%;\"><code>include_adult_keywords<\/code><\/td>\n<td style=\"width: 3.91588%;\">boolean<\/td>\n<td style=\"width: 82.9587%;\"><em>include keywords associated with adult content<br \/>\n<\/em>optional field<br \/>\nif set to\u00a0<code>true<\/code>, adult keywords will be included in the response<br \/>\ndefault value:\u00a0<code>false<\/code><br \/>\n<strong>note<\/strong>\u00a0that the API may return no data for such keywords due to\u00a0<a href=\"https:\/\/support.google.com\/adspolicy\/answer\/6008942?hl=en\" target=\"_blank\" rel=\"noopener noreferrer\">Google Ads restrictions<\/a><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 12.4003%; height: 48px;\"><code>sort_by<\/code><\/td>\n<td style=\"width: 3.91588%; height: 48px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 48px;\"><em>results sorting parameters<\/em><br \/>\noptional field<br \/>\nuse 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 \/>\ndefault value: <code>relevance<\/code><\/td>\n<\/tr>\n<tr style=\"height: 96px;\">\n<td style=\"width: 12.4003%; height: 96px;\"><code>tag<\/code><\/td>\n<td style=\"width: 3.9884%; height: 96px;\">string<\/td>\n<td style=\"width: 82.8862%; height: 96px;\"><em>user-defined task identifier<\/em><br \/>\noptional field<br \/>\n<em>the character limit is 255<\/em><br \/>\nyou can use this parameter to identify the task and match it with the result<br \/>\nyou will find the specified <code>tag<\/code> value in the <code>data<\/code> array of the response<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\u200c<br \/>\nAs 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><\/p>\n<table style=\"width: 77.3646%; height: 552px;\">\n<thead>\n<tr style=\"height: 24px;\">\n<th style=\"width: 38.423%; height: 24px;\">Field name<\/th>\n<th style=\"width: 1.25156%; height: 24px;\">Type<\/th>\n<th style=\"width: 61.7021%; height: 24px;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 48px;\">\n<td style=\"width: 24.3517%; height: 48px;\"><code>version<\/code><\/td>\n<td style=\"width: 6.19209%; height: 48px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 48px;\"><em>the current version of the API<\/em><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 38.423%; height: 48px;\"><code>status_code<\/code><\/td>\n<td style=\"width: 1.75219%; height: 48px;\">integer<\/td>\n<td style=\"width: 61.2015%; height: 48px;\"><i>general status code<\/i><br \/>\nyou can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><br \/>\n<strong>Note:<\/strong> we strongly recommend designing a necessary system for handling related exceptional or error conditions<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>status_message<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>general informational message<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>time<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>execution time, seconds<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>cost<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>total <i>tasks<\/i> cost, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>tasks_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>tasks_error<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array returned with an error<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><strong><code>tasks<\/code><\/strong><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>array of tasks<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>id<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>task identifier<\/em><br \/>\n<strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\">UUID<\/a> format<\/strong><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 24.3517%; height: 48px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>status_code<\/code><\/td>\n<td style=\"width: 6.19209%; height: 48px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 48px;\"><em>status code of the task <\/em><br \/>\ngenerated by DataForSEO; can be within the following range: 10000-60000<br \/>\nyou can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>status_message<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>informational message of the task<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix-errors\/\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>time<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>execution time, seconds<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>cost<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>cost of the task, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>result_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of elements in the <code>result<\/code> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>path<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>URL path<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>data<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>contains the same parameters that you specified in the POST request<br \/>\n<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <strong><code>result<\/code><\/strong><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>array of results<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>keyword<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>keyword<br \/>\n<\/em><strong>keyword is returned with decoded %## (plus character &#8216;+&#8217; will be decoded to a space character)<\/strong><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>spell<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>correct spelling of the keyword<\/em><br \/>\n<strong>Note:<\/strong>if the keyword in the POST array appears to be misspelled, data will be returned for the correctly spelled keyword;<br \/>\nwe 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><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>location_code<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>location code in a POST array<\/em><br \/>\nif there is no data, then the value is\u00a0<code>null<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>language_code<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>language code in a POST array<\/em><br \/>\nif there is no data, then the value is\u00a0<code>null<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>search_partners<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">boolean<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>indicates whether data from partner networks included in the response<\/em><\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>competition<\/code><\/td>\n<td style=\"width: 6.19209%; height: 25px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 25px;\"><em>competition<\/em><br \/>\nrepresents the relative amount of competition associated with the given keyword in paid SERP only;<br \/>\nthis value is based on Google Ads data and can take the following values: <code>HIGH<\/code>, <code>MEDIUM<\/code>, <code>LOW<\/code>;<br \/>\nif there is no data the value is <code>null<\/code>;<br \/>\nlearn 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><\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>competition_index<\/code><\/td>\n<td style=\"width: 6.19209%; height: 25px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 25px;\"><em>competition<\/em><br \/>\nrepresents the relative amount of competition associated with the given keyword in paid SERP only;<br \/>\nthis value is based on Google Ads data and can be between 0 and 100 (inclusive);<br \/>\nif there is no data the value is <code>null<\/code>;<br \/>\nlearn 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><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>search_volume<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>monthly average search volume rate;<br \/>\n<\/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 \/>\nif there is no data then the value is\u00a0<code>null<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>low_top_of_page_bid<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>minimum bid for the ad to be displayed at the top of the first page<\/em><br \/>\nindicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);<br \/>\nthe value may differ depending on the location specified in a POST request<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>high_top_of_page_bid<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>maximum bid for the ad to be displayed at the top of the first page<\/em><br \/>\nindicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers);<br \/>\nthe value may differ depending on the location specified in a POST request<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>cpc<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>cost per click<\/em><br \/>\nindicates the amount paid (USD) for each click on the ad displayed for a given keyword\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>monthly_searches<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>monthly searches<\/em><br \/>\nrepresents 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 \/>\nif there is no data then the value is\u00a0<code>null<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>year<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>year<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>month<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>month<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>search_volume<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>monthly average search volume rate<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\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":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","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":48,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/10506\/revisions"}],"predecessor-version":[{"id":23488,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/10506\/revisions\/23488"}],"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}]}}