Change in LLM mentions between two dates for a target
dataforseo.x.ai-optimization-llm-mentions-timeseries-delta-liveThe Live LLM Mentions Timeseries Delta endpoint provides the difference in historical mentions and AI search volume data between two specified dates.
- Preço
- $0.105/callPelo preço de tabela
- Taxa de sucesso
- —Ainda não há dados da taxa de sucessoÚltimos 30 dias · 1 chamadas
- Latência p50
- ——
- Última verificação
- 28 de jul. de 2026Verificado e funcionando
POSThttps://toolswitch.dev/v1/tools/dataforseo.x.ai-optimization-llm-mentions-timeseries-delta-liveBeta- Usa a cota da plataforma
- Resposta síncrona
- Lê dados públicos
Parâmetros
the POST body is a JSON array holding exactly one task object with these fields; a live route rejects extra tasks with status 40000 "You can set only one task at a time"
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Corpo (JSON) | ||||
tag | string | Opcional | <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 | |
target | matriz | Opcional | array of objects containing target entities. Required field. You can specify up to 10 entities (objects) in the target field. One target entity can contain either one domain or one keyword and related parameters. All target entities are AND-combined into one filter / one metrics series (not one series per brand). To compare brands: use dataforseo.x.ai-optimization-llm-mentions-multi-target-metrics-live, or one call per brand. | [{"domain":"dataforseo.com","search_filter":"exclude"},{"keyword":"bmw","search_scope":["answer"]}] |
date_to | string | Opcional | <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> | 2025-12-01 |
platform | string | Opcional | target platform. Optional field. Possible values: chat_gpt, google. When omitted, DataForSEO defaults to google only (not both platforms). chat_gpt data is available for the United States and English only (location 2840 / US + language en; else task status 40501). | google |
date_from | string | Opcional | <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> | 2025-08-01 |
group_range | string | Opcional | <em>timeseries delta range</em><br><strong>required field</strong><br>possible values:<br><code>day</code>, <code>week</code>, <code>month</code>, <code>year</code> | month |
language_code | string | Opcional | <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.datafors | |
language_name | string | Opcional | <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 li | English |
location_code | inteiro | Opcional | search location code. Optional field. If you use this field, you don't need to specify location_name. Default is 2840 (United States). With platform=chat_gpt, only 2840 is valid; any other code (e.g. 2036) returns task status 40501 Invalid Field: 'location_code'. The HTTP envelope may still be 200 / top-level status_code 20000 Ok with items_count=0 — always check tasks[].status_code / status_message. | 2840 |
location_name | string | Opcional | full name of search location. Optional field. If you use this field, you don't need to specify location_code. Default is United States (location_code 2840). With platform=chat_gpt, only United States is valid; other names return the same task status 40501 Invalid Field on location. The HTTP envelope may still be 200 / top-level status_code 20000 Ok with items_count=0 — always check tasks[].status_code / status_message. | |
- Corpo (JSON)
tagstringOpcional<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
targetmatrizOpcionalarray of objects containing target entities. Required field. You can specify up to 10 entities (objects) in the target field. One target entity can contain either one domain or one keyword and related parameters. All target entities are AND-combined into one filter / one metrics series (not one series per brand). To compare brands: use dataforseo.x.ai-optimization-llm-mentions-multi-target-metrics-live, or one call per brand.
Exemplo:
[{"domain":"dataforseo.com","search_filter":"exclude"},{"keyword":"bmw","search_scope":["answer"]}]date_tostringOpcional<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>
Exemplo:
2025-12-01platformstringOpcionaltarget platform. Optional field. Possible values: chat_gpt, google. When omitted, DataForSEO defaults to google only (not both platforms). chat_gpt data is available for the United States and English only (location 2840 / US + language en; else task status 40501).
Exemplo:
googledate_fromstringOpcional<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>
Exemplo:
2025-08-01group_rangestringOpcional<em>timeseries delta range</em><br><strong>required field</strong><br>possible values:<br><code>day</code>, <code>week</code>, <code>month</code>, <code>year</code>
Exemplo:
monthlanguage_codestringOpcional<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.datafors
language_namestringOpcional<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 li
Exemplo:
Englishlocation_codeinteiroOpcionalsearch location code. Optional field. If you use this field, you don't need to specify location_name. Default is 2840 (United States). With platform=chat_gpt, only 2840 is valid; any other code (e.g. 2036) returns task status 40501 Invalid Field: 'location_code'. The HTTP envelope may still be 200 / top-level status_code 20000 Ok with items_count=0 — always check tasks[].status_code / status_message.
Exemplo:
2840location_namestringOpcionalfull name of search location. Optional field. If you use this field, you don't need to specify location_code. Default is United States (location_code 2840). With platform=chat_gpt, only United States is valid; other names return the same task status 40501 Invalid Field on location. The HTTP envelope may still be 200 / top-level status_code 20000 Ok with items_count=0 — always check tasks[].status_code / status_message.
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
curl -X POST 'https://toolswitch.dev/v1/tools/dataforseo.x.ai-optimization-llm-mentions-timeseries-delta-live' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '[{"target":[{"domain":"dataforseo.com","search_filter":"exclude"},{"keyword":"bmw","search_scope":["answer"]}],"date_to":"2025-12-01","platform":"google","date_from":"2025-08-01","group_range":"month","language_name":"English","location_code":2840}]'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/dataforseo.x.ai-optimization-llm-mentions-timeseries-delta-live",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("[{\"target\":[{\"domain\":\"dataforseo.com\",\"search_filter\":\"exclude\"},{\"keyword\":\"bmw\",\"search_scope\":[\"answer\"]}],\"date_to\":\"2025-12-01\",\"platform\":\"google\",\"date_from\":\"2025-08-01\",\"group_range\":\"month\",\"language_name\":\"English\",\"location_code\":2840}]"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/dataforseo.x.ai-optimization-llm-mentions-timeseries-delta-live", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("[{\"target\":[{\"domain\":\"dataforseo.com\",\"search_filter\":\"exclude\"},{\"keyword\":\"bmw\",\"search_scope\":[\"answer\"]}],\"date_to\":\"2025-12-01\",\"platform\":\"google\",\"date_from\":\"2025-08-01\",\"group_range\":\"month\",\"language_name\":\"English\",\"location_code\":2840}]")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Esta API de gateway está em Beta; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.105/call, incluindo a taxa de serviço.