{"id":12982,"date":"2022-03-08T16:22:24","date_gmt":"2022-03-08T16:22:24","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=12982"},"modified":"2026-07-29T16:55:18","modified_gmt":"2026-07-29T16:55:18","slug":"dataforseo_labs-google-top_searches-live","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/dataforseo_labs-google-top_searches-live\/","title":{"rendered":"dataforseo_labs\/google\/top_searches\/live"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h2 id=\"live-serp\">Top Searches<\/h2>\n<p>\u200c\u200c<br \/>\nThe Top Searches endpoint of DataForSEO Labs API can provide you with over 7 billion keywords from the <a href=\"https:\/\/dataforseo.com\/databases\/keywords-database\" rel=\"noopener noreferrer\" target=\"_blank\">DataForSEO Keyword Database<\/a>. Each keyword in the API response is provided with a set of relevant keyword data with Google Ads metrics, product categories, and Google SERP data.   <\/p>\n<p>The working mechanism of this endpoint is different from others. To get over 1000 keywords, you will need to make several consecutive requests with the first one containing all the necessary parameters for making a request, such as limit, language and location codes. By specifying the unique <code>offset_token<\/code> received in the response to the first request, you will be able to get another batch of up to 1000 keywords along with another <code>offset_token<\/code>. By leveraging this system of consecutive requests, you can gradually dump all the data you need from our keyword database. <\/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\/dataforseo_labs\/google\/top_searches\/live\">\n                https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/google\/top_searches\/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\/dataforseo-labs\/dataforseo-google-api\" 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. The maximum number of calls that can be sent simultaneously is limited to 30.<\/p>\n<p>You can specify the number of results you want to retrieve, filter and sort them.<\/p>\n<p>Below you will find a detailed description of the fields you can use for setting a task.<\/p>\n<p><strong>Description of the fields for setting a task:<\/strong><br \/>\n<div class=\"dfs-doc-container dfs-doc-request\"><table><thead><tr><th>Field name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr data-doc-id=\"location_name\"><td><code>location_name<\/code><\/td><td>string<\/td><td><p><em>full name of the location<\/em><br><strong>required field if you don't specify<\/strong> <code>location_code<\/code><br><strong>Note:<\/strong> it is required to specify either <code>location_name<\/code> or <code>location_code<\/code><br>you can receive the list of available locations with their <code>location_name<\/code> by making a separate request to the <br><code><a href=\"https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages\">https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/a><\/code><br>example:<br><code class=\"long-string\">United Kingdom<\/code><\/p><\/td><\/tr><tr data-doc-id=\"location_code\"><td><code>location_code<\/code><\/td><td>integer<\/td><td><p><em>location code<\/em><br><strong>required field if you don't specify<\/strong> <code>location_name<\/code><br><strong>Note:<\/strong> it is required to specify either <code>location_name<\/code> or <code>location_code<\/code><br>you can receive the list of available locations with their <code>location_code<\/code> by making a separate request to the <br><code><a href=\"https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages\">https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/a><\/code><br>example:<br><code class=\"long-string\">2840<\/code><\/p><\/td><\/tr><tr data-doc-id=\"language_name\"><td><code>language_name<\/code><\/td><td>string<\/td><td><p><em>full name of the language<\/em><br><strong>required field if you don't specify<\/strong> <code>language_code<\/code><br><strong>Note:<\/strong> it is required to specify either <code>language_name<\/code> or <code>language_code<\/code><br>you can receive the list of available locations with their <code>language_name<\/code> by making a separate request to the <br><code><a href=\"https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages\">https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/a><\/code><br>example:<br><code class=\"long-string\">English<\/code><\/p><\/td><\/tr><tr data-doc-id=\"language_code\"><td><code>language_code<\/code><\/td><td>string<\/td><td><p><em>language code<\/em><br><strong>required field if you don't specify<\/strong> <code>language_name<\/code><br><strong>Note:<\/strong> it is required to specify either <code>language_name<\/code> or <code>language_code<\/code><br>you can receive the list of available locations with their <code>language_code<\/code> by making a separate request to the <br><code><a href=\"https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages\">https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/a><\/code><br>example:<br><code class=\"long-string\">en<\/code><\/p><\/td><\/tr><tr data-doc-id=\"include_serp_info\"><td><code>include_serp_info<\/code><\/td><td>boolean<\/td><td><p><em>include data from SERP for each keyword<\/em><br>optional field<br>if set to <code>true<\/code>, we will return a <code>serp_info<\/code> array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response<br>default value: <code>false<\/code><\/p><\/td><\/tr><tr data-doc-id=\"include_clickstream_data\"><td><code>include_clickstream_data<\/code><\/td><td>boolean<\/td><td><p><em>include or exclude data from clickstream-based metrics in the result<\/em><br>optional field<br>if the parameter is set to <code>true<\/code>, you will receive <code>clickstream_keyword_info<\/code>, <code>keyword_info_normalized_with_clickstream<\/code>, and <code>keyword_info_normalized_with_bing<\/code> fields in the response<br>default value: <code>false<\/code><br>with this parameter enabled, you will be charged double the price for the request<p>learn more about how clickstream-based metrics are calculated in this <a href=\"https:\/\/dataforseo.com\/help-center\/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"ignore_synonyms\"><td><code>ignore_synonyms<\/code><\/td><td>boolean<\/td><td><p><em>ignore highly similar keywords<\/em><br>optional field<br>if set to <code class=\"prettyprint\">true<\/code> only core keywords will be returned, all highly similar keywords will be excluded;  <br>default value: <code>false<\/code><\/p><\/td><\/tr><tr data-doc-id=\"filters\"><td><code>filters<\/code><\/td><td>array<\/td><td><p><em>array of results filtering parameters<\/em><br>optional field<br><strong>you can add several filters at once (8 filters maximum)<\/strong><br>you should set a logical operator <code>and<\/code>, <code>or<\/code> between the conditions<br>the following operators are supported:<br><code>regex<\/code>, <code>not_regex<\/code>, <code><<\/code>, <code><=<\/code>, <code>><\/code>, <code>>=<\/code>, <code>=<\/code>, <code><><\/code>, <code>in<\/code>, <code>not_in<\/code>, <code>match<\/code>, <code>not_match<\/code>, <code>ilike<\/code>, <code>not_ilike<\/code>, <code>like<\/code>,<code>not_like<\/code><br>you can use the <code>%<\/code> operator with <code>like<\/code> and <code>not_like<\/code>,as well as <code>ilike<\/code> and <code>not_ilike<\/code> to match any string of zero or more characters<br>example:<br><code>[\"keyword_info.search_volume\",\">\",0]<\/code><p><code>[[\"keyword_info.search_volume\",\"in\",[0,1000]],<br>\"and\",<br>[\"keyword_info.competition_level\",\"=\",\"LOW\"]]<\/code><p><code>[[\"keyword_info.search_volume\",\">\",100],<br>\"and\",<br>[[\"keyword_info.cpc\",\"<\",0.5],<br>\"or\",<p>[\"keyword_info.high_top_of_page_bid\",\"<=\",0.5]]]<\/code><br>for more information about filters, please refer to <a href=\"\/v3\/dataforseo_labs\/filters\" target=\"_blank\" rel=\"noopener noreferrer\">Dataforseo Labs - Filters<\/a> or this <a href=\"https:\/\/dataforseo.com\/help-center\/how-to-use-filters-in-dataforseo-labs-api\" rel=\"noopener noreferrer\" target=\"_blank\">help center guide<\/a><\/p><\/td><\/tr><tr data-doc-id=\"order_by\"><td><code>order_by<\/code><\/td><td>array<\/td><td><p><em>results sorting rules<\/em><br>optional field<br>you can use the same values as in the <code>filters<\/code> array to sort the results<br>possible sorting types:<br><code>asc<\/code> - results will be sorted in the ascending order<br><code>desc<\/code> - results will be sorted in the descending order<br>you should use a comma to set up a sorting type<br>example:<br><code>[\"keyword_info.competition,desc\"]<\/code><br>default rule:<br><code>[\"keyword_info.search_volume,desc\"]<\/code><br><strong>note that you can set no more than three sorting rules in a single request<\/strong><br>you should use a comma to separate several sorting rules<br>example:<br><code>[\"keyword_info.search_volume,desc\",\"keyword_info.cpc,desc\"]<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tag\"><td><code>tag<\/code><\/td><td>string<\/td><td><p><em>user-defined task identifier<\/em><br>optional field<br><em>the character limit is 255<\/em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag<\/code> value in the <code>data<\/code> object of the response<\/p><\/td><\/tr><tr data-doc-id=\"limit\"><td><code>limit<\/code><\/td><td>integer<\/td><td><p><em>the maximum number of returned keywords<\/em><br>optional field<br><\/strong>note:<\/strong> you can get more than 1000 results by using the <code>offset_token<\/code> provided in the response to each subsequent request<br>default value: <code>1000<\/code><br>maximum value: <code>1000<\/code><\/p><\/td><\/tr><tr data-doc-id=\"offset\"><td><code>offset<\/code><\/td><td>integer<\/td><td><p><em>offset in the results array of returned keywords<\/em><br>optional field<br>default value: <code>0<\/code><br>if you specify the <code>10<\/code> value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords<br><strong>Note:<\/strong> we recommend using this parameter only when retrieving up to 10,000 results<br>for retrieving over 10,000 results, use the <code>offset_token<\/code> instead.<\/p><\/td><\/tr><tr data-doc-id=\"offset_token\"><td><code>offset_token<\/code><\/td><td>string<\/td><td><p><em>offset token for subsequent requests<\/em><br>optional field<br>provided in the identical filed of the response to each request;<br>use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;<br>by specifying the unique <code>offset_token<\/code> value from the response array, you will get the subsequent results of the initial task;<br><code>offset_token<\/code> values are unique for each subsequent task <br><strong>Note:<\/strong> if the <code>offset_token<\/code> is specified in the request, all other parameters except <code>limit<\/code> will not be taken into account when processing a task.<br>learn more about this parameter on our <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-the-difference-between-the-offset-and-offset_token-parameters#offset_token\" target=\"_blank\">Help Center<\/a><\/p><\/td><\/tr><\/tbody><\/table><\/div><br \/>\n\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><br \/>\n<div class=\"dfs-doc-container dfs-doc-response\"><div class=\"api-block-main\"><div class=\"api-section\"><table><thead><tr><th>Field name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr data-doc-id=\"version\"><td><code>version<\/code><\/td><td>string<\/td><td><p><em>the current version of the API<\/em><\/p><\/td><\/tr><tr data-doc-id=\"status_code\"><td><code>status_code<\/code><\/td><td>integer<\/td><td><p><i>general status code<\/i><br>you can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><br><strong>Note:<\/strong> we strongly recommend designing a necessary system for handling related exceptional or error conditions<\/p><\/td><\/tr><tr data-doc-id=\"status_message\"><td><code>status_message<\/code><\/td><td>string<\/td><td><p><em>general informational message<\/em><br>you can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a><\/p><\/td><\/tr><tr data-doc-id=\"time\"><td><code>time<\/code><\/td><td>string<\/td><td><p><em>execution time, seconds<\/em><\/p><\/td><\/tr><tr data-doc-id=\"cost\"><td><code>cost<\/code><\/td><td>float<\/td><td><p><em>total <i>tasks<\/i> cost, USD<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks_count\"><td><code>tasks_count<\/code><\/td><td>integer<\/td><td><p><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks_error\"><td><code>tasks_error<\/code><\/td><td>integer<\/td><td><p><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array returned with an error<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks\"><td><strong><code>tasks<\/code><\/strong><\/td><td>array<\/td><td><p><em>array of tasks<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-id\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>id<\/code><\/td><td>string<\/td><td><p><em>task identifier<\/em><br><strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\">UUID<\/a> format<\/strong><\/p><\/td><\/tr><tr data-doc-id=\"tasks-status_code\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>status_code<\/code><\/td><td>integer<\/td><td><p><em>status code of the task <\/em><br>generated by DataForSEO; can be within the following range: 10000-60000<br>you can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-status_message\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>status_message<\/code><\/td><td>string<\/td><td><p><em>informational message of the task<\/em><br>you can find the full list of general informational messages <a href=\"\/v3\/appendix-errors\/\">here<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>time<\/code><\/td><td>string<\/td><td><p><em>execution time, seconds<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-cost\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>cost<\/code><\/td><td>float<\/td><td><p><em>cost of the task, USD<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result_count\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>result_count<\/code><\/td><td>integer<\/td><td><p><em>number of elements in the <code>result<\/code> array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-path\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>path<\/code><\/td><td>array<\/td><td><p><em>URL path<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-data\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<code>data<\/code><\/td><td>object<\/td><td><p><em>contains the same parameters that you specified in the POST request<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>result<\/code><\/strong><\/td><td>array<\/td><td><p><em>array of results<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-se_type\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>se_type<\/code><\/td><td>string<\/td><td><p><em>search engine type<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-location_code\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>location_code<\/code><\/td><td>integer<\/td><td><p><em>location code in a POST array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-language_code\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>language_code<\/code><\/td><td>string<\/td><td><p><em>language code in a POST array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-total_count\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>total_count<\/code><\/td><td>integer<\/td><td><p><em>total amount of results in our database relevant to your request<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items_count\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>items_count<\/code><\/td><td>integer<\/td><td><p><em>the number of results returned in the <code>items<\/code> array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-offset\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>offset<\/code><\/td><td>integer<\/td><td><p><em>current offset value<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-offset_token\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>offset_token<\/code><\/td><td>string<\/td><td><p><em>offset token for subsequent requests<\/em><br>you can use the string provided in this field to get the subsequent results of the initial task;<br><strong>note:<\/strong> <code>offset_token<\/code> values are unique for each subsequent task<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>items<\/code><\/strong><\/td><td>array<\/td><td><p><em>contains keywords and related data<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-se_type\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>se_type<\/code><\/td><td>string<\/td><td><p><em>search engine type<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>keyword<\/code><\/td><td>string<\/td><td><p><em>keyword<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-location_code\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>location_code<\/code><\/td><td>integer<\/td><td><p><em>location code in a POST array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-language_code\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>language_code<\/code><\/td><td>string<\/td><td><p><em>language code in a POST array<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>keyword_info<\/code><\/strong><\/td><td>object<\/td><td><p><em>keyword data for the returned keyword<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-se_type\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>se_type<\/code><\/td><td>string<\/td><td><p><em>search engine type<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-last_updated_time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>last_updated_time<\/code><\/td><td>string<\/td><td><p><em>date and time when keyword data was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-competition\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>competition<\/code><\/td><td>float<\/td><td><p><em>competition<\/em><br>represents the relative amount of competition associated with the given keyword;<br>the value is based on Google Ads data and can be between 0 and 1 (inclusive)<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-competition_level\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>competition_level<\/code><\/td><td>string<\/td><td><p><em>competition level<\/em><br>represents the relative level of competition associated with the given keyword in paid SERP only;<br>possible values: <code>LOW<\/code>, <code>MEDIUM<\/code>, <code>HIGH<\/code><br>if competition level is unknown, the value is <code>null<\/code>;<br>learn more about the metric in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-competition\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-cpc\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>cpc<\/code><\/td><td>float<\/td><td><p><em>cost-per-click<\/em><br>represents the average cost per click (USD) historically paid for the keyword<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>average monthly search volume rate<\/em><br>represents the (approximate) number of searches for the given keyword idea on google.com<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-low_top_of_page_bid\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>low_top_of_page_bid<\/code><\/td><td>float<\/td><td><p><em>minimum bid for the ad to be displayed at the top of the first page<\/em><br>indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)<br>the value may differ depending on the location specified in a POST request<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-high_top_of_page_bid\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>high_top_of_page_bid<\/code><\/td><td>float<\/td><td><p><em>maximum bid for the ad to be displayed at the top of the first page<\/em><br>indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)<br>the value may differ depending on the location specified in a POST request<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-categories\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>categories<\/code><\/td><td>array<\/td><td><p><em>product and service categories<\/em><br>you can download the <a href=\"https:\/\/cdn.dataforseo.com\/v3\/categories\/categories_dataforseo_labs_2023_10_25.csv\">full list of possible categories<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-monthly_searches\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>monthly_searches<\/code><\/strong><\/td><td>array<\/td><td><p><em>monthly searches<\/em><br>represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-monthly_searches-year\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>year<\/code><\/td><td>integer<\/td><td><p><em>year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-monthly_searches-month\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>month<\/code><\/td><td>integer<\/td><td><p><em>month<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-monthly_searches-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>monthly average search volume rate<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-search_volume_trend\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>search_volume_trend<\/code><\/strong><\/td><td>object<\/td><td><p><em>search volume trend changes<\/em><br>represents search volume change in percent compared to the previous period<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-search_volume_trend-monthly\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>monthly<\/code><\/td><td>integer<\/td><td><p><em>search volume change in percent compared to the previous month<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-search_volume_trend-quarterly\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>quarterly<\/code><\/td><td>integer<\/td><td><p><em>search volume change in percent compared to the previous quarter<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info-search_volume_trend-yearly\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>yearly<\/code><\/td><td>integer<\/td><td><p><em>search volume change in percent compared to the previous year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>clickstream_keyword_info<\/code><\/strong><\/td><td>object<\/td><td><p><em>clickstream data for the returned keyword<\/em><br>to retrieve results for this field, the parameter <code>include_clickstream_data<\/code> must be set to <code>true<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>monthly average clickstream search volume rate<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-last_updated_time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>last_updated_time<\/code><\/td><td>string<\/td><td><p><em>date and time when the clickstream dataset was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-gender_distribution\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>gender_distribution<\/code><\/strong><\/td><td>object<\/td><td><p><em>distribution of estimated clickstream-based metrics by gender<\/em><br>learn more about how the metric is calculated in this <a href=\"https:\/\/dataforseo.com\/help-center\/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-gender_distribution-female\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>female<\/code><\/td><td>integer<\/td><td><p><em>number of female users in the relevant clickstream dataset<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-gender_distribution-male\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>male<\/code><\/td><td>integer<\/td><td><p><em>number of male users in the relevant clickstream dataset<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-age_distribution\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>age_distribution<\/code><\/strong><\/td><td>object<\/td><td><p><em>distribution of clickstream-based metrics by age<\/em><br>learn more about how the metric is calculated in this <a href=\"https:\/\/dataforseo.com\/help-center\/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-age_distribution-18-24\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>18-24<\/code><\/td><td>integer<\/td><td><p><em>number of users in the relevant clickstream dataset that fall within the 18-24 age range<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-age_distribution-25-34\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>25-34<\/code><\/td><td>integer<\/td><td><p><em>number of users in the relevant clickstream dataset that fall within the 25-34 age range<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-age_distribution-35-44\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>35-44<\/code><\/td><td>integer<\/td><td><p><em>number of users in the relevant clickstream dataset that fall within the 35-44 age range<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-age_distribution-45-54\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>45-54<\/code><\/td><td>integer<\/td><td><p><em>number of users in the relevant clickstream dataset that fall within the 45-54 age range<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-age_distribution-55-64\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>55-64<\/code><\/td><td>integer<\/td><td><p><em>number of users in the relevant clickstream dataset that fall within the 55-64 age range<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-monthly_searches\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>monthly_searches<\/code><\/strong><\/td><td>array<\/td><td><p><em>monthly clickstream search volume rates<\/em><br>array of objects with clickstream search volume rates in a certain month of a year<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-monthly_searches-year\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>year<\/code><\/td><td>integer<\/td><td><p><em>year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-monthly_searches-month\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>month<\/code><\/td><td>integer<\/td><td><p><em>month<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-clickstream_keyword_info-monthly_searches-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>clickstream-based search volume rate in a certain month of a year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_properties\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>keyword_properties<\/code><\/strong><\/td><td>object<\/td><td><p><em>additional information about the keyword<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_properties-se_type\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>se_type<\/code><\/td><td>string<\/td><td><p><em>search engine type<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_properties-core_keyword\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>core_keyword<\/code><\/td><td>string<\/td><td><p><em>main keyword in a group<\/em><br>contains the main keyword in a group determined by the synonym clustering algorithm<br>if the value is <code>null<\/code>, our database does not contain any keywords the corresponding algorithm could identify as synonymous with <code>keyword<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_properties-synonym_clustering_algorithm\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>synonym_clustering_algorithm<\/code><\/td><td>string<\/td><td><p><em>the algorithm used to identify synonyms<\/em><br>possible values: <br><code>keyword_metrics<\/code> - indicates the algorithm based on <code>keyword_info<\/code> parameters<br><code>text_processing<\/code> - indicates the text-based algorithm<br>if the value is <code>null<\/code>, our database does not contain any keywords the corresponding algorithm could identify as synonymous with <code>keyword<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_properties-keyword_difficulty\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>keyword_difficulty<\/code><\/td><td>integer<\/td><td><p><em>difficulty of ranking in the first top-10 organic results for a keyword<\/em><br>indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;<br>calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP;<br>learn more about the metric in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-keyword-difficulty-and-how-is-it-calculated\" rel=\"noopener noreferrer\" target=\"_blank\">this help center guide<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_properties-detected_language\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>detected_language<\/code><\/td><td>string<\/td><td><p><em>detected language of the keyword<\/em><br>indicates the language of the keyword as identified by our system<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_properties-is_another_language\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>is_another_language<\/code><\/td><td>boolean<\/td><td><p><em>detected language of the keyword is different from the set language<\/em><br>if <code>true<\/code>, the language set in the request does not match the language determined by our system for a given keyword<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_properties-words_count\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>words_count<\/code><\/td><td>integer<\/td><td><p><em>number of words in the keyword<\/em><br>indicates how many words the keyword consists of<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-serp_info\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>serp_info<\/code><\/strong><\/td><td>object<\/td><td><p><em>Google SERP data<\/em><br>the value will be <code>null<\/code> if you didn't set the field <code>include_serp_info<\/code> to <code>true<\/code> in the POST array or if there is no SERP data for this keyword in our database<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-serp_info-se_type\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>se_type<\/code><\/td><td>string<\/td><td><p><em>search engine type<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-serp_info-check_url\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>check_url<\/code><\/td><td>string<\/td><td><p><em>direct URL to search engine results<\/em><br>you can use it to make sure that we provided accurate results<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-serp_info-serp_item_types\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>serp_item_types<\/code><\/td><td>array<\/td><td><p><em>types of search results in SERP<\/em><br>contains types of search results (items) found in SERP<br>possible item types:<br><code>answer_box<\/code>, <code>app<\/code>, <code>carousel<\/code>, <code>multi_carousel<\/code>, <code>featured_snippet<\/code>, <code>google_flights<\/code>, <code>google_reviews<\/code>, <code>third_party_reviews<\/code>, <code>google_posts<\/code>, <code>images<\/code>, <code>jobs<\/code>, <code>knowledge_graph<\/code>, <code>local_pack<\/code>, <code>hotels_pack<\/code>, <code>map<\/code>, <code>organic<\/code>, <code>paid<\/code>, <code>people_also_ask<\/code>, <code>related_searches<\/code>, <code>people_also_search<\/code>, <code>shopping<\/code>, <code>top_stories<\/code>, <code>twitter<\/code>, <code>video<\/code>, <code>events<\/code>, <code>mention_carousel<\/code>, <code>recipes<\/code>, <code>top_sights<\/code>, <code>scholarly_articles<\/code>, <code>popular_products<\/code>, <code>podcasts<\/code>, <code>questions_and_answers<\/code>, <code>find_results_on<\/code>, <code>stocks_box<\/code>, <code>visual_stories<\/code>, <code>commercial_units<\/code>, <code>local_services<\/code>, <code>google_hotels<\/code>, <code>math_solver<\/code>, <code>currency_box<\/code>, <code>product_considerations<\/code>, <code>found_on_web<\/code>, <code>short_videos<\/code>, <code>refine_products<\/code>, <code>explore_brands<\/code>, <code>perspectives<\/code>, <code>discussions_and_forums<\/code>, <code>compare_sites<\/code>, <code>courses<\/code>, <code>ai_overview<\/code>;<br><strong>note<\/strong> that the actual results will be returned only for <code>organic<\/code>, <code>paid<\/code>, <code>featured_snippet<\/code>, and <code>local_pack<\/code> elements<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-serp_info-se_results_count\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>se_results_count<\/code><\/td><td>integer<\/td><td><p><em>number of search results for the returned keyword<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-serp_info-last_updated_time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>last_updated_time<\/code><\/td><td>string<\/td><td><p><em>date and time when SERP data was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>avg_backlinks_info<\/code><\/strong><\/td><td>object<\/td><td><p><em>backlink data for the returned keyword<\/em><br>this object provides the average number of backlinks, referring pages and domains, as well as the average rank values among the top-10 webpages ranking organically for the keyword<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-se_type\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>se_type<\/code><\/td><td>string<\/td><td><p><em>search engine type<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-backlinks\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>backlinks<\/code><\/td><td>float<\/td><td><p><em>average number of backlinks<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-dofollow\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>dofollow<\/code><\/td><td>float<\/td><td><p><em>average number of dofollow links<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-referring_pages\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>referring_pages<\/code><\/td><td>float<\/td><td><p><em>average number of referring pages<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-referring_domains\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>referring_domains<\/code><\/td><td>float<\/td><td><p><em>average number of referring domains<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-referring_main_domains\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>referring_main_domains<\/code><\/td><td>float<\/td><td><p><em>average number of referring main domains<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-rank\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>rank<\/code><\/td><td>float<\/td><td><p><em>average rank<\/em><br>learn more about the metric and its calculation formula in <a href=\"https:\/\/dataforseo.com\/help-center\/what_is_rank_in_backlinks_api\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-main_domain_rank\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>main_domain_rank<\/code><\/td><td>float<\/td><td><p><em>average main domain rank<\/em><br>learn more about the metric and its calculation formula in <a href=\"https:\/\/dataforseo.com\/help-center\/what_is_rank_in_backlinks_api\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-avg_backlinks_info-last_updated_time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>last_updated_time<\/code><\/td><td>string<\/td><td><p><em>date and time when backlink data was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-search_intent_info\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>search_intent_info<\/code><\/strong><\/td><td>object<\/td><td><p><em>search intent info for the returned keyword<\/em><br>learn about search intent in this <a href=\"https:\/\/dataforseo.com\/help-center\/search-intent-and-its-types\" rel=\"noopener noreferrer\" target=\"_blank\">help center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-search_intent_info-se_type\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>se_type<\/code><\/td><td>string<\/td><td><p><em>search engine type<\/em><br>possible values: <code>google<\/code><\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-search_intent_info-main_intent\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>main_intent<\/code><\/td><td>string<\/td><td><p><em>main search intent<\/em><br>possible values: <code>informational<\/code>, <code>navigational<\/code>, <code>commercial<\/code>, <code>transactional<\/code><\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-search_intent_info-foreign_intent\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>foreign_intent<\/code><\/td><td>array<\/td><td><p><em>supplementary search intents<\/em><br>possible values: <code>informational<\/code>, <code>navigational<\/code>, <code>commercial<\/code>, <code>transactional<\/code><\/a><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-search_intent_info-last_updated_time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>last_updated_time<\/code><\/td><td>string<\/td><td><p><em>date and time when search intent data was last updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_bing\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>keyword_info_normalized_with_bing<\/code><\/strong><\/td><td>object<\/td><td><p><em>contains keyword search volume normalized with Bing search volume<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_bing-last_updated_time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>last_updated_time<\/code><\/td><td>string<\/td><td><p><em>date and time when the dataset was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<p>example:<br><code>2019-11-15 12:57:46 +00:00<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_bing-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>current search volume rate of a keyword<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_bing-is_normalized\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>is_normalized<\/code><\/td><td>boolean<\/td><td><p><em>keyword info is normalized<\/em><br>if <code>true<\/code>, values are normalized with Bing data<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_bing-monthly_searches\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>monthly_searches<\/code><\/strong><\/td><td>object<\/td><td><p><em>monthly search volume rates<\/em><br>array of objects with search volume rates in a certain month of a year<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_bing-monthly_searches-year\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>year<\/code><\/td><td>integer<\/td><td><p><em>year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_bing-monthly_searches-month\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>month<\/code><\/td><td>integer<\/td><td><p><em>month<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_bing-monthly_searches-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>search volume rate in a certain month of a year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_clickstream\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>keyword_info_normalized_with_clickstream<\/code><\/strong><\/td><td>object<\/td><td><p><em>contains keyword search volume normalized with clickstream data<br><\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_clickstream-last_updated_time\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>last_updated_time<\/code><\/td><td>string<\/td><td><p><em>date and time when the dataset was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<p>example:<br><code>2019-11-15 12:57:46 +00:00<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_clickstream-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>current search volume rate of a keyword<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_clickstream-is_normalized\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>is_normalized<\/code><\/td><td>boolean<\/td><td><p><em>keyword info is normalized<\/em><br>if <code>true<\/code>, values are normalized with clickstream data<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_clickstream-monthly_searches\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>monthly_searches<\/code><\/strong><\/td><td>object<\/td><td><p><em>monthly search volume rates<\/em><br>array of objects with search volume rates in a certain month of a year<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_clickstream-monthly_searches-year\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>year<\/code><\/td><td>integer<\/td><td><p><em>year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_clickstream-monthly_searches-month\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>month<\/code><\/td><td>integer<\/td><td><p><em>month<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-keyword_info_normalized_with_clickstream-monthly_searches-search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_volume<\/code><\/td><td>integer<\/td><td><p><em>search volume rate in a certain month of a year<\/em><\/p><\/td><\/tr><\/tbody><\/table><\/div><\/div><\/div><br \/>\n\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\/dataforseo_labs\/google\/top_searches\/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;language_name&quot;: &quot;English&quot;,\r\n        &quot;location_code&quot;: 2840,\r\n        &quot;limit&quot;: 3\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;language_name&quot; =&gt; &quot;English&quot;,\r\n\t&quot;location_code&quot; =&gt; 2840,\r\n\t&quot;limit&quot; =&gt; 3\r\n);\r\ntry {\r\n    \/\/ POST \/v3\/dataforseo_labs\/google\/top_searches\/live\r\n    $result = $client-&gt;post(&#039;\/v3\/dataforseo_labs\/google\/top_searches\/live&#039;, $post_array);\r\n    print_r($result);\r\n    \/\/ do something with post result\r\n} catch (RestClientException $e) {\r\n    echo &quot;n&quot;;\r\n    print &quot;HTTP code: {$e-&gt;getHttpCode()}n&quot;;\r\n    print &quot;Error code: {$e-&gt;getCode()}n&quot;;\r\n    print &quot;Message: {$e-&gt;getMessage()}n&quot;;\r\n    print  $e-&gt;getTraceAsString();\r\n    echo &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\npost_array.push({\r\n  &quot;language_name&quot;: &quot;English&quot;,\r\n  &quot;location_code&quot;: 2840,\r\n  &quot;limit&quot;: 3\r\n});\r\nconst axios = require(&#039;axios&#039;);\r\naxios({\r\n  method: &#039;post&#039;,\r\n  url: &#039;https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/google\/top_searches\/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    language_name=&quot;English&quot;,\r\n    limit=3\r\n)\r\n# POST \/v3\/dataforseo_labs\/google\/top_searches\/live\r\nresponse = client.post(&quot;\/v3\/dataforseo_labs\/google\/top_searches\/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 dataforseo_labs_google_top_searches_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                language_name = &quot;English&quot;,\r\n                limit = 3\r\n            });\r\n            \/\/ POST \/v3\/dataforseo_labs\/google\/top_searches\/live\r\n            \/\/ the full list of possible parameters is available in documentation\r\n            var taskPostResponse = await httpClient.PostAsync(&quot;\/v3\/dataforseo_labs\/google\/top_searches\/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.5228 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;08221840-1535-0404-0000-fe72c034949c&quot;,\r\n      &quot;status_code&quot;: 20000,\r\n      &quot;status_message&quot;: &quot;Ok.&quot;,\r\n      &quot;time&quot;: &quot;0.4524 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;dataforseo_labs&quot;,\r\n        &quot;google&quot;,\r\n        &quot;top_searches&quot;,\r\n        &quot;live&quot;\r\n      ],\r\n      &quot;data&quot;: {\r\n        &quot;api&quot;: &quot;dataforseo_labs&quot;,\r\n        &quot;function&quot;: &quot;top_searches&quot;,\r\n        &quot;se_type&quot;: &quot;google&quot;,\r\n        &quot;language_name&quot;: &quot;English&quot;,\r\n        &quot;location_code&quot;: 2840,\r\n        &quot;limit&quot;: 3\r\n      },\r\n      &quot;result&quot;: [\r\n        {\r\n          &quot;se_type&quot;: &quot;google&quot;,\r\n          &quot;location_code&quot;: 2840,\r\n          &quot;language_code&quot;: &quot;en&quot;,\r\n          &quot;total_count&quot;: 1097359538,\r\n          &quot;items_count&quot;: 3,\r\n          &quot;offset&quot;: 0,\r\n          &quot;offset_token&quot;: &quot;eyJDdXJyZW50T2Zmc2V0IjozLCJSZXF1ZXN0RGF0YSI6eyJsb2FkX3NlcnBfaW5mbyI6ZmFsc2UsInNlYXJjaF9hZnRlcl90b2tlbiI6bnVsbCwiaWdub3JlX3N5bm9ueW1zIjpmYWxzZSwibGFuZ3VhZ2UiOiJlbiIsInNlYXJjaF9lbmdpbmUiOiJnb29nbGUiLCJsb2NhdGlvbiI6Mjg0MCwidXNlX25ld19jYXRlZ29yaWVzIjp0cnVlLCJvcmRlcl9ieSI6eyJvcmRlcl9maWVsZCI6ImtleXdvcmRfaW5mby5zZWFyY2hfdm9sdW1lIiwib3JkZXJfdHlwZSI6IkRlc2MiLCJuZXh0IjpudWxsfSwibGltaXQiOjMsIm9mZnNldCI6MCwiYWlkIjoxNTM1fSwiUmF3UXVlcnkiOm51bGwsIklkIjoiNzQyNzdjNjMtMjgxOS00NTkzLWIyY2EtYjUzYTBlNmY4OGI2IiwiU2VhcmNoQWZ0ZXJEYXRhIjpbMTUxMDAwMDAwLCIxNGZmMGM2OS1kNWU0LTg4ZDctY2QwNS03Y2Y0YjJhYzIxMmMiXX0=&quot;,\r\n          &quot;items&quot;: [\r\n            {\r\n              &quot;se_type&quot;: &quot;google&quot;,\r\n              &quot;keyword&quot;: &quot;phub&quot;,\r\n              &quot;location_code&quot;: 2840,\r\n              &quot;language_code&quot;: &quot;en&quot;,\r\n              &quot;keyword_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;last_updated_time&quot;: &quot;2024-08-08 02:39:41 +00:00&quot;,\r\n                &quot;competition&quot;: null,\r\n                &quot;competition_level&quot;: &quot;LOW&quot;,\r\n                &quot;cpc&quot;: 0.68,\r\n                &quot;search_volume&quot;: 185000000,\r\n                &quot;low_top_of_page_bid&quot;: 0.99,\r\n                &quot;high_top_of_page_bid&quot;: 12.5,\r\n                &quot;categories&quot;: [\r\n                  10013\r\n                ],\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;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  }\r\n                ],\r\n                &quot;search_volume_trend&quot;: {\r\n                  &quot;monthly&quot;: 22,\r\n                  &quot;quarterly&quot;: 22,\r\n                  &quot;yearly&quot;: 0\r\n                }\r\n              },\r\n              &quot;clickstream_keyword_info&quot;: null,\r\n              &quot;keyword_properties&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;core_keyword&quot;: null,\r\n                &quot;synonym_clustering_algorithm&quot;: &quot;text_processing&quot;,\r\n                &quot;keyword_difficulty&quot;: 16,\r\n                &quot;detected_language&quot;: null,\r\n                &quot;is_another_language&quot;: true,\r\n                &quot;words_count&quot;: 1\r\n              },\r\n              &quot;serp_info&quot;: null,\r\n              &quot;avg_backlinks_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;backlinks&quot;: 830563.6,\r\n                &quot;dofollow&quot;: 171603.2,\r\n                &quot;referring_pages&quot;: 647749.9,\r\n                &quot;referring_domains&quot;: 734.1,\r\n                &quot;referring_main_domains&quot;: 569.2,\r\n                &quot;rank&quot;: 188.8,\r\n                &quot;main_domain_rank&quot;: 711.4,\r\n                &quot;last_updated_time&quot;: &quot;2024-08-04 08:23:20 +00:00&quot;\r\n              },\r\n              &quot;search_intent_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;main_intent&quot;: &quot;navigational&quot;,\r\n                &quot;foreign_intent&quot;: null,\r\n                &quot;last_updated_time&quot;: &quot;2023-08-31 20:30:38 +00:00&quot;\r\n              },\r\n              &quot;keyword_info_normalized_with_bing&quot;: {\r\n                &quot;last_updated_time&quot;: &quot;2024-08-08 02:39:41 +00:00&quot;,\r\n                &quot;search_volume&quot;: 185000000,\r\n                &quot;is_normalized&quot;: true,\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;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  }\r\n                ]\r\n              },\r\n              &quot;keyword_info_normalized_with_clickstream&quot;: {\r\n                &quot;last_updated_time&quot;: &quot;2024-08-08 02:39:41 +00:00&quot;,\r\n                &quot;search_volume&quot;: 185000000,\r\n                &quot;is_normalized&quot;: true,\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;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 226000000\r\n                  }\r\n                ]\r\n              }\r\n            },\r\n            {\r\n              &quot;se_type&quot;: &quot;google&quot;,\r\n              &quot;keyword&quot;: &quot;yyyyyyyyyoutube&quot;,\r\n              &quot;location_code&quot;: 2840,\r\n              &quot;language_code&quot;: &quot;en&quot;,\r\n              &quot;keyword_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;last_updated_time&quot;: &quot;2024-08-12 02:02:19 +00:00&quot;,\r\n                &quot;competition&quot;: 0.01,\r\n                &quot;competition_level&quot;: &quot;LOW&quot;,\r\n                &quot;cpc&quot;: 0.03,\r\n                &quot;search_volume&quot;: 151000000,\r\n                &quot;low_top_of_page_bid&quot;: 0.01,\r\n                &quot;high_top_of_page_bid&quot;: 0.01,\r\n                &quot;categories&quot;: [\r\n                  13575\r\n                ],\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;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  }\r\n                ],\r\n                &quot;search_volume_trend&quot;: {\r\n                  &quot;monthly&quot;: 22,\r\n                  &quot;quarterly&quot;: 22,\r\n                  &quot;yearly&quot;: 0\r\n                }\r\n              },\r\n              &quot;clickstream_keyword_info&quot;: null,\r\n              &quot;keyword_properties&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;core_keyword&quot;: null,\r\n                &quot;synonym_clustering_algorithm&quot;: &quot;text_processing&quot;,\r\n                &quot;keyword_difficulty&quot;: 0,\r\n                &quot;detected_language&quot;: null,\r\n                &quot;is_another_language&quot;: true,\r\n                &quot;words_count&quot;: 1\r\n              },\r\n              &quot;serp_info&quot;: null,\r\n              &quot;avg_backlinks_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;backlinks&quot;: 6.2,\r\n                &quot;dofollow&quot;: 1.5,\r\n                &quot;referring_pages&quot;: 1.6,\r\n                &quot;referring_domains&quot;: 0.3,\r\n                &quot;referring_main_domains&quot;: 0.3,\r\n                &quot;rank&quot;: 16.6,\r\n                &quot;main_domain_rank&quot;: 911.7,\r\n                &quot;last_updated_time&quot;: &quot;2024-07-21 09:56:03 +00:00&quot;\r\n              },\r\n              &quot;search_intent_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;main_intent&quot;: &quot;navigational&quot;,\r\n                &quot;foreign_intent&quot;: null,\r\n                &quot;last_updated_time&quot;: &quot;2023-08-01 06:19:20 +00:00&quot;\r\n              },\r\n              &quot;keyword_info_normalized_with_bing&quot;: {\r\n                &quot;last_updated_time&quot;: &quot;2024-08-16 17:07:14 +00:00&quot;,\r\n                &quot;search_volume&quot;: 12,\r\n                &quot;is_normalized&quot;: true,\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;: 12\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 12\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 15\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 15\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 15\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 12\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 15\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 15\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 12\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 15\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 12\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 15\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 7,\r\n                    &quot;search_volume&quot;: 12\r\n                  }\r\n                ]\r\n              },\r\n              &quot;keyword_info_normalized_with_clickstream&quot;: {\r\n                &quot;last_updated_time&quot;: &quot;2024-08-16 17:07:14 +00:00&quot;,\r\n                &quot;search_volume&quot;: 0,\r\n                &quot;is_normalized&quot;: true,\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;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 7,\r\n                    &quot;search_volume&quot;: 0\r\n                  }\r\n                ]\r\n              }\r\n            },\r\n            {\r\n              &quot;se_type&quot;: &quot;google&quot;,\r\n              &quot;keyword&quot;: &quot;uytuytuyt&quot;,\r\n              &quot;location_code&quot;: 2840,\r\n              &quot;language_code&quot;: &quot;en&quot;,\r\n              &quot;keyword_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;last_updated_time&quot;: &quot;2024-08-11 08:14:45 +00:00&quot;,\r\n                &quot;competition&quot;: 0.01,\r\n                &quot;competition_level&quot;: &quot;LOW&quot;,\r\n                &quot;cpc&quot;: 0.03,\r\n                &quot;search_volume&quot;: 151000000,\r\n                &quot;low_top_of_page_bid&quot;: 0.01,\r\n                &quot;high_top_of_page_bid&quot;: 0.01,\r\n                &quot;categories&quot;: null,\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;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 151000000\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 185000000\r\n                  }\r\n                ],\r\n                &quot;search_volume_trend&quot;: {\r\n                  &quot;monthly&quot;: 22,\r\n                  &quot;quarterly&quot;: 22,\r\n                  &quot;yearly&quot;: 0\r\n                }\r\n              },\r\n              &quot;clickstream_keyword_info&quot;: null,\r\n              &quot;keyword_properties&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;core_keyword&quot;: null,\r\n                &quot;synonym_clustering_algorithm&quot;: null,\r\n                &quot;keyword_difficulty&quot;: 0,\r\n                &quot;detected_language&quot;: null,\r\n                &quot;is_another_language&quot;: true,\r\n                &quot;words_count&quot;: 1\r\n              },\r\n              &quot;serp_info&quot;: null,\r\n              &quot;avg_backlinks_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;backlinks&quot;: 8.1,\r\n                &quot;dofollow&quot;: 8.1,\r\n                &quot;referring_pages&quot;: 8.1,\r\n                &quot;referring_domains&quot;: 0.4,\r\n                &quot;referring_main_domains&quot;: 0.2,\r\n                &quot;rank&quot;: 14.7,\r\n                &quot;main_domain_rank&quot;: 934.5,\r\n                &quot;last_updated_time&quot;: &quot;2024-07-14 21:42:27 +00:00&quot;\r\n              },\r\n              &quot;search_intent_info&quot;: {\r\n                &quot;se_type&quot;: &quot;google&quot;,\r\n                &quot;main_intent&quot;: &quot;navigational&quot;,\r\n                &quot;foreign_intent&quot;: null,\r\n                &quot;last_updated_time&quot;: &quot;2023-03-02 01:47:58 +00:00&quot;\r\n              },\r\n              &quot;keyword_info_normalized_with_bing&quot;: {\r\n                &quot;last_updated_time&quot;: &quot;2024-08-16 17:07:14 +00:00&quot;,\r\n                &quot;search_volume&quot;: 0,\r\n                &quot;is_normalized&quot;: true,\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;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 0\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 7,\r\n                    &quot;search_volume&quot;: 0\r\n                  }\r\n                ]\r\n              },\r\n              &quot;keyword_info_normalized_with_clickstream&quot;: {\r\n                &quot;last_updated_time&quot;: &quot;2024-08-16 17:07:14 +00:00&quot;,\r\n                &quot;search_volume&quot;: 50,\r\n                &quot;is_normalized&quot;: true,\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;: 50\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 6,\r\n                    &quot;search_volume&quot;: 50\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 5,\r\n                    &quot;search_volume&quot;: 62\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 4,\r\n                    &quot;search_volume&quot;: 62\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 3,\r\n                    &quot;search_volume&quot;: 62\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 2,\r\n                    &quot;search_volume&quot;: 50\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2024,\r\n                    &quot;month&quot;: 1,\r\n                    &quot;search_volume&quot;: 62\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 12,\r\n                    &quot;search_volume&quot;: 62\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 11,\r\n                    &quot;search_volume&quot;: 50\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 10,\r\n                    &quot;search_volume&quot;: 62\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 9,\r\n                    &quot;search_volume&quot;: 50\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 8,\r\n                    &quot;search_volume&quot;: 62\r\n                  },\r\n                  {\r\n                    &quot;year&quot;: 2023,\r\n                    &quot;month&quot;: 7,\r\n                    &quot;search_volume&quot;: 48\r\n                  }\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] Top Searches \u200c\u200c The Top Searches endpoint of DataForSEO Labs API can provide you with over 7 billion keywords from the DataForSEO Keyword Database. Each keyword in the API response is provided with a set of relevant keyword data with Google Ads metrics, product categories, and Google SERP data. The working mechanism of this [&hellip;]<\/p>\n","protected":false},"author":17,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"parameters:\n  - name: location_name\n    type: string\n    description: |\n      <em>full name of the location<\/em><br><strong>required field if you don't specify<\/strong> <code>location_code<\/code><br><strong>Note:<\/strong> it is required to specify either <code>location_name<\/code> or <code>location_code<\/code><br>you can receive the list of available locations with their <code>location_name<\/code> by making a separate request to the <br><code>https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code><br>example:<br><code class=\"long-string\">United Kingdom<\/code>\n  - name: location_code\n    type: integer\n    description: |\n      <em>location code<\/em><br><strong>required field if you don't specify<\/strong> <code>location_name<\/code><br><strong>Note:<\/strong> it is required to specify either <code>location_name<\/code> or <code>location_code<\/code><br>you can receive the list of available locations with their <code>location_code<\/code> by making a separate request to the <br><code>https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code><br>example:<br><code class=\"long-string\">2840<\/code>\n  - name: language_name\n    type: string\n    description: |\n      <em>full name of the language<\/em><br><strong>required field if you don't specify<\/strong> <code>language_code<\/code><br><strong>Note:<\/strong> it is required to specify either <code>language_name<\/code> or <code>language_code<\/code><br>you can receive the list of available locations with their <code>language_name<\/code> by making a separate request to the <br><code>https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code><br>example:<br><code class=\"long-string\">English<\/code>\n  - name: language_code\n    type: string\n    description: |\n      <em>language code<\/em><br><strong>required field if you don't specify<\/strong> <code>language_name<\/code><br><strong>Note:<\/strong> it is required to specify either <code>language_name<\/code> or <code>language_code<\/code><br>you can receive the list of available locations with their <code>language_code<\/code> by making a separate request to the <br><code>https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code><br>example:<br><code class=\"long-string\">en<\/code>\n  - name: include_serp_info\n    type: boolean\n    description: |\n      <em>include data from SERP for each keyword<\/em><br>optional field<br>if set to <code>true<\/code>, we will return a <code>serp_info<\/code> array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response<br>default value: <code>false<\/code>\n  - name: include_clickstream_data\n    type: boolean\n    description: \"<em>include or exclude data from clickstream-based metrics in the result<\/em><br>optional field<br>if the parameter is set to <code>true<\/code>, you will receive <code>clickstream_keyword_info<\/code>, <code>keyword_info_normalized_with_clickstream<\/code>, and <code>keyword_info_normalized_with_bing<\/code> fields in the response<br>default value: <code>false<\/code><br>with this parameter enabled, you will be charged double the price for the request<p>learn more about how clickstream-based metrics are calculated in this <a href=\"https:\/\/dataforseo.com\/help-center\/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">help center article<\/a>\"\n  - name: ignore_synonyms\n    type: boolean\n    description: \"<em>ignore highly similar keywords<\/em><br>optional field<br>if set to <code class=\"prettyprint\">true<\/code> only core keywords will be returned, all highly similar keywords will be excluded;  <br>default value: <code>false<\/code>\"\n  - name: filters\n    type: array\n    description: |\n      <em>array of results filtering parameters<\/em><br>optional field<br><strong>you can add several filters at once (8 filters maximum)<\/strong><br>you should set a logical operator <code>and<\/code>, <code>or<\/code> between the conditions<br>the following operators are supported:<br><code>regex<\/code>, <code>not_regex<\/code>, <code>&lt;<\/code>, <code>&lt;=<\/code>, <code>&gt;<\/code>, <code>&gt;=<\/code>, <code>=<\/code>, <code>&lt;&gt;<\/code>, <code>in<\/code>, <code>not_in<\/code>, <code>match<\/code>, <code>not_match<\/code>, <code>ilike<\/code>, <code>not_ilike<\/code>, <code>like<\/code>,<code>not_like<\/code><br>you can use the <code>%<\/code> operator with <code>like<\/code> and <code>not_like<\/code>,as well as <code>ilike<\/code> and <code>not_ilike<\/code> to match any string of zero or more characters<br>example:<br><code>[\"keyword_info.search_volume\",\"&gt;\",0]<\/code><p><code>[[\"keyword_info.search_volume\",\"in\",[0,1000]],<br>\"and\",<br>[\"keyword_info.competition_level\",\"=\",\"LOW\"]]<\/code><p><code>[[\"keyword_info.search_volume\",\"&gt;\",100],<br>\"and\",<br>[[\"keyword_info.cpc\",\"&lt;\",0.5],<br>\"or\",<p>[\"keyword_info.high_top_of_page_bid\",\"&lt;=\",0.5]]]<\/code><br>for more information about filters, please refer to <a href=\"\/v3\/dataforseo_labs\/filters\" target=\"_blank\" rel=\"noopener noreferrer\">Dataforseo Labs - Filters<\/a> or this <a href=\"https:\/\/dataforseo.com\/help-center\/how-to-use-filters-in-dataforseo-labs-api\" rel=\"noopener noreferrer\" target=\"_blank\">help center guide<\/a>\n  - name: order_by\n    type: array\n    description: |\n      <em>results sorting rules<\/em><br>optional field<br>you can use the same values as in the <code>filters<\/code> array to sort the results<br>possible sorting types:<br><code>asc<\/code> - results will be sorted in the ascending order<br><code>desc<\/code> - results will be sorted in the descending order<br>you should use a comma to set up a sorting type<br>example:<br><code>[\"keyword_info.competition,desc\"]<\/code><br>default rule:<br><code>[\"keyword_info.search_volume,desc\"]<\/code><br><strong>note that you can set no more than three sorting rules in a single request<\/strong><br>you should use a comma to separate several sorting rules<br>example:<br><code>[\"keyword_info.search_volume,desc\",\"keyword_info.cpc,desc\"]<\/code>\n  - name: tag\n    type: string\n    description: |\n      <em>user-defined task identifier<\/em><br>optional field<br><em>the character limit is 255<\/em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag<\/code> value in the <code>data<\/code> object of the response\n  - name: limit\n    type: integer\n    description: |\n      <em>the maximum number of returned keywords<\/em><br>optional field<br><\/strong>note:<\/strong> you can get more than 1000 results by using the <code>offset_token<\/code> provided in the response to each subsequent request<br>default value: <code>1000<\/code><br>maximum value: <code>1000<\/code>\n  - name: offset\n    type: integer\n    description: |\n      <em>offset in the results array of returned keywords<\/em><br>optional field<br>default value: <code>0<\/code><br>if you specify the <code>10<\/code> value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords<br><strong>Note:<\/strong> we recommend using this parameter only when retrieving up to 10,000 results<br>for retrieving over 10,000 results, use the <code>offset_token<\/code> instead.\n  - name: offset_token\n    type: string\n    description: |\n      <em>offset token for subsequent requests<\/em><br>optional field<br>provided in the identical filed of the response to each request;<br>use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;<br>by specifying the unique <code>offset_token<\/code> value from the response array, you will get the subsequent results of the initial task;<br><code>offset_token<\/code> values are unique for each subsequent task <br><strong>Note:<\/strong> if the <code>offset_token<\/code> is specified in the request, all other parameters except <code>limit<\/code> will not be taken into account when processing a task.<br>learn more about this parameter on our <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-the-difference-between-the-offset-and-offset_token-parameters#offset_token\" target=\"_blank\">Help Center<\/a>","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"parameters:\n  - name: version\n    type: string\n    description: |\n      <em>the current version of the API<\/em>\n  - name: status_code\n    type: integer\n    description: |\n      <i>general status code<\/i><br>you can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><br><strong>Note:<\/strong> we strongly recommend designing a necessary system for handling related exceptional or error conditions\n  - name: status_message\n    type: string\n    description: |\n      <em>general informational message<\/em><br>you can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a>\n  - name: time\n    type: string\n    description: |\n      <em>execution time, seconds<\/em>\n  - name: cost\n    type: float\n    description: |\n      <em>total <i>tasks<\/i> cost, USD<\/em>\n  - name: tasks_count\n    type: integer\n    description: |\n      <em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array<\/em>\n  - name: tasks_error\n    type: integer\n    description: |\n      <em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array returned with an error<\/em>\n  - name: tasks\n    type: array\n    description: |\n      <em>array of tasks<\/em>\n    items:\n      children:\n        - name: id\n          type: string\n          description: |\n            <em>task identifier<\/em><br><strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\">UUID<\/a> format<\/strong>\n        - name: status_code\n          type: integer\n          description: |\n            <em>status code of the task <\/em><br>generated by DataForSEO; can be within the following range: 10000-60000<br>you can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a>\n        - name: status_message\n          type: string\n          description: |\n            <em>informational message of the task<\/em><br>you can find the full list of general informational messages <a href=\"\/v3\/appendix-errors\/\">here<\/a>\n        - name: time\n          type: string\n          description: |\n            <em>execution time, seconds<\/em>\n        - name: cost\n          type: float\n          description: |\n            <em>cost of the task, USD<\/em>\n        - name: result_count\n          type: integer\n          description: |\n            <em>number of elements in the <code>result<\/code> array<\/em>\n        - name: path\n          type: array\n          description: |\n            <em>URL path<\/em>\n        - name: data\n          type: object\n          description: |\n            <em>contains the same parameters that you specified in the POST request<\/em>\n        - name: result\n          type: array\n          description: |\n            <em>array of results<\/em>\n          items:\n            children:\n              - name: se_type\n                type: string\n                description: |\n                  <em>search engine type<\/em>\n              - name: location_code\n                type: integer\n                description: |\n                  <em>location code in a POST array<\/em>\n              - name: language_code\n                type: string\n                description: |\n                  <em>language code in a POST array<\/em>\n              - name: total_count\n                type: integer\n                description: |\n                  <em>total amount of results in our database relevant to your request<\/em>\n              - name: items_count\n                type: integer\n                description: |\n                  <em>the number of results returned in the <code>items<\/code> array<\/em>\n              - name: offset\n                type: integer\n                description: |\n                  <em>current offset value<\/em>\n              - name: offset_token\n                type: string\n                description: |\n                  <em>offset token for subsequent requests<\/em><br>you can use the string provided in this field to get the subsequent results of the initial task;<br><strong>note:<\/strong> <code>offset_token<\/code> values are unique for each subsequent task\n              - name: items\n                type: array\n                description: |\n                  <em>contains keywords and related data<\/em>\n                items:\n                  children:\n                    - name: se_type\n                      type: string\n                      description: |\n                        <em>search engine type<\/em>\n                    - name: keyword\n                      type: string\n                      description: |\n                        <em>keyword<\/em>\n                    - name: location_code\n                      type: integer\n                      description: |\n                        <em>location code in a POST array<\/em>\n                    - name: language_code\n                      type: string\n                      description: |\n                        <em>language code in a POST array<\/em>\n                    - name: keyword_info\n                      type: object\n                      description: |\n                        <em>keyword data for the returned keyword<\/em>\n                      children:\n                        - name: se_type\n                          type: string\n                          description: |\n                            <em>search engine type<\/em>\n                        - name: last_updated_time\n                          type: string\n                          description: |\n                            <em>date and time when keyword data was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code>\n                        - name: competition\n                          type: float\n                          description: |\n                            <em>competition<\/em><br>represents the relative amount of competition associated with the given keyword;<br>the value is based on Google Ads data and can be between 0 and 1 (inclusive)\n                        - name: competition_level\n                          type: string\n                          description: |\n                            <em>competition level<\/em><br>represents the relative level of competition associated with the given keyword in paid SERP only;<br>possible values: <code>LOW<\/code>, <code>MEDIUM<\/code>, <code>HIGH<\/code><br>if competition level is unknown, the value is <code>null<\/code>;<br>learn more about the metric in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-competition\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article<\/a>\n                        - name: cpc\n                          type: float\n                          description: |\n                            <em>cost-per-click<\/em><br>represents the average cost per click (USD) historically paid for the keyword\n                        - name: search_volume\n                          type: integer\n                          description: |\n                            <em>average monthly search volume rate<\/em><br>represents the (approximate) number of searches for the given keyword idea on google.com\n                        - name: low_top_of_page_bid\n                          type: float\n                          description: |\n                            <em>minimum bid for the ad to be displayed at the top of the first page<\/em><br>indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)<br>the value may differ depending on the location specified in a POST request\n                        - name: high_top_of_page_bid\n                          type: float\n                          description: |\n                            <em>maximum bid for the ad to be displayed at the top of the first page<\/em><br>indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)<br>the value may differ depending on the location specified in a POST request\n                        - name: categories\n                          type: array\n                          description: |\n                            <em>product and service categories<\/em><br>you can download the <a href=\"https:\/\/cdn.dataforseo.com\/v3\/categories\/categories_dataforseo_labs_2023_10_25.csv\">full list of possible categories<\/a>\n                        - name: monthly_searches\n                          type: array\n                          description: |\n                            <em>monthly searches<\/em><br>represents the (approximate) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographic locations\n                          items:\n                            children:\n                              - name: year\n                                type: integer\n                                description: |\n                                  <em>year<\/em>\n                              - name: month\n                                type: integer\n                                description: |\n                                  <em>month<\/em>\n                              - name: search_volume\n                                type: integer\n                                description: |\n                                  <em>monthly average search volume rate<\/em>\n                        - name: search_volume_trend\n                          type: object\n                          description: |\n                            <em>search volume trend changes<\/em><br>represents search volume change in percent compared to the previous period\n                          children:\n                            - name: monthly\n                              type: integer\n                              description: |\n                                <em>search volume change in percent compared to the previous month<\/em>\n                            - name: quarterly\n                              type: integer\n                              description: |\n                                <em>search volume change in percent compared to the previous quarter<\/em>\n                            - name: yearly\n                              type: integer\n                              description: |\n                                <em>search volume change in percent compared to the previous year<\/em>\n                    - name: clickstream_keyword_info\n                      type: object\n                      description: |\n                        <em>clickstream data for the returned keyword<\/em><br>to retrieve results for this field, the parameter <code>include_clickstream_data<\/code> must be set to <code>true<\/code>\n                      children:\n                        - name: search_volume\n                          type: integer\n                          description: |\n                            <em>monthly average clickstream search volume rate<\/em>\n                        - name: last_updated_time\n                          type: string\n                          description: |\n                            <em>date and time when the clickstream dataset was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d\n                        - name: gender_distribution\n                          type: object\n                          description: |\n                            <em>distribution of estimated clickstream-based metrics by gender<\/em><br>learn more about how the metric is calculated in this <a href=\"https:\/\/dataforseo.com\/help-center\/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">help center article<\/a>\n                          children:\n                            - name: female\n                              type: integer\n                              description: |\n                                <em>number of female users in the relevant clickstream dataset<\/em>\n                            - name: male\n                              type: integer\n                              description: |\n                                <em>number of male users in the relevant clickstream dataset<\/em>\n                        - name: age_distribution\n                          type: object\n                          description: |\n                            <em>distribution of clickstream-based metrics by age<\/em><br>learn more about how the metric is calculated in this <a href=\"https:\/\/dataforseo.com\/help-center\/what-are-clickstream-based-metrics-and-how-do-we-calculate-them\" rel=\"noopener noreferrer\" target=\"_blank\">help center article<\/a>\n                          children:\n                            - name: 18-24\n                              type: integer\n                              description: |\n                                <em>number of users in the relevant clickstream dataset that fall within the 18-24 age range<\/em>\n                            - name: 25-34\n                              type: integer\n                              description: |\n                                <em>number of users in the relevant clickstream dataset that fall within the 25-34 age range<\/em>\n                            - name: 35-44\n                              type: integer\n                              description: |\n                                <em>number of users in the relevant clickstream dataset that fall within the 35-44 age range<\/em>\n                            - name: 45-54\n                              type: integer\n                              description: |\n                                <em>number of users in the relevant clickstream dataset that fall within the 45-54 age range<\/em>\n                            - name: 55-64\n                              type: integer\n                              description: |\n                                <em>number of users in the relevant clickstream dataset that fall within the 55-64 age range<\/em>\n                        - name: monthly_searches\n                          type: array\n                          description: |\n                            <em>monthly clickstream search volume rates<\/em><br>array of objects with clickstream search volume rates in a certain month of a year\n                          items:\n                            children:\n                              - name: year\n                                type: integer\n                                description: |\n                                  <em>year<\/em>\n                              - name: month\n                                type: integer\n                                description: |\n                                  <em>month<\/em>\n                              - name: search_volume\n                                type: integer\n                                description: |\n                                  <em>clickstream-based search volume rate in a certain month of a year<\/em>\n                    - name: keyword_properties\n                      type: object\n                      description: |\n                        <em>additional information about the keyword<\/em>\n                      children:\n                        - name: se_type\n                          type: string\n                          description: |\n                            <em>search engine type<\/em>\n                        - name: core_keyword\n                          type: string\n                          description: |\n                            <em>main keyword in a group<\/em><br>contains the main keyword in a group determined by the synonym clustering algorithm<br>if the value is <code>null<\/code>, our database does not contain any keywords the corresponding algorithm could identify as synonymous with <code>keyword<\/code>\n                        - name: synonym_clustering_algorithm\n                          type: string\n                          description: |\n                            <em>the algorithm used to identify synonyms<\/em><br>possible values: <br><code>keyword_metrics<\/code> - indicates the algorithm based on <code>keyword_info<\/code> parameters<br><code>text_processing<\/code> - indicates the text-based algorithm<br>if the value is <code>null<\/code>, our database does not contain any keywords the corresponding algorithm could identify as synonymous with <code>keyword<\/code>\n                        - name: keyword_difficulty\n                          type: integer\n                          description: |\n                            <em>difficulty of ranking in the first top-10 organic results for a keyword<\/em><br>indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;<br>calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP;<br>learn more about the metric in <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-keyword-difficulty-and-how-is-it-calculated\" rel=\"noopener noreferrer\" target=\"_blank\">this help center guide<\/a>\n                        - name: detected_language\n                          type: string\n                          description: |\n                            <em>detected language of the keyword<\/em><br>indicates the language of the keyword as identified by our system\n                        - name: is_another_language\n                          type: boolean\n                          description: |\n                            <em>detected language of the keyword is different from the set language<\/em><br>if <code>true<\/code>, the language set in the request does not match the language determined by our system for a given keyword\n                        - name: words_count\n                          type: integer\n                          description: |\n                            <em>number of words in the keyword<\/em><br>indicates how many words the keyword consists of\n                    - name: serp_info\n                      type: object\n                      description: |\n                        <em>Google SERP data<\/em><br>the value will be <code>null<\/code> if you didn't set the field <code>include_serp_info<\/code> to <code>true<\/code> in the POST array or if there is no SERP data for this keyword in our database\n                      children:\n                        - name: se_type\n                          type: string\n                          description: |\n                            <em>search engine type<\/em>\n                        - name: check_url\n                          type: string\n                          description: |\n                            <em>direct URL to search engine results<\/em><br>you can use it to make sure that we provided accurate results\n                        - name: serp_item_types\n                          type: array\n                          description: |\n                            <em>types of search results in SERP<\/em><br>contains types of search results (items) found in SERP<br>possible item types:<br><code>answer_box<\/code>, <code>app<\/code>, <code>carousel<\/code>, <code>multi_carousel<\/code>, <code>featured_snippet<\/code>, <code>google_flights<\/code>, <code>google_reviews<\/code>, <code>third_party_reviews<\/code>, <code>google_posts<\/code>, <code>images<\/code>, <code>jobs<\/code>, <code>knowledge_graph<\/code>, <code>local_pack<\/code>, <code>hotels_pack<\/code>, <code>map<\/code>, <code>organic<\/code>, <code>paid<\/code>, <code>people_also_ask<\/code>, <code>related_searches<\/code>, <code>people_also_search<\/code>, <code>shopping<\/code>, <code>top_stories<\/code>, <code>twitter<\/code>, <code>video<\/code>, <code>events<\/code>, <code>mention_carousel<\/code>, <code>recipes<\/code>, <code>top_sights<\/code>, <code>scholarly_articles<\/code>, <code>popular_products<\/code>, <code>podcasts<\/code>, <code>questions_and_answers<\/code>, <code>find_results_on<\/code>, <code>stocks_box<\/code>, <code>visual_stories<\/code>, <code>commercial_units<\/code>, <code>local_services<\/code>, <code>google_hotels<\/code>, <code>math_solver<\/code>, <code>currency_box<\/code>, <code>product_considerations<\/code>, <code>found_on_web<\/code>, <code>short_videos<\/code>, <code>refine_products<\/code>, <code>explore_brands<\/code>, <code>perspectives<\/code>, <code>discussions_and_forums<\/code>, <code>compare_sites<\/code>, <code>courses<\/code>, <code>ai_overview<\/code>;<br><strong>note<\/strong> that the actual results will be returned only for <code>organic<\/code>, <code>paid<\/code>, <code>featured_snippet<\/code>, and <code>local_pack<\/code> elements\n                        - name: se_results_count\n                          type: integer\n                          description: |\n                            <em>number of search results for the returned keyword<\/em>\n                        - name: last_updated_time\n                          type: string\n                          description: |\n                            <em>date and time when SERP data was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code>\n                    - name: avg_backlinks_info\n                      type: object\n                      description: |\n                        <em>backlink data for the returned keyword<\/em><br>this object provides the average number of backlinks, referring pages and domains, as well as the average rank values among the top-10 webpages ranking organically for the keyword\n                      children:\n                        - name: se_type\n                          type: string\n                          description: |\n                            <em>search engine type<\/em>\n                        - name: backlinks\n                          type: float\n                          description: |\n                            <em>average number of backlinks<\/em>\n                        - name: dofollow\n                          type: float\n                          description: |\n                            <em>average number of dofollow links<\/em>\n                        - name: referring_pages\n                          type: float\n                          description: |\n                            <em>average number of referring pages<\/em>\n                        - name: referring_domains\n                          type: float\n                          description: |\n                            <em>average number of referring domains<\/em>\n                        - name: referring_main_domains\n                          type: float\n                          description: |\n                            <em>average number of referring main domains<\/em>\n                        - name: rank\n                          type: float\n                          description: |\n                            <em>average rank<\/em><br>learn more about the metric and its calculation formula in <a href=\"https:\/\/dataforseo.com\/help-center\/what_is_rank_in_backlinks_api\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article<\/a>\n                        - name: main_domain_rank\n                          type: float\n                          description: |\n                            <em>average main domain rank<\/em><br>learn more about the metric and its calculation formula in <a href=\"https:\/\/dataforseo.com\/help-center\/what_is_rank_in_backlinks_api\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article<\/a>\n                        - name: last_updated_time\n                          type: string\n                          description: |\n                            <em>date and time when backlink data was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code>\n                    - name: search_intent_info\n                      type: object\n                      description: |\n                        <em>search intent info for the returned keyword<\/em><br>learn about search intent in this <a href=\"https:\/\/dataforseo.com\/help-center\/search-intent-and-its-types\" rel=\"noopener noreferrer\" target=\"_blank\">help center article<\/a>\n                      children:\n                        - name: se_type\n                          type: string\n                          description: |\n                            <em>search engine type<\/em><br>possible values: <code>google<\/code><\/a>\n                        - name: main_intent\n                          type: string\n                          description: |\n                            <em>main search intent<\/em><br>possible values: <code>informational<\/code>, <code>navigational<\/code>, <code>commercial<\/code>, <code>transactional<\/code><\/a>\n                        - name: foreign_intent\n                          type: array\n                          description: |\n                            <em>supplementary search intents<\/em><br>possible values: <code>informational<\/code>, <code>navigational<\/code>, <code>commercial<\/code>, <code>transactional<\/code><\/a>\n                        - name: last_updated_time\n                          type: string\n                          description: |\n                            <em>date and time when search intent data was last updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00<\/code>\n                    - name: keyword_info_normalized_with_bing\n                      type: object\n                      description: |\n                        <em>contains keyword search volume normalized with Bing search volume<\/em>\n                      children:\n                        - name: last_updated_time\n                          type: string\n                          description: |\n                            <em>date and time when the dataset was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<p>example:<br><code>2019-11-15 12:57:46 +00:00<\/code>\n                        - name: search_volume\n                          type: integer\n                          description: |\n                            <em>current search volume rate of a keyword<\/em>\n                        - name: is_normalized\n                          type: boolean\n                          description: |\n                            <em>keyword info is normalized<\/em><br>if <code>true<\/code>, values are normalized with Bing data\n                        - name: monthly_searches\n                          type: object\n                          description: |\n                            <em>monthly search volume rates<\/em><br>array of objects with search volume rates in a certain month of a year\n                          children:\n                            - name: year\n                              type: integer\n                              description: |\n                                <em>year<\/em>\n                            - name: month\n                              type: integer\n                              description: |\n                                <em>month<\/em>\n                            - name: search_volume\n                              type: integer\n                              description: |\n                                <em>search volume rate in a certain month of a year<\/em>\n                    - name: keyword_info_normalized_with_clickstream\n                      type: object\n                      description: |\n                        <em>contains keyword search volume normalized with clickstream data<br><\/em>\n                      children:\n                        - name: last_updated_time\n                          type: string\n                          description: |\n                            <em>date and time when the dataset was updated<\/em><br>in the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d<p>example:<br><code>2019-11-15 12:57:46 +00:00<\/code>\n                        - name: search_volume\n                          type: integer\n                          description: |\n                            <em>current search volume rate of a keyword<\/em>\n                        - name: is_normalized\n                          type: boolean\n                          description: |\n                            <em>keyword info is normalized<\/em><br>if <code>true<\/code>, values are normalized with clickstream data\n                        - name: monthly_searches\n                          type: object\n                          description: |\n                            <em>monthly search volume rates<\/em><br>array of objects with search volume rates in a certain month of a year\n                          children:\n                            - name: year\n                              type: integer\n                              description: |\n                                <em>year<\/em>\n                            - name: month\n                              type: integer\n                              description: |\n                                <em>month<\/em>\n                            - name: search_volume\n                              type: integer\n                              description: |\n                                <em>search volume rate in a certain month of a year<\/em>","footnotes":""},"class_list":["post-12982","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/12982","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=12982"}],"version-history":[{"count":56,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/12982\/revisions"}],"predecessor-version":[{"id":25187,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/12982\/revisions\/25187"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=12982"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}