# Change in LLM mentions between two dates for a target

The Live LLM Mentions Timeseries Delta endpoint provides the difference in historical mentions and AI search volume data between two specified dates.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-ai-optimization-llm-mentions-timeseries-delta-live` |
| Platform | [AI search visibility](https://www.orcarouter.ai/tools/ai-search.md) |
| Capability | [AI answer visibility](https://www.orcarouter.ai/tools/ai-search/ai-visibility.md) |
| Price | $0.1155 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `date_from` | string | no | \<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> |
| `date_to` | string | no | \<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> |
| `group_range` | string | no | \<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> |
| `language_code` | string | no | \<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 | no | \<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 |
| `location_code` | integer | no | 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 … |
| `location_name` | string | no | 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 envelop… |
| `platform` | string | no | 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). |
| `tag` | string | no | \<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` | array | no | 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 ser… |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-ai-optimization-llm-mentions-timeseries-delta-live/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/dataforseo.x-ai-optimization-llm-mentions-timeseries-delta-live/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [ChatGPT search results for a keyword, live](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-chat-gpt-llm-scraper-live-advanced.md) | — | $0.0044 per call | OK |
| [Gemini search results for a keyword, live](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-gemini-llm-scraper-live-advanced.md) | — | $0.0044 per call | OK |
| [Perplexity answer to a prompt, live](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-perplexity-llm-responses-live.md) | — | $0.006448 per call | OK |
| [Brave AI Mode answer for a query](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-brave-ai-mode.md) | — | $0.0275 per call | OK |
| [ChatGPT answer to a prompt, live](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-chat-gpt-llm-responses-live.md) | — | $0.032174 per call | OK |
| [Gemini answer to a prompt, live](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-gemini-llm-responses-live.md) | — | $0.039882 per call | OK |
| [Monthly LLM mention history for a keyword or domain](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-llm-mentions-historical-live.md) | — | $0.1111 per call | OK |
| [LLM mention metrics for a keyword or domain, lite](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-llm-mentions-target-metrics-lite-live.md) | — | $0.1111 per call | OK |
| [LLM mention metrics for a keyword or domain](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-llm-mentions-target-metrics-live.md) | — | $0.1111 per call | OK |
| [Search LLM mentions of a keyword or domain in AI answers](https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-llm-mentions-search-mentions-live.md) | — | $0.1133 per call | OK |

Showing the first 10 of 20.

## FAQ

### How much does Change in LLM mentions between two dates for a target cost?

Change in LLM mentions between two dates for a target costs $0.1155 per call: 1,000 calls cost $115.50.

### What does a $10 budget buy with Change in LLM mentions between two dates for a target?

About 86 calls at $0.1155 per call.

### What inputs does Change in LLM mentions between two dates for a target need?

It has no required inputs.

### How do I call Change in LLM mentions between two dates for a target?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/ai-search/ai-visibility/x-ai-optimization-llm-mentions-timeseries-delta-live