{"id":19622,"date":"2024-08-20T15:16:02","date_gmt":"2024-08-20T15:16:02","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=19622"},"modified":"2024-10-01T14:48:55","modified_gmt":"2024-10-01T14:48:55","slug":"keywords_data-clickstream_data-bulk_search_volume-live","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/keywords_data-clickstream_data-bulk_search_volume-live\/","title":{"rendered":"keywords_data\/clickstream_data\/bulk_search_volume\/live"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h2 id=\"kwrd-clickstream-data-bulk-sv\">Setting Live \u2018Bulk Clickstream Search Volume\u2019 Tasks<\/h2>\n<p>\u200c\u200c&nbsp;<br \/>\nThe Bulk Clickstream Search Volume endpoint of DataForSEO Keywords Data API is designed to provide clickstream-based search volume data for up to 1000 keywords in a single Live request. What&#8217;s more, it offers historical search volume values for up to 12 months (depending on keywords, location, and language parameters).<\/p>\n<p>You can learn more about this endpoint in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-clickstream-search-volume-and-how-to-get-it-with-dataforseo\">this Help Center article<\/a>. <\/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\/bulk_search_volume\/live\">\n                https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/bulk_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. The maximum number of requests that can be sent simultaneously is limited to 30.<\/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 \/>\neach keyword should be at least 3 characters long;<br \/>\nthe keywords will be converted to lowercase format;<br \/>\n<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 the location<\/em><br \/>\n<strong>required field if you don&#8217;t specify<\/strong> <code>location_code<\/code><br \/>\n<strong>Note:<\/strong> it is required to specify either <code>location_name<\/code> or <code>location_code<\/code><br \/>\nyou can receive the list of available locations with their <code>location_name<\/code> by making a separate request to the<br \/>\n<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>location code<\/em><br \/>\n<strong>required field if you don&#8217;t specify<\/strong> <code>location_name<\/code><br \/>\n<strong>Note:<\/strong> it is required to specify either <code>location_name<\/code> or <code>location_code<\/code><br \/>\nyou can receive the list of available locations with their <code>location_code<\/code> by making a separate request to the<br \/>\n<code>https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/locations_and_languages<\/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>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<\/p>\n<p>As a response of the API server, you will receive <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON\">JSON<\/a>-encoded data containing a <code>tasks<\/code> array with the information specific to the set tasks.<\/p>\n<p><strong>Description of the fields in the results array:<\/strong><\/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;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>contains the same parameters that you specified in the POST request<\/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;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>location code in a 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 <code>items_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 results returned in the <code>items<\/code> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code><strong>items<\/strong><\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>contains keywords and related data<\/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>keyword<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>keyword<\/em><br \/>\n<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 \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>clickstream-based average monthly search volume rate<\/em><br \/>\nrepresents the (approximate) number of searches for the given keyword idea based on clickstream<br \/>\nyou can learn more about clickstream search volume in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-clickstream-search-volume-and-how-to-get-it-with-dataforseo\">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 \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), targeted to the specified geographic locations<\/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>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 &quot;https:\/\/api.dataforseo.com\/v3\/keywords_data\/clickstream_data\/bulk_search_volume\/live&quot; \r\n--header &quot;Authorization: Basic c3VwcG9ydEBkYXRhZm9yc2VvLmNvbTpTUnJYVHp2UGtFSjgzdXlz&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;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;location_name&quot; =&gt; &quot;United States&quot;,\r\n\t&quot;keywords&quot; =&gt; array(\r\n        &quot;you tube&quot;,\r\n        &quot;youtube&quot;,\r\n        &quot;youtub&quot;\r\n\t)\r\n);\r\ntry {\r\n\t\/\/ POST \/v3\/keywords_data\/clickstream_data\/bulk_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\/clickstream_data\/bulk_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;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\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\/clickstream_data\/bulk_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_name=&quot;United States&quot;,\r\n    keywords=[\r\n        &quot;you tube&quot;,\r\n        &quot;youtube&quot;,\r\n        &quot;youtub&quot;\r\n    ]\r\n)\r\n# POST \/v3\/keywords_data\/clickstream_data\/bulk_search_volume\/live\r\n# the full list of possible parameters is available in documentation\r\nresponse = client.post(&quot;\/v3\/keywords_data\/clickstream_data\/bulk_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_bulk_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_name = &quot;United States&quot;,\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            });\r\n            \/\/ POST \/v3\/keywords_data\/clickstream_data\/bulk_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\/clickstream_data\/bulk_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;0.3889 sec.&quot;,\r\n  &quot;cost&quot;: 0.0103,\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;08201437-1535-0591-0000-e179eb1fba5f&quot;,\r\n      &quot;status_code&quot;: 20000,\r\n      &quot;status_message&quot;: &quot;Ok.&quot;,\r\n      &quot;time&quot;: &quot;0.3607 sec.&quot;,\r\n      &quot;cost&quot;: 0.0103,\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;bulk_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;bulk_search_volume&quot;,\r\n        &quot;se&quot;: &quot;clickstream_data&quot;,\r\n        &quot;location_code&quot;: 2840,\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;items_count&quot;: 3,\r\n          &quot;items&quot;: [\r\n            {\r\n              &quot;keyword&quot;: &quot;youtub&quot;,\r\n              &quot;search_volume&quot;: 418780,\r\n              &quot;monthly_searches&quot;: [\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 7,\r\n                  &quot;search_volume&quot;: 418780\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 6,\r\n                  &quot;search_volume&quot;: 439710\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 5,\r\n                  &quot;search_volume&quot;: 436562\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 4,\r\n                  &quot;search_volume&quot;: 438434\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 3,\r\n                  &quot;search_volume&quot;: 437668\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 2,\r\n                  &quot;search_volume&quot;: 443624\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 1,\r\n                  &quot;search_volume&quot;: 445666\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 12,\r\n                  &quot;search_volume&quot;: 440136\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 11,\r\n                  &quot;search_volume&quot;: 431861\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 10,\r\n                  &quot;search_volume&quot;: 425703\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 9,\r\n                  &quot;search_volume&quot;: 420420\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 8,\r\n                  &quot;search_volume&quot;: 413230\r\n                }\r\n              ]\r\n            },\r\n            {\r\n              &quot;keyword&quot;: &quot;you tube&quot;,\r\n              &quot;search_volume&quot;: 3986664,\r\n              &quot;monthly_searches&quot;: [\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 7,\r\n                  &quot;search_volume&quot;: 3986664\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 6,\r\n                  &quot;search_volume&quot;: 4207200\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 5,\r\n                  &quot;search_volume&quot;: 4130370\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 4,\r\n                  &quot;search_volume&quot;: 4152322\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 3,\r\n                  &quot;search_volume&quot;: 4224472\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 2,\r\n                  &quot;search_volume&quot;: 4355926\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 1,\r\n                  &quot;search_volume&quot;: 4445689\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 12,\r\n                  &quot;search_volume&quot;: 4525497\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 11,\r\n                  &quot;search_volume&quot;: 4520329\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 10,\r\n                  &quot;search_volume&quot;: 4530924\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 9,\r\n                  &quot;search_volume&quot;: 4560702\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 8,\r\n                  &quot;search_volume&quot;: 4593340\r\n                }\r\n              ]\r\n            },\r\n            {\r\n              &quot;keyword&quot;: &quot;youtube&quot;,\r\n              &quot;search_volume&quot;: 157924192,\r\n              &quot;monthly_searches&quot;: [\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 7,\r\n                  &quot;search_volume&quot;: 157924192\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 6,\r\n                  &quot;search_volume&quot;: 166762144\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 5,\r\n                  &quot;search_volume&quot;: 164564010\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 4,\r\n                  &quot;search_volume&quot;: 164449749\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 3,\r\n                  &quot;search_volume&quot;: 163587594\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 2,\r\n                  &quot;search_volume&quot;: 164803434\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2024,\r\n                  &quot;month&quot;: 1,\r\n                  &quot;search_volume&quot;: 166157109\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 12,\r\n                  &quot;search_volume&quot;: 164706784\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 11,\r\n                  &quot;search_volume&quot;: 162002013\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 10,\r\n                  &quot;search_volume&quot;: 159212953\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 9,\r\n                  &quot;search_volume&quot;: 157132117\r\n                },\r\n                {\r\n                  &quot;year&quot;: 2023,\r\n                  &quot;month&quot;: 8,\r\n                  &quot;search_volume&quot;: 154116528\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 \u2018Bulk Clickstream Search Volume\u2019 Tasks \u200c\u200c&nbsp; The Bulk Clickstream Search Volume endpoint of DataForSEO Keywords Data API is designed to provide clickstream-based search volume data for up to 1000 keywords in a single Live request. What&#8217;s more, it offers historical search volume values for up to 12 months (depending on keywords, location, [&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-19622","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/19622","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=19622"}],"version-history":[{"count":21,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/19622\/revisions"}],"predecessor-version":[{"id":20060,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/19622\/revisions\/20060"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=19622"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}