ВойтиРегистрация
▤ Руководства

Частотность запросов (Wordstat)

Содержание

Источник — Wordstat через Yandex Cloud Search API v2 (REST): https://searchapi.api.cloud.yandex.net/v2/wordstat/…, заголовок Authorization: Api-Key …, в теле — folderId.

Подключение (/wordstat)

Идентификатор каталога и API-ключ сервисного аккаунта с ролью search-api.webSearch.user. Секрет хранится зашифрованным (AES-256-GCM).

Что используется

  • topRequests — totalCount (частота фразы за 30 дней), results (похожие запросы), associations; регионы — номера геобазы Яндекса (те же, что для позиций).
  • dynamics — помесячная динамика за 12 завершённых месяцев (PERIOD_MONTHLY, конец периода — последний день месяца).
  • Числа приходят строками (int64) — приводятся к int.

Хранение

Для запросов сайта (из «Позиций») хранится частота по месяцу: таблица ws_freq, 24 месяца. Обновление — кнопка «Обновить частоты» на странице позиций: до 30 запросов за нажатие, уже обновлённые в этом месяце пропускаются; ошибка ключа останавливает обновление.

Ограничения

Операторы Wordstat (!, +, []) не поддерживаются API; формат проверен только на подставных ответах. Официальный лимит запросов в секунду не опубликован.