{"id":24607,"date":"2026-06-08T08:22:13","date_gmt":"2026-06-08T08:22:13","guid":{"rendered":"https:\/\/docs.dataforseo.com\/v3\/?page_id=24607"},"modified":"2026-07-07T09:30:37","modified_gmt":"2026-07-07T09:30:37","slug":"ai_optimization-llm_mentions-timeseries_new_lost-live","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/ai_optimization-llm_mentions-timeseries_new_lost-live\/","title":{"rendered":"ai_optimization\/llm_mentions\/timeseries_new_lost\/live"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h2>Live LLM Mentions Timeseries New and Lost<\/h2>\n<p>\u200c\u200c<br \/>\nThis endpoint will provide you with the number of new and lost LLM mentions, as well as <code>ai_search_volume<\/code> for the domain or keyword specified in the <code>target<\/code> field. <\/p>\n<p>The values are calculated based on the proprietary database of LLM responses. The <code>lost<\/code> values indicate the LLM responses that previously contained the specified target, do not contain it anymore. Accordingly, <code>new<\/code> values indicate the LLM responses that contain the target at the <code>date_to<\/code> timestamp, did not contain it at the <code>date_from<\/code> timestamp.<\/p>\n<p>Historical data is available from 2025-08-01.<\/p>\n<p>[\/vc_column_text]<br \/>\n    <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\/timeseries_new_lost\/live\">\n                https:\/\/api.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/timeseries_new_lost\/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>defines how the specified keyword is matched<br>optional field<br>possible values:<br><code>word_match<\/code> - 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 \"light\" will return results with \"light bulb\", \"light switch\");<br><code>partial_match<\/code> - substring search that finds all instances containing the specified sequence of characters, even if it appears inside a longer word (e.g., search for \"light\" will return results with \"lighting\", \"highlight\");<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><strong>required field<\/strong><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><strong>required field<\/strong><br><strong>Note:<\/strong>the 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=\"group_range\"><td><code>group_range<\/code><\/td><td>string<\/td><td><p><em>timeseries range<\/em><br><strong>required field<\/strong><br>possible values:<br><code>day<\/code>, <code>week<\/code>, <code>month<\/code>, <code>year<\/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: <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>default value: <code class=\"long-string\">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 results returned in the <code>items<\/code> array<\/em><\/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 relevant LLM mentions timeseries data<\/em><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-date\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>date<\/code><\/td><td>string<\/td><td><p><em>date timestamp<\/em><br> date format: <code>\"yyyy-mm-dd\"<\/code><\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-new_mentions\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>new_mentions<\/code><\/td><td>integer<\/td><td><p><em>new LLM mentions<\/em><br>indicates the LLM responses that contain the target at the <code>date_to<\/code> timestamp, did not contain it at the <code>date_from<\/code> timestamp<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-lost_mentions\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>lost_mentions<\/code><\/td><td>integer<\/td><td><p><em>lost LLM mentions<\/em><br>indicates the LLM responses that contained the specified target at the <code>date_from<\/code> timestamp, do not contain it at the <code>date_to<\/code> timestamp<\/p><\/td><\/tr><tr data-doc-id=\"tasks-result-items-new_ai_search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>new_ai_search_volume<\/code><\/td><td>integer<\/td><td><p><em>ai_search_volume increment<\/em><br>indicates the increase of <code>ai_search_volume<\/code> values between the current timestamp and the previous one<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><tr data-doc-id=\"tasks-result-items-lost_ai_search_volume\"><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<code>lost_ai_search_volume<\/code><\/td><td>integer<\/td><td><p><em>ai_search_volume decrement<\/em><br>indicates the decrease of <code>ai_search_volume<\/code> values between the current timestamp and the previous one<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><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\/ai_optimization\/llm_mentions\/timeseries_new_lost\/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;target&quot;: [\r\n            {\r\n                &quot;domain&quot;: &quot;dataforseo.com&quot;,\r\n                &quot;search_filter&quot;: &quot;exclude&quot;\r\n            },\r\n            {\r\n                &quot;keyword&quot;: &quot;serp&quot;,\r\n                &quot;search_scope&quot;: [\r\n                    &quot;answer&quot;\r\n                ]\r\n            }\r\n        ],\r\n        &quot;platform&quot;: &quot;google&quot;,\r\n        &quot;date_from&quot;: &quot;2025-08-01&quot;,\r\n        &quot;date_to&quot;: &quot;2025-12-01&quot;,\r\n        &quot;group_range&quot;: &quot;month&quot;\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\/timeseries_new_lost\/live\r\n * @see https:\/\/docs.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/timeseries_new_lost\/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_name&#039; =&gt; &#039;English&#039;,\r\n        &#039;location_code&#039; =&gt; 2840,\r\n        &#039;target&#039; =&gt; [\r\n            [\r\n                &#039;domain&#039; =&gt; &#039;dataforseo.com&#039;,\r\n                &#039;search_filter&#039; =&gt; &#039;exclude&#039;,\r\n            ],\r\n            [\r\n                &#039;keyword&#039; =&gt; &#039;serp&#039;,\r\n                &#039;search_scope&#039; =&gt; [\r\n                    &#039;answer&#039;,\r\n                ],\r\n            ],\r\n        ],\r\n        &#039;platform&#039; =&gt; &#039;google&#039;,\r\n        &#039;date_from&#039; =&gt; &#039;2025-08-01&#039;,\r\n        &#039;date_to&#039; =&gt; &#039;2025-12-01&#039;,\r\n        &#039;group_range&#039; =&gt; &#039;month&#039;\r\n    ],\r\n];\r\ntry {\r\n    $result = $client-&gt;post(&#039;\/v3\/ai_optimization\/llm_mentions\/timeseries_new_lost\/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}<\/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\/timeseries_new_lost\/live&#039;,\r\n    auth: {\r\n        username: &#039;login&#039;,\r\n        password: &#039;password&#039;\r\n    },\r\n    data: [\r\n    {\r\n      &quot;language_name&quot;: &quot;English&quot;,\r\n      &quot;location_code&quot;: 2840,\r\n      &quot;target&quot;: [\r\n        {\r\n          &quot;domain&quot;: &quot;dataforseo.com&quot;,\r\n          &quot;search_filter&quot;: &quot;exclude&quot;\r\n        },\r\n        {\r\n          &quot;keyword&quot;: &quot;serp&quot;,\r\n          &quot;search_scope&quot;: [\r\n            &quot;answer&quot;\r\n          ]\r\n        }\r\n      ],\r\n      &quot;platform&quot;: &quot;google&quot;,\r\n      &quot;date_from&quot;: &quot;2025-08-01&quot;,\r\n      &quot;date_to&quot;: &quot;2025-12-01&quot;,\r\n      &quot;group_range&quot;: &quot;month&quot;\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\/timeseries_new_lost\/live\r\n@see https:\/\/docs.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/timeseries_new_lost\/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_name&#039;: &#039;English&#039;,\r\n        &#039;location_code&#039;: 2840,\r\n        &#039;target&#039;: [\r\n            {\r\n                &#039;domain&#039;: &#039;dataforseo.com&#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;platform&#039;: &#039;google&#039;,\r\n        &#039;date_from&#039;: &#039;2025-08-01&#039;,\r\n        &#039;date_to&#039;: &#039;2025-12-01&#039;,\r\n        &#039;group_range&#039;: &#039;month&#039;\r\n    })\r\ntry:\r\n    response = client.post(&#039;\/v3\/ai_optimization\/llm_mentions\/timeseries_new_lost\/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\/timeseries_new_lost\/live\r\n    \/\/\/ &lt;\/summary&gt;\r\n    \/\/\/ &lt;see href=&quot;https:\/\/docs.dataforseo.com\/v3\/ai_optimization\/llm_mentions\/timeseries_new_lost\/live&quot;\/&gt;\r\n    \r\n    public static async Task LlmMentionsSearchLive()\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_name = &quot;English&quot;,\r\n            location_code = 2840,\r\n            target = new object[]\r\n            {\r\n                new\r\n                {\r\n                    domain = &quot;dataforseo.com&quot;,\r\n                    search_filter = &quot;exclude&quot;\r\n                },\r\n                new\r\n                {\r\n                    keyword = &quot;serp&quot;,\r\n                    search_scope = new object[]\r\n                    {\r\n                        &quot;answer&quot;\r\n                    }\r\n                }\r\n            },\r\n            platform = &quot;google&quot;,\r\n            date_from: &quot;2025-08-01&quot;,\r\n            date_to: &quot;2025-12-01&quot;,\r\n            group_range: &quot;month&quot;\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\/timeseries_new_lost\/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.20260527&quot;,\r\n  &quot;status_code&quot;: 20000,\r\n  &quot;status_message&quot;: &quot;Ok.&quot;,\r\n  &quot;time&quot;: &quot;3.0889 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;06100645-1444-0664-0000-524947c5cdf2&quot;,\r\n      &quot;status_code&quot;: 20000,\r\n      &quot;status_message&quot;: &quot;Ok.&quot;,\r\n      &quot;time&quot;: &quot;1.5408 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;timeseries_new_lost&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;timeseries_new_lost&quot;,\r\n        &quot;target&quot;: [\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            &quot;search_filter&quot;: &quot;include&quot;\r\n          }\r\n        ],\r\n        &quot;platform&quot;: &quot;chat_gpt&quot;,\r\n        &quot;language_code&quot;: &quot;en&quot;,\r\n        &quot;location_code&quot;: 2840,\r\n        &quot;date_from&quot;: &quot;2025-08-01&quot;,\r\n        &quot;date_to&quot;: &quot;2025-12-01&quot;,\r\n        &quot;group_range&quot;: &quot;month&quot;\r\n      },\r\n      &quot;result&quot;: [\r\n        {\r\n          &quot;items_count&quot;: 5,\r\n          &quot;items&quot;: [\r\n            {\r\n              &quot;date&quot;: &quot;2025-08-01&quot;,\r\n              &quot;new_mentions&quot;: 24484,\r\n              &quot;lost_mentions&quot;: 353,\r\n              &quot;new_ai_search_volume&quot;: 828463,\r\n              &quot;lost_ai_search_volume&quot;: 185026\r\n            },\r\n            {\r\n              &quot;date&quot;: &quot;2025-09-01&quot;,\r\n              &quot;new_mentions&quot;: 892,\r\n              &quot;lost_mentions&quot;: 22707,\r\n              &quot;new_ai_search_volume&quot;: 44335,\r\n              &quot;lost_ai_search_volume&quot;: 771671\r\n            },\r\n            {\r\n              &quot;date&quot;: &quot;2025-10-01&quot;,\r\n              &quot;new_mentions&quot;: 8444,\r\n              &quot;lost_mentions&quot;: 2581,\r\n              &quot;new_ai_search_volume&quot;: 244776,\r\n              &quot;lost_ai_search_volume&quot;: 97351\r\n            },\r\n            {\r\n              &quot;date&quot;: &quot;2025-11-01&quot;,\r\n              &quot;new_mentions&quot;: 14403,\r\n              &quot;lost_mentions&quot;: 8159,\r\n              &quot;new_ai_search_volume&quot;: 352467,\r\n              &quot;lost_ai_search_volume&quot;: 236301\r\n            },\r\n            {\r\n              &quot;date&quot;: &quot;2025-12-01&quot;,\r\n              &quot;new_mentions&quot;: 3934,\r\n              &quot;lost_mentions&quot;: 14155,\r\n              &quot;new_ai_search_volume&quot;: 135238,\r\n              &quot;lost_ai_search_volume&quot;: 328155\r\n            }\r\n          ],\r\n          &quot;date_from&quot;: &quot;2025-08-01&quot;,\r\n          &quot;date_to&quot;: &quot;2025-12-01&quot;,\r\n          &quot;group_range&quot;: &quot;month&quot;\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 Timeseries New and Lost \u200c\u200c This endpoint will provide you with the number of new and lost LLM mentions, as well as ai_search_volume for the domain or keyword specified in the target field. The values are calculated based on the proprietary database of LLM responses. The lost values indicate the LLM [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"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>defines how the specified keyword is matched<br>optional field<br>possible values:<br><code>word_match<\/code> - 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 \"light\" will return results with \"light bulb\", \"light switch\");<br><code>partial_match<\/code> - substring search that finds all instances containing the specified sequence of characters, even if it appears inside a longer word (e.g., search for \"light\" will return results with \"lighting\", \"highlight\");<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><strong>required field<\/strong><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><strong>required field<\/strong><br><strong>Note:<\/strong>the 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: group_range\n    type: string\n    description: |\n      <em>timeseries range<\/em><br><strong>required field<\/strong><br>possible values:<br><code>day<\/code>, <code>week<\/code>, <code>month<\/code>, <code>year<\/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: <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>default value: <code class=\"long-string\">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 results returned in the <code>items<\/code> array<\/em>\n              - name: items\n                type: array\n                description: |\n                  <em>contains relevant LLM mentions timeseries data<\/em>\n                items:\n                  children:\n                    - name: date\n                      type: string\n                      description: |\n                        <em>date timestamp<\/em><br> date format: <code>\"yyyy-mm-dd\"<\/code>\n                    - name: new_mentions\n                      type: integer\n                      description: |\n                        <em>new LLM mentions<\/em><br>indicates the LLM responses that contain the target at the <code>date_to<\/code> timestamp, did not contain it at the <code>date_from<\/code> timestamp\n                    - name: lost_mentions\n                      type: integer\n                      description: |\n                        <em>lost LLM mentions<\/em><br>indicates the LLM responses that contained the specified target at the <code>date_from<\/code> timestamp, do not contain it at the <code>date_to<\/code> timestamp\n                    - name: new_ai_search_volume\n                      type: integer\n                      description: |\n                        <em>ai_search_volume increment<\/em><br>indicates the increase of <code>ai_search_volume<\/code> values between the current timestamp and the previous one<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>\n                    - name: lost_ai_search_volume\n                      type: integer\n                      description: |\n                        <em>ai_search_volume decrement<\/em><br>indicates the decrease of <code>ai_search_volume<\/code> values between the current timestamp and the previous one<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-24607","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/24607","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=24607"}],"version-history":[{"count":9,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/24607\/revisions"}],"predecessor-version":[{"id":24707,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/24607\/revisions\/24707"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=24607"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}