dynamics
Retrieve how search volume for a phrase changes over time, with monthly, weekly, or daily aggregation and optional device and region filters for Yandex Wordstat trend analysis.
Instructions
How search volume for a phrase changes over time. share_percent is the phrase's
share of all Yandex queries in that period. Dates are snapped automatically:
weeks to Monday–Sunday, months to the 1st and the last day.
Data lags by about a month; daily data covers only the last 60 days.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"phrase": "<phrase>"
},
"name": "dynamics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| period | No | Aggregation step. | monthly |
| phrase | Yes | Search phrase, Wordstat operators allowed. | |
| devices | No | Device filter. Omit for all devices. | |
| regions | No | Region IDs or exact names, e.g. ["213"] or ["Москва"]. Omit for all regions. | |
| to_date | No | End date (YYYY-MM-DD). Default: latest available. | |
| from_date | No | Start date (YYYY-MM-DD). Default: ~12 months back for monthly, ~12 weeks for weekly, 55 days for daily. Daily data is only available for the last 60 days. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |