{"id":19538,"date":"2024-08-21T10:17:33","date_gmt":"2024-08-21T10:17:33","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=19538"},"modified":"2026-07-16T15:40:09","modified_gmt":"2026-07-16T15:40:09","slug":"keywords_data-clickstream_data-dataforseo_search_volume-live","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/keywords_data-clickstream_data-dataforseo_search_volume-live\/","title":{"rendered":"keywords_data\/clickstream_data\/dataforseo_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;DataForSEO Search Volume&#8217; Tasks<\/h2>\n<p>\u200c<\/p>\n<p>This endpoint will provide you with search volume normalized with Bing search volume data or clickstream data for up to 1000 keywords in a single request.<\/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\/clickstream_data\/dataforseo_search_volume\/live\">\n                https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/dataforseo_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\/clickstream-api-pricing\" 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><strong>Note that you can send no more than 12 requests per minute per account due certain limitations beyond our control.<\/strong><\/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>target keywords<\/em><br \/>\n<strong>required field<\/strong><br \/>\nUTF-8 encoding<br \/>\nmaximum number of keywords you can specify in this array: 1000<br \/>\nthe keywords will be converted to lowercase format<\/p>\n<p><strong>Note:<\/strong> certain symbols and characters (e.g., UTF symbols, emojis) are not allowed<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 \/>\n<strong>required field if you don\u2019t specify <code>location_code <\/code><\/strong><br \/>\nyou can receive the list of available locations with <code>location_name<\/code> by making a separate request to <code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/locations_and_languages<\/code><br \/>\nexample:<br \/>\n<code class=\"long-string\">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 \/>\n<strong>required field if you don\u2019t specify <code>location_name<\/code><\/strong><br \/>\nif you use this field, you can receive the list of available locations with <code>location_code<\/code> by making a separate request to the <code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/locations_and_languages<\/code><br \/>\nexample:<br \/>\n<code class=\"long-string\">2826<\/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 \/>\n<strong>required field if don\u2019t specify <code>language_code<\/code><\/strong><br \/>\nyou can receive the list of available languages with their <code>language_name<\/code> by making a separate request to the <code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/locations_and_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 \/>\n<strong>required field if don\u2019t specify <code>language_name<\/code><\/strong><br \/>\nyou can receive the list of available languages with their <code>language_code<\/code> by making a separate request to the <code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/locations_and_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>use_clickstream<\/code><\/td>\n<td style=\"width: 3.91588%; height: 77px;\">boolean<\/td>\n<td style=\"width: 82.9587%; height: 77px;\"><em>use clickstream data to provide results<\/em><br \/>\noptional field<br \/>\nif set to <code>true<\/code>, you will get DataForSEO search volume values based on clickstream data;<br \/>\nif set to <code>false<\/code>, Bing search volume data will be used to calculate DataForSEO search volume;<br \/>\ndefault value: <code>true<\/code>;<br \/>\n<strong>Note:<\/strong> Bing search volume is available for locations provided in <a href=\"https:\/\/docs.dataforseo.com\/v3\/keywords_data\/bing\/search_volume_history\/locations_and_languages\/?bash\" rel=\"noopener noreferrer\" target=\"_blank\">Bing Search Volume History Locations<\/a> and <a href=\"https:\/\/docs.dataforseo.com\/v3\/keywords_data\/bing\/locations\/?bash\" rel=\"noopener noreferrer\" target=\"_blank\">Bing Ads Locations<\/a> endpoints; search volume values for any other location are calculated based on clickstream data even if you set this parameter to <code>false<\/code>\n<\/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> object 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>location_code<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/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 <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<br \/>\n<\/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>items_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>ithe number of results returned in the <code>items<\/code> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 25px;\">\n<td style=\"width: 24.3517%; height: 25px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>items<\/code><\/td>\n<td style=\"width: 6.19209%; height: 25px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 25px;\"><em>array of keywords<\/em><br \/>\ncontains keywords and their search volume rates<\/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>keyword<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>keyword provided in the POST array<\/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>use_clickstream<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">boolean<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>indicates if the <code>use_clickstream<\/code> parameter is active<\/em><br \/>\npossible values: <code>true<\/code>, <code>false<\/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>search_volume<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>current search volume rate of a keyword<\/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>monthly_searches<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>monthly search volume rates<\/em><br \/>\narray of objects with search volume rates in a certain month of a year<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \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 \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 \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>search volume rate in a certain month of a year<\/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\/clickstream_data\/dataforseo_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;language_code&quot;: &quot;en&quot;,\r\n    &quot;tag&quot;: &quot;test-tag&quot;,\r\n    &quot;keywords&quot;: [\r\n      &quot;you tube&quot;,\r\n      &quot;youtube&quot;,\r\n      &quot;youtub&quot;\r\n    ]\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\n\/\/ Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access\r\n$client = new RestClient($api_url, null, &#039;login&#039;, &#039;password&#039;);\r\n\r\n$post_array = array();\r\n\/\/ simple way to set a task\r\n$post_array[] = array(\r\n\t&quot;keywords&quot; =&gt; [\r\n        &quot;you tube&quot;,\r\n        &quot;youtube&quot;,\r\n        &quot;youtub&quot;\r\n\t],\r\n\t&quot;language_name&quot; =&gt; &quot;English&quot;,\r\n\t&quot;location_code&quot; =&gt; 2840\r\n);\r\ntry {\r\n\t\/\/ POST \/v3\/keywords_data\/clickstream_data\/dataforseo_search_volume\/live\r\n\t$result = $client-&gt;post(&#039;\/v3\/keywords_data\/clickstream_data\/dataforseo_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\">var request = require(&#039;request&#039;);\r\nvar options = {\r\n  &#039;method&#039;: &#039;POST&#039;,\r\n  &#039;url&#039;: &#039;https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/dataforseo_search_volume\/live&#039;,\r\n  &#039;headers&#039;: {\r\n    &#039;Authorization&#039;: &#039;Basic c3VwcG9ydEBkYXRhZm9yc2VvLmNvbTpTUnJYVHp2UGtFSjgzdXlz&#039;,\r\n    &#039;Content-Type&#039;: &#039;application\/json&#039;,\r\n    &#039;User-Agent&#039;: &#039;test&#039;\r\n  },\r\n  body: JSON.stringify([\r\n    {\r\n      &quot;location_code&quot;: 2840,\r\n      &quot;language_code&quot;: &quot;en&quot;,\r\n      &quot;tag&quot;: &quot;test-tag&quot;,\r\n      &quot;keywords&quot;: [\r\n        &quot;you tube&quot;,\r\n        &quot;youtube&quot;,\r\n        &quot;youtub&quot;\r\n      ]\r\n    }\r\n  ])\r\n\r\n};\r\nrequest(options, function (error, response) {\r\n  if (error) throw new Error(error);\r\n  console.log(response.body);\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    keywords=[\r\n        &quot;you tube&quot;,\r\n        &quot;youtube&quot;,\r\n        &quot;youtub&quot;\r\n    ],\r\n    location_name=&quot;United States&quot;,\r\n    language_name=&quot;English&quot;\r\n)\r\n# POST \/v3\/keywords_data\/clickstream_data\/dataforseo_search_volume\/live\r\nresponse = client.post(&quot;\/v3\/keywords_data\/clickstream_data\/dataforseo_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_clickstream_data_dataforseo_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                keywords = new[]\r\n                {\r\n                    &quot;you tube&quot;,\r\n                    &quot;youtube&quot;,\r\n                    &quot;youtub&quot;\r\n                },\r\n                location_name = &quot;United States&quot;,\r\n                language_name = &quot;English&quot;\r\n            });\r\n            \/\/ POST \/v3\/keywords_data\/clickstream_data\/dataforseo_search_volume\/live\r\n            \/\/ the full list of possible parameters is available in documentation\r\n\r\n            var taskPostResponse = await httpClient.PostAsync(&quot;\/v3\/keywords_data\/clickstream_data\/dataforseo_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.20240801&quot;,\r\n  &quot;status_code&quot;: 20000,\r\n  &quot;status_message&quot;: &quot;Ok.&quot;,\r\n  &quot;time&quot;: &quot;3.6964 sec.&quot;,\r\n  &quot;cost&quot;: 0.15,\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;08021312-1535-0589-0000-c36efd4ad04e&quot;,\r\n      &quot;status_code&quot;: 20000,\r\n      &quot;status_message&quot;: &quot;Ok.&quot;,\r\n      &quot;time&quot;: &quot;3.6322 sec.&quot;,\r\n      &quot;cost&quot;: 0.15,\r\n      &quot;result_count&quot;: 1,\r\n      &quot;path&quot;: [\r\n        &quot;v3&quot;,\r\n        &quot;keywords_data&quot;,\r\n        &quot;clickstream_data&quot;,\r\n        &quot;dataforseo_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;dataforseo_search_volume&quot;,\r\n        &quot;se&quot;: &quot;clickstream_data&quot;,\r\n        &quot;location_code&quot;: 2840,\r\n        &quot;language_code&quot;: &quot;en&quot;,\r\n        &quot;use_clickstream&quot;: true,\r\n        &quot;tag&quot;: &quot;test-tag&quot;,\r\n        &quot;keywords&quot;: [\r\n          &quot;you tube&quot;,\r\n          &quot;youtube&quot;,\r\n          &quot;youtub&quot;\r\n        ]\r\n      },\r\n      &quot;result&quot;: [\r\n        {\r\n          &quot;location_code&quot;: 2840,\r\n          &quot;language_code&quot;: &quot;en&quot;,\r\n          &quot;items_count&quot;: 3,\r\n          &quot;items&quot;: [\r\n            {\r\n              &quot;keyword&quot;: &quot;you tube&quot;,\r\n              &quot;use_clickstream&quot;: true,\r\n              &quot;search_volume&quot;: 3841450,\r\n              &quot;monthly_searches&quot;: [\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 6,\r\n                  &quot;search_volume&quot;: 4850027\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 5,\r\n                  &quot;search_volume&quot;: 5791200\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 4,\r\n                  &quot;search_volume&quot;: 5063908\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 3,\r\n                  &quot;search_volume&quot;: 4057639\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 2,\r\n                  &quot;search_volume&quot;: 3499745\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 1,\r\n                  &quot;search_volume&quot;: 4948844\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 12,\r\n                  &quot;search_volume&quot;: 4167276\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 11,\r\n                  &quot;search_volume&quot;: 3252548\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 10,\r\n                  &quot;search_volume&quot;: 4372437\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 9,\r\n                  &quot;search_volume&quot;: 3322543\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 8,\r\n                  &quot;search_volume&quot;: 4070665\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 7,\r\n                  &quot;search_volume&quot;: 3424434\r\n                }\r\n              ]\r\n            },\r\n            {\r\n              &quot;keyword&quot;: &quot;youtube&quot;,\r\n              &quot;use_clickstream&quot;: true,\r\n              &quot;search_volume&quot;: 141457261,\r\n              &quot;monthly_searches&quot;: [\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 6,\r\n                  &quot;search_volume&quot;: 161581931\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 5,\r\n                  &quot;search_volume&quot;: 200944345\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 4,\r\n                  &quot;search_volume&quot;: 189930752\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 3,\r\n                  &quot;search_volume&quot;: 167179529\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 2,\r\n                  &quot;search_volume&quot;: 131840294\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 1,\r\n                  &quot;search_volume&quot;: 186755632\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 12,\r\n                  &quot;search_volume&quot;: 179034394\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 11,\r\n                  &quot;search_volume&quot;: 144365840\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 10,\r\n                  &quot;search_volume&quot;: 185597392\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 9,\r\n                  &quot;search_volume&quot;: 143876762\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 8,\r\n                  &quot;search_volume&quot;: 171954692\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 7,\r\n                  &quot;search_volume&quot;: 131361848\r\n                }\r\n              ]\r\n            },\r\n            {\r\n              &quot;keyword&quot;: &quot;youtub&quot;,\r\n              &quot;use_clickstream&quot;: true,\r\n              &quot;search_volume&quot;: 401067,\r\n              &quot;monthly_searches&quot;: [\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 6,\r\n                  &quot;search_volume&quot;: 456295\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 5,\r\n                  &quot;search_volume&quot;: 560123\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 4,\r\n                  &quot;search_volume&quot;: 557952\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 3,\r\n                  &quot;search_volume&quot;: 517788\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 2,\r\n                  &quot;search_volume&quot;: 368580\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 1,\r\n                  &quot;search_volume&quot;: 536242\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 12,\r\n                  &quot;search_volume&quot;: 529729\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 11,\r\n                  &quot;search_volume&quot;: 393389\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 10,\r\n                  &quot;search_volume&quot;: 513446\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 9,\r\n                  &quot;search_volume&quot;: 388073\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 8,\r\n                  &quot;search_volume&quot;: 383185\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 7,\r\n                  &quot;search_volume&quot;: 329596\r\n                }\r\n              ]\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;DataForSEO Search Volume&#8217; Tasks \u200c This endpoint will provide you with search volume normalized with Bing search volume data or clickstream data for up to 1000 keywords in a single request. [\/vc_column_text] POST https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/dataforseo_search_volume\/live Pricing Your account will be charged for each request. The cost can be calculated on the Pricing page. [&hellip;]<\/p>\n","protected":false},"author":14,"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-19538","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/19538","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\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=19538"}],"version-history":[{"count":29,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/19538\/revisions"}],"predecessor-version":[{"id":24776,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/19538\/revisions\/24776"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=19538"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}