{"id":24595,"date":"2026-06-05T14:06:19","date_gmt":"2026-06-05T14:06:19","guid":{"rendered":"https:\/\/docs.dataforseo.com\/v3\/?page_id=24595"},"modified":"2026-07-07T09:20:47","modified_gmt":"2026-07-07T09:20:47","slug":"ai_optimization-llm_mentions-historical-live","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/ai_optimization-llm_mentions-historical-live\/","title":{"rendered":"ai_optimization\/llm_mentions\/historical\/live"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h2>Live LLM Mentions Historical<\/h2>\n<p>\u200c\u200c<br \/>\nLive LLM Mentions Historical endpoint provides month-by-month historical metrics for mentions of the keywords or domains specified in the <code>target<\/code> array of the request. For each month, the response returns the total <code>mentions<\/code> count and <code>ai_search_volume<\/code> rate. The results are specific to the selected platform (<code>google<\/code> for Google&#8217;s  AI Overview or <code>chat_gpt<\/code> for ChatGPT), location and language parameters (see <a href=\"https:\/\/docs.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages\" target=\"_blank\" rel=\"noopener noreferrer\">the List of Locations &#038; Languages<\/a>).<\/p>\n<p>Historical data is available from 2025-08-01<\/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\/ai_optimization\/llm_mentions\/historical\/live\">\n                https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/historical\/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>The cost of the task can be calculated on the <a href=\"https:\/\/dataforseo.com\/pricing\/ai-optimization\/llm-mentions\" target=\"_blank\">Pricing page<\/a><\/a>. <\/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 LLM Mentions API call can contain only one task.<\/p>\n<p><strong>Execution time for tasks set with the Live LLM Mentions endpoint is currently up to 120 seconds.<\/strong><\/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=\"target\"><td><strong><code>target<\/code><\/strong><\/td><td>array<\/td><td><p><em>array of objects containing target entities<\/em><br><strong>required field<\/strong><br>you can specify <strong>up to 10 entities (objects)<\/strong> in the <code>target<\/code> field<br>one target entity can contain either one <code>domain<\/code> or one <code>keyword<\/code> and related parameters<p>examples: <p>target array with a domain entity<br><code>[{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}]<\/code><br>target array with a keyword entity<br><code>[{\"keyword\": \"bmw\", \"search_scope\": [\"question\"], \"match_type \": \"partial_match\"}]<\/code><br>target array with multiple entities<br><code>[{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}, {\"keyword\": \"bmw\", \"match_type \": \"partial_match\", \"search_scope\": [\"answer\"]}]<\/code><br><strong>Note:<\/strong> requests must include at least one <code>domain_entity<\/code> or <code>keyword_entity<\/code> with <code>\"search_filter\": \"include\"<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-domain_entity\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>domain_entity<\/code><\/strong><\/td><td>object<\/td><td><p><em>domain entity in the target array<\/em><br>example:<br><code>{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\", \"search_scope\": [\"sources\"]}<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-domain_entity-domain\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>domain<\/code><\/td><td>string<\/td><td><p><em>target domain<\/em><br><strong>required field if you don't specify <code>keyword<\/code><\/strong><br>you can specify <strong>up to 63 characters<\/strong> in the <code>domain<\/code> field;<br>a domain should be specified without <code>https:\/\/<\/code> and <code>www.<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-domain_entity-search_filter\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_filter<\/code><\/td><td>string<\/td><td><p><em>target domain search filter<\/em><br>optional field<br>possible values:<br><code>include<\/code>, <code>exclude<\/code><br>default value: <code>include<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-domain_entity-search_scope\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_scope<\/code><\/td><td>array<\/td><td><p><em>target domain search scope<\/em><br>optional field<br>possible values:<br><code>any<\/code>, <code>sources<\/code>, <code>search_results<\/code><br>default value: <code>any<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-domain_entity-include_subdomains\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>include_subdomains<\/code><\/td><td>boolean<\/td><td><p><em>indicates if the subdomains of the target <code>domain<\/code> will be included in the search<\/em><br>optional field<br>if set to <code>true<\/code>, the subdomains will be included in the search<br>default value: <code>false<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-keyword_entity\"><td>&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>keyword_entity<\/code><\/strong><\/td><td>object<\/td><td><p><em>keyword entity in the target array<\/em><br>example:<br><code>{\"keyword\": \"bmw\", \"search_filter\": \"include\", \"search_scope\": [\"question\"], \"match_type \": \"partial_match\"}<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-keyword_entity-keyword\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>keyword<\/code><\/td><td>string<\/td><td><p><em>target keyword<\/em><br><strong>required field if you don't specify <code>domain<\/code><\/strong><br>you can specify <strong>up to 250 characters<\/strong> in the <code>keyword<\/code> field<br>all %## will be decoded (plus character \u2018+\u2019 will be decoded to a space character)<br>if you need to use the \u201c%\u201d character for your <code>keyword<\/code>, please specify it as \u201c%25\u201d;<br>if you need to use the \u201c+\u201d character for your <code>keyword<\/code>, please specify it as \u201c%2B\u201d<p>learn more about rules and limitations of <code>keyword<\/code> and <code>keywords<\/code> fields in DataForSEO APIs in this <a href=\"https:\/\/dataforseo.com\/help-center\/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis\" rel=\"noopener noreferrer\" target=\"_blank\">Help Center article<\/a><\/p><\/td><\/tr><tr data-doc-id=\"target-keyword_entity-search_filter\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_filter<\/code><\/td><td>string<\/td><td><p><em>target keyword search filter<\/em><br>optional field<br>possible values:<br><code>include<\/code>, <code>exclude<\/code><br>default value: <code>include<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-keyword_entity-search_scope\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>search_scope<\/code><\/td><td>array<\/td><td><p><em>target keyword search scope<\/em><br>optional field<br>possible values:<br><code>any<\/code>, <code>question<\/code>, <code>answer<\/code>, <code>brand_entities<\/code>, <code>fan_out_queries<\/code><br>default value: <code>any<\/code><\/p><\/td><\/tr><tr data-doc-id=\"target-keyword_entity-match_type\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>match_type<\/code><\/td><td>string<\/td><td><p><em>target keyword match type<\/em><br>optional field<br>word_match -  full-text search for terms that match the specified seed keyword with additional words included before, after, or within the key phrase (e.g., search for \u201clight\u201d will return results with \u201clight bulb\u201d, \u201clight switch\u201d);<br>partial_match - substring search that finds all instances containing the specified sequence of characters, even if it appears inside a longer word (e.g., search for \u201clight\u201d will return results with \u201clighting\u201d, \u201chighlight\u201d);<br>possible values:<br><code>word_match<\/code>, <code>partial_match<\/code><br>default value: <code>word_match<\/code><\/p><\/td><\/tr><tr data-doc-id=\"date_from\"><td><code>date_from<\/code><\/td><td>string<\/td><td><p><em>start date of the time range<\/em><br>optional field<br>minimal value <code>2025-08-01<\/code><br>date format <code>\"yyyy-mm-dd\"<\/code><\/p><\/td><\/tr><tr data-doc-id=\"date_to\"><td><code>date_to<\/code><\/td><td>string<\/td><td><p><em>end date of the time range<\/em><br>optional field<br><strong>Note<\/strong> value specified in <code>date_from<\/code> cannot exceed the value in <code>date_to<\/code><br>date format <code>\"yyyy-mm-dd\"<\/code><\/p><\/td><\/tr><tr data-doc-id=\"location_name\"><td><code>location_name<\/code><\/td><td>string<\/td><td><p><em>full name of search location<\/em><br>optional field<br>if you use this field, you don't need to specify <code>location_code<\/code><br>if you don't specify this field, the <code>location_code<\/code> with <code class=\"long-string\">2840<\/code> value will be used by default;<br>you can receive the list of available locations of the search engine with their <code>location_name<\/code> by making a separate request to the <code><a href=\"https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages\">https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages<\/a><\/code><br><strong>Note:<\/strong> <code>chat_gpt<\/code> data is available for <code class=\"long-string\">United States<\/code> only<\/p><\/td><\/tr><tr data-doc-id=\"location_code\"><td><code>location_code<\/code><\/td><td>integer<\/td><td><p><em>search location code<\/em><br>optional field<br>if you use this field, you don't need to specify <code>location_name<\/code><br>you can receive the list of available locations of the search engine with their <code>location_code<\/code> by making a separate request to the <code><a href=\"https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages\">https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages<\/a><\/code><br>default value: <code class=\"long-string\">2840<\/code><br><strong>Note: <code>chat_gpt<\/code> data is available for <code class=\"long-string\">2840<\/code> only<\/p><\/td><\/tr><tr data-doc-id=\"language_name\"><td><code>language_name<\/code><\/td><td>string<\/td><td><p><em>full name of search language<\/em><br>optional field<br>if you use this field, you don't need to specify <code>language_code<\/code>;<br>if you don't specify this field, the <code>language_code<\/code> with <code class=\"long-string\">en<\/code> value will be used by default;<br>you can receive the list of available languages of the search engine with their <code>language_name<\/code> by making a separate request to the <code><a href=\"https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages\">https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages<\/a><\/code><br><strong>Note: <code>chat_gpt<\/code> data is available for <code class=\"long-string\">English<\/code> only<\/p><\/td><\/tr><tr data-doc-id=\"language_code\"><td><code>language_code<\/code><\/td><td>string<\/td><td><p><em>search language code<\/em><br>optional field<br>if you use this field, you don't need to specify <code>language_name<\/code>;<br>you can receive the list of available languages of the search engine with their <code>language_code<\/code> by making a separate request to the <code><a href=\"https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages\">https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages<\/a><\/code><br>default value: <code class=\"long-string\">en<\/code><br><strong>Note: <code>chat_gpt<\/code> data is available for <code class=\"long-string\">en<\/code> only<\/p><\/td><\/tr><tr data-doc-id=\"platform\"><td><code>platform<\/code><\/td><td>string<\/td><td><p><em>target platform<\/em><br>optional field<br>possible values:<br><code>chat_gpt<\/code>, <code>google<\/code><br><strong>Note:<\/strong> if the <code>platform<\/code> is not specified, the data is returned for both platforms<br><strong>Note #2:<\/strong><code>chat_gpt<\/code> data is available for the <code>United States<\/code> and <code>English<\/code> only<\/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><\/tbody><\/table><\/div><br \/>\n\u200c<br \/>\n\u200c\u200cAs 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.<br \/>\n\u200c<br \/>\n<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 tasks 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-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 resuts returned in the <code>items<\/code> array<\/em><br><\/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>array of historical mention metrics<\/em><br>contains objects with historical mention metrics for the specified target<br>each object contains aggregated mentions metrics for one calendar month<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-year\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>year<\/code><\/td><td>integer<\/td><td><p><em>year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-month\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>month<\/code><\/td><td>integer<\/td><td><p><em>month<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-metrics\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><code>metrics<\/code><\/strong><\/td><td>object<\/td><td><p><em>aggregated mentions metrics for the given month of a year<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-metrics-mentions\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>mentions<\/code><\/td><td>integer<\/td><td><p><em>total LLM mentions count<\/em><br>total count of mentions of the target for the given month<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-metrics-ai_search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>ai_search_volume<\/code><\/td><td>integer<\/td><td><p><em>AI search volume rate<\/em><br>total AI search volume across all mentions of the target for the given month<br>learn more about this metric <a href=\"https:\/\/dataforseo.com\/help-center\/how-the-ai-search-volume-metric-works-in-llm-mentions\" rel=\"noopener noreferrer\" target=\"_blank\">here<\/a><\/p><\/td><\/tr><\/tbody><\/table><\/div><\/div><\/div>\u200c\u200c<br \/>\n[\/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\/ai_optimization\/llm_mentions\/historical\/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_code&quot;: &quot;es&quot;,\r\n        &quot;location_code&quot;: 2840,\r\n        &quot;platform&quot;: &quot;google&quot;,\r\n        &quot;target&quot;: [\r\n            {\r\n                &quot;domain&quot;: &quot;en.wikipedia.org&quot;,\r\n                &quot;search_filter&quot;: &quot;exclude&quot;\r\n            },\r\n            {\r\n                &quot;keyword&quot;: &quot;bmw&quot;,\r\n                &quot;search_scope&quot;: [\r\n                    &quot;answer&quot;\r\n                ]\r\n            }\r\n        ]\r\n    }\r\n]&#039;<\/code><\/pre><\/div><\/div><div id=\"php\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-php hljs\">&lt;?php\r\n\r\n\/**\r\n * Method: POST\r\n * Endpoint: https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/historical\/live\r\n * @see https:\/\/docs.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/historical\/live\r\n *\/\r\n\r\nrequire_once __DIR__ . &#039;\/..\/..\/..\/..\/..\/lib\/RestClient.php&#039;;\r\n$config = require __DIR__ . &#039;\/..\/..\/..\/..\/..\/lib\/config.php&#039;;\r\n\r\n$client = new RestClient($config[&#039;base_url&#039;], null, $config[&#039;login&#039;], $config[&#039;password&#039;]);\r\n\r\n$data = [\r\n    [\r\n        &#039;language_code&#039; =&gt; &#039;es&#039;,\r\n        &#039;location_code&#039; =&gt; 2840,\r\n        &#039;platform&#039; =&gt; &#039;google&#039;,\r\n        &#039;target&#039; =&gt; [\r\n            [\r\n                &#039;domain&#039; =&gt; &#039;en.wikipedia.org&#039;,\r\n                &#039;search_filter&#039; =&gt; &#039;exclude&#039;,\r\n            ],\r\n            [\r\n                &#039;keyword&#039; =&gt; &#039;bmw&#039;,\r\n                &#039;search_scope&#039; =&gt; [\r\n                    &#039;answer&#039;,\r\n                ],\r\n            ],\r\n        ],\r\n    ],\r\n];\r\ntry {\r\n    $result = $client-&gt;post(&#039;\/v3\/ai_optimization\/llm_mentions\/historical\/live&#039;, $data);\r\n    print_r($result);\r\n    \/\/ do something with post result\r\n} catch (RestClientException $e) {\r\n    printf(\r\n        &quot;HTTP code: %dnError code: %dnMessage: %snTrace: %sn&quot;,\r\n        $e-&gt;getHttpCode(),\r\n        $e-&gt;getCode(),\r\n        $e-&gt;getMessage(),\r\n        $e-&gt;getTraceAsString()\r\n    );\r\n}\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 axios = require(&#039;axios&#039;);\r\n\r\naxios({\r\n    method: &#039;post&#039;,\r\n    url: &#039;https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/historical\/live&#039;,\r\n    auth: {\r\n        username: &#039;login&#039;,\r\n        password: &#039;password&#039;\r\n    },\r\n    data: [{\r\n      &quot;language_code&quot;: &quot;es&quot;,\r\n      &quot;location_code&quot;: 2840,\r\n      &quot;platform&quot;: &quot;google&quot;,\r\n      &quot;target&quot;: [\r\n        {\r\n          &quot;domain&quot;: &quot;en.wikipedia.org&quot;,\r\n          &quot;search_filter&quot;: &quot;exclude&quot;\r\n        },\r\n        {\r\n          &quot;keyword&quot;: &quot;bmw&quot;,\r\n          &quot;search_scope&quot;: [\r\n            &quot;answer&quot;\r\n          ]\r\n        }\r\n      ],\r\n    }],\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\">&quot;&quot;&quot;\r\nMethod: POST\r\nEndpoint: https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/historical\/live\r\n@see https:\/\/docs.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/historical\/live\r\n&quot;&quot;&quot;\r\n\r\nimport sys\r\nimport os\r\nsys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), &#039;..\/..\/..\/..\/..\/&#039;)))\r\nfrom lib.client import RestClient\r\nfrom lib.config import username, password\r\nclient = RestClient(username, password)\r\n\r\npost_data = []\r\npost_data.append({\r\n        &#039;language_code&#039;: &#039;es&#039;,\r\n        &#039;location_code&#039;: 2840,\r\n        &#039;platform&#039;: &#039;google&#039;,\r\n        &#039;target&#039;: [\r\n            {\r\n                &#039;domain&#039;: &#039;en.wikipedia.org&#039;,\r\n                &#039;search_filter&#039;: &#039;exclude&#039;\r\n            },\r\n            {\r\n                &#039;keyword&#039;: &#039;bmw&#039;,\r\n                &#039;search_scope&#039;: [\r\n                    &#039;answer&#039;\r\n                ]\r\n            }\r\n        ],\r\n        &#039;internal_list_limit&#039;: 10\r\n    })\r\ntry:\r\n    response = client.post(&#039;\/v3\/ai_optimization\/llm_mentions\/historical\/live&#039;, post_data)\r\n    print(response)\r\n    # do something with post result\r\nexcept Exception as e:\r\n    print(f&#039;An error occurred: {e}&#039;)<\/code><\/pre><\/div><\/div><div id=\"csharp\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-csharp hljs\">\/\/\/ &lt;summary&gt;\r\n    \/\/\/ Method: POST\r\n    \/\/\/ Endpoint: https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/historical\/live\r\n    \/\/\/ &lt;\/summary&gt;\r\n    \/\/\/ &lt;see href=&quot;https:\/\/docs.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/historical\/live&quot;\/&gt;\r\n    \r\n    public static async Task LlmMentionsAggregatedMetricsLive()\r\n    {\r\n        var postData = new List&lt;object&gt;();\r\n        \/\/ a simple way to set a task, the full list of possible parameters is available in documentation\r\n        postData.Add(new\r\n        {\r\n            language_code = &quot;es&quot;,\r\n            location_code = 2840,\r\n            platform = &quot;google&quot;,\r\n            target = new object[]\r\n            {\r\n                new\r\n                {\r\n                    domain = &quot;en.wikipedia.org&quot;,\r\n                    search_filter = &quot;exclude&quot;\r\n                },\r\n                new\r\n                {\r\n                    keyword = &quot;bmw&quot;,\r\n                    search_scope = new object[]\r\n                    {\r\n                        &quot;answer&quot;\r\n                    }\r\n                }\r\n            },\r\n            initial_dataset_filters = new object[]\r\n        });\r\n\r\n        var content = new StringContent(JsonConvert.SerializeObject(postData), Encoding.UTF8, &quot;application\/json&quot;);\r\n        using var response = await _httpClient.PostAsync(&quot;\/v3\/ai_optimization\/llm_mentions\/historical\/live&quot;, content);\r\n        var result = JsonConvert.DeserializeObject&lt;dynamic&gt;(await response.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    }<\/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.20251208&quot;,\r\n  &quot;status_code&quot;: 20000,\r\n  &quot;status_message&quot;: &quot;Ok.&quot;,\r\n  &quot;time&quot;: &quot;1.9593 sec.&quot;,\r\n  &quot;cost&quot;: 0.101,\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;12121212-1535-0635-0000-a76352adde37&quot;,\r\n      &quot;status_code&quot;: 20000,\r\n      &quot;status_message&quot;: &quot;Ok.&quot;,\r\n      &quot;time&quot;: &quot;1.9079 sec.&quot;,\r\n      &quot;cost&quot;: 0.101,\r\n      &quot;result_count&quot;: 1,\r\n      &quot;path&quot;: [\r\n        &quot;v3&quot;,\r\n        &quot;ai_optimization&quot;,\r\n        &quot;llm_mentions&quot;,\r\n        &quot;historical&quot;,\r\n        &quot;live&quot;\r\n      ],\r\n      &quot;data&quot;: {\r\n        &quot;api&quot;: &quot;ai_optimization&quot;,\r\n        &quot;function&quot;: &quot;historical&quot;,\r\n        &quot;language_code&quot;: &quot;es&quot;,\r\n        &quot;location_code&quot;: 2840,\r\n        &quot;platform&quot;: &quot;google&quot;,\r\n        &quot;target&quot;: [\r\n          {\r\n            &quot;domain&quot;: &quot;en.wikipedia.org&quot;,\r\n            &quot;search_filter&quot;: &quot;exclude&quot;\r\n          },\r\n          {\r\n            &quot;keyword&quot;: &quot;bmw&quot;,\r\n            &quot;search_scope&quot;: [\r\n              &quot;answer&quot;\r\n            ]\r\n          }\r\n        ]\r\n      },\r\n      &quot;result&quot;: [\r\n        {\r\n          &quot;items_count&quot;: 12,\r\n          &quot;items&quot;: [\r\n            {\r\n              &quot;year&quot;: 2026,\r\n              &quot;month&quot;: 6,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 8,\r\n                &quot;ai_search_volume&quot;: 339\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2026,\r\n              &quot;month&quot;: 5,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 35,\r\n                &quot;ai_search_volume&quot;: 1198\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2026,\r\n              &quot;month&quot;: 4,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 48,\r\n                &quot;ai_search_volume&quot;: 3024\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2026,\r\n              &quot;month&quot;: 3,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 53,\r\n                &quot;ai_search_volume&quot;: 1693\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2026,\r\n              &quot;month&quot;: 2,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 43,\r\n                &quot;ai_search_volume&quot;: 1792\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2026,\r\n              &quot;month&quot;: 1,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 82,\r\n                &quot;ai_search_volume&quot;: 2137\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2025,\r\n              &quot;month&quot;: 12,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 17,\r\n                &quot;ai_search_volume&quot;: 415\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2025,\r\n              &quot;month&quot;: 11,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 57,\r\n                &quot;ai_search_volume&quot;: 4560\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2025,\r\n              &quot;month&quot;: 10,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 25,\r\n                &quot;ai_search_volume&quot;: 1250\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2025,\r\n              &quot;month&quot;: 9,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 0,\r\n                &quot;ai_search_volume&quot;: 0\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2025,\r\n              &quot;month&quot;: 8,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 0,\r\n                &quot;ai_search_volume&quot;: 0\r\n              }\r\n            },\r\n            {\r\n              &quot;year&quot;: 2025,\r\n              &quot;month&quot;: 7,\r\n              &quot;metrics&quot;: {\r\n                &quot;mentions&quot;: 0,\r\n                &quot;ai_search_volume&quot;: 0\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] Live LLM Mentions Historical \u200c\u200c Live LLM Mentions Historical endpoint provides month-by-month historical metrics for mentions of the keywords or domains specified in the target array of the request. For each month, the response returns the total mentions count and ai_search_volume rate. The results are specific to the selected platform (google for Google&#8217;s AI [&hellip;]<\/p>\n","protected":false},"author":14,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"parameters:\n  - name: target\n    type: array\n    description: |\n      <em>array of objects containing target entities<\/em><br><strong>required field<\/strong><br>you can specify <strong>up to 10 entities (objects)<\/strong> in the <code>target<\/code> field<br>one target entity can contain either one <code>domain<\/code> or one <code>keyword<\/code> and related parameters<p>examples: <p>target array with a domain entity<br><code>[{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}]<\/code><br>target array with a keyword entity<br><code>[{\"keyword\": \"bmw\", \"search_scope\": [\"question\"], \"match_type \": \"partial_match\"}]<\/code><br>target array with multiple entities<br><code>[{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}, {\"keyword\": \"bmw\", \"match_type \": \"partial_match\", \"search_scope\": [\"answer\"]}]<\/code><br><strong>Note:<\/strong> requests must include at least one <code>domain_entity<\/code> or <code>keyword_entity<\/code> with <code>\"search_filter\": \"include\"<\/code>\n    items:\n      children:\n        - name: domain_entity\n          type: object\n          description: |\n            <em>domain entity in the target array<\/em><br>example:<br><code>{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\", \"search_scope\": [\"sources\"]}<\/code>\n          children:\n            - name: domain\n              type: string\n              description: |\n                <em>target domain<\/em><br><strong>required field if you don't specify <code>keyword<\/code><\/strong><br>you can specify <strong>up to 63 characters<\/strong> in the <code>domain<\/code> field;<br>a domain should be specified without <code>https:\/\/<\/code> and <code>www.<\/code>\n            - name: search_filter\n              type: string\n              description: |\n                <em>target domain search filter<\/em><br>optional field<br>possible values:<br><code>include<\/code>, <code>exclude<\/code><br>default value: <code>include<\/code>\n            - name: search_scope\n              type: array\n              description: |\n                <em>target domain search scope<\/em><br>optional field<br>possible values:<br><code>any<\/code>, <code>sources<\/code>, <code>search_results<\/code><br>default value: <code>any<\/code>\n            - name: include_subdomains\n              type: boolean\n              description: |\n                <em>indicates if the subdomains of the target <code>domain<\/code> will be included in the search<\/em><br>optional field<br>if set to <code>true<\/code>, the subdomains will be included in the search<br>default value: <code>false<\/code>\n        - name: keyword_entity\n          type: object\n          description: |\n            <em>keyword entity in the target array<\/em><br>example:<br><code>{\"keyword\": \"bmw\", \"search_filter\": \"include\", \"search_scope\": [\"question\"], \"match_type \": \"partial_match\"}<\/code>\n          children:\n            - name: keyword\n              type: string\n              description: |\n                <em>target keyword<\/em><br><strong>required field if you don't specify <code>domain<\/code><\/strong><br>you can specify <strong>up to 250 characters<\/strong> in the <code>keyword<\/code> field<br>all %## will be decoded (plus character \u2018+\u2019 will be decoded to a space character)<br>if you need to use the \u201c%\u201d character for your <code>keyword<\/code>, please specify it as \u201c%25\u201d;<br>if you need to use the \u201c+\u201d character for your <code>keyword<\/code>, please specify it as \u201c%2B\u201d<p>learn more about rules and limitations of <code>keyword<\/code> and <code>keywords<\/code> fields in DataForSEO APIs in this <a href=\"https:\/\/dataforseo.com\/help-center\/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis\" rel=\"noopener noreferrer\" target=\"_blank\">Help Center article<\/a>\n            - name: search_filter\n              type: string\n              description: |\n                <em>target keyword search filter<\/em><br>optional field<br>possible values:<br><code>include<\/code>, <code>exclude<\/code><br>default value: <code>include<\/code>\n            - name: search_scope\n              type: array\n              description: |\n                <em>target keyword search scope<\/em><br>optional field<br>possible values:<br><code>any<\/code>, <code>question<\/code>, <code>answer<\/code>, <code>brand_entities<\/code>, <code>fan_out_queries<\/code><br>default value: <code>any<\/code>\n            - name: match_type\n              type: string\n              description: |\n                <em>target keyword match type<\/em><br>optional field<br>word_match -  full-text search for terms that match the specified seed keyword with additional words included before, after, or within the key phrase (e.g., search for \u201clight\u201d will return results with \u201clight bulb\u201d, \u201clight switch\u201d);<br>partial_match - substring search that finds all instances containing the specified sequence of characters, even if it appears inside a longer word (e.g., search for \u201clight\u201d will return results with \u201clighting\u201d, \u201chighlight\u201d);<br>possible values:<br><code>word_match<\/code>, <code>partial_match<\/code><br>default value: <code>word_match<\/code>\n  - name: date_from\n    type: string\n    description: |\n      <em>start date of the time range<\/em><br>optional field<br>minimal value <code>2025-08-01<\/code><br>date format <code>\"yyyy-mm-dd\"<\/code>\n  - name: date_to\n    type: string\n    description: |\n      <em>end date of the time range<\/em><br>optional field<br><strong>Note<\/strong> value specified in <code>date_from<\/code> cannot exceed the value in <code>date_to<\/code><br>date format <code>\"yyyy-mm-dd\"<\/code>\n  - name: location_name\n    type: string\n    description: |\n      <em>full name of search location<\/em><br>optional field<br>if you use this field, you don't need to specify <code>location_code<\/code><br>if you don't specify this field, the <code>location_code<\/code> with <code class=\"long-string\">2840<\/code> value will be used by default;<br>you can receive the list of available locations of the search engine with their <code>location_name<\/code> by making a separate request to the <code>https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages<\/code><br><strong>Note:<\/strong> <code>chat_gpt<\/code> data is available for <code class=\"long-string\">United States<\/code> only\n  - name: location_code\n    type: integer\n    description: |\n      <em>search location code<\/em><br>optional field<br>if you use this field, you don't need to specify <code>location_name<\/code><br>you can receive the list of available locations of the search engine with their <code>location_code<\/code> by making a separate request to the <code>https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages<\/code><br>default value: <code class=\"long-string\">2840<\/code><br><strong>Note: <code>chat_gpt<\/code> data is available for <code class=\"long-string\">2840<\/code> only\n  - name: language_name\n    type: string\n    description: |\n      <em>full name of search language<\/em><br>optional field<br>if you use this field, you don't need to specify <code>language_code<\/code>;<br>if you don't specify this field, the <code>language_code<\/code> with <code class=\"long-string\">en<\/code> value will be used by default;<br>you can receive the list of available languages of the search engine with their <code>language_name<\/code> by making a separate request to the <code>https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages<\/code><br><strong>Note: <code>chat_gpt<\/code> data is available for <code class=\"long-string\">English<\/code> only\n  - name: language_code\n    type: string\n    description: \"<em>search language code<\/em><br>optional field<br>if you use this field, you don't need to specify <code>language_name<\/code>;<br>you can receive the list of available languages of the search engine with their <code>language_code<\/code> by making a separate request to the <code>https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/locations_and_languages<\/code><br>default value: <code class=\"long-string\">en<\/code><br><strong>Note: <code>chat_gpt<\/code> data is available for <code class=\"long-string\">en<\/code> only\"\n  - name: platform\n    type: string\n    description: |\n      <em>target platform<\/em><br>optional field<br>possible values:<br><code>chat_gpt<\/code>, <code>google<\/code><br><strong>Note:<\/strong> if the <code>platform<\/code> is not specified, the data is returned for both platforms<br><strong>Note #2:<\/strong><code>chat_gpt<\/code> data is available for the <code>United States<\/code> and <code>English<\/code> only\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","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 tasks 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: items_count\n                type: integer\n                description: |\n                  <em>the number of resuts returned in the <code>items<\/code> array<\/em><br>\n              - name: items\n                type: array\n                description: |\n                  <em>array of historical mention metrics<\/em><br>contains objects with historical mention metrics for the specified target<br>each object contains aggregated mentions metrics for one calendar month\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: metrics\n                    type: object\n                    description: |\n                      <em>aggregated mentions metrics for the given month of a year<\/em>\n                    children:\n                      - name: mentions\n                        type: integer\n                        description: |\n                          <em>total LLM mentions count<\/em><br>total count of mentions of the target for the given month\n                      - name: ai_search_volume\n                        type: integer\n                        description: |\n                          <em>AI search volume rate<\/em><br>total AI search volume across all mentions of the target for the given month<br>learn more about this metric <a href=\"https:\/\/dataforseo.com\/help-center\/how-the-ai-search-volume-metric-works-in-llm-mentions\" rel=\"noopener noreferrer\" target=\"_blank\">here<\/a>","footnotes":""},"class_list":["post-24595","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/24595","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=24595"}],"version-history":[{"count":6,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/24595\/revisions"}],"predecessor-version":[{"id":24700,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/24595\/revisions\/24700"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=24595"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}