Получить динамику изменений частоты запросов по ключевой фразе

Статья создана

Обновлена 19 января 2026 г.

Wordstat позволяет узнать, как изменяется частота запросов с ключевой фразой с помощью вызова GetDynamics.

Эта функциональность находится на стадии Preview.

Чтобы воспользоваться примером, создайте сервисный аккаунт с ролью search-api.webSearch.user и получите для него API-ключ с областью действия yc.search-api.execute. Также вы можете использовать IAM-токен как более безопасный способ. Подробнее об аутентификации в Yandex Search API.

gRPC API

Создайте файл с телом запроса (например, body.json):
```
  {
 "phrase": "<ключевая_фраза>",
 "period": "PERIOD_WEEKLY",
 "fromDate": "2025-01-01T00:00:00Z",
 "toDate": "2025-03-01T00:00:00Z",
 "regions": ["213"],
 "devices": ["DEVICE_DESKTOP"],
 "folderId": "<идентификатор_каталога>"
}
```
Где:
- phrase — ключевая фраза запроса, поддерживает поисковые операторы.
  
  Примечание
  
  Метод GetDynamics поддерживает все операторы при детализации по дням, при детализации по неделям и месяцам — только оператор +.
- period — период агрегации запросов по времени. Возможные значения:
  - PERIOD_MONTHLY: агрегация за месяц.
  - PERIOD_WEEKLY: агрегация за неделю.
  - PERIOD_DAILY: агрегация за день.
- fromDate — дата и время начала периода, за который запрашиваются данные, в виде строки в формате RFC3339.
- toDate — дата и время окончания периода, за который запрашиваются данные, в виде строки в формате RFC3339.
- regions — список идентификаторов регионов, откуда был задан запрос, например, 213 — Москва. По умолчанию учитываются запросы из любого региона.
- devices — список типов устройств, с которых был задан запрос. Возможные значения:
  - DEVICE_ALL: все устройства.
  - DEVICE_DESKTOP: компьютеры.
  - DEVICE_PHONE: телефоны.
  - DEVICE_TABLET: планшеты.
- folderId — идентификатор каталога вашего сервисного аккаунта.

Выполните gRPC-вызов, указав полученный ранее API-ключ или IAM-токен и путь к файлу с телом запроса:

Аутентификация с IAM-токеном:

grpcurl \
  -rpc-header "Authorization: Bearer <IAM-токен>" \
  -d @ < body.json \
  searchapi.api.yandexcloud.kz:443 yandex.cloud.searchapi.v2.WordstatService/GetDynamics \
  > result.json

Аутентификация с API-ключом:

grpcurl \
  -rpc-header "Authorization: Api-Key <API-ключ>" \
  -d @ < body.json \
  searchapi.api.yandexcloud.kz:443 yandex.cloud.searchapi.v2.WordstatService/GetDynamics \
  > result.json

Результат будет сохранен в файл result.json.

Фрагмент ответа

{
  "results": [
     { "date": "2025-01-05T00:00:00Z", "count": "150", "share": 0.000012 },
     { "date": "2025-01-12T00:00:00Z", "count": "180", "share": 0.000014 }
   ]
}

Получить динамику изменений частоты запросов по ключевой фразе

Была ли статья полезна?