Что это
Wordstat API помогает узнать, как люди ищут тему в Яндексе: получить популярные формулировки, похожие запросы, динамику и распределение по регионам. Результаты можно сохранять в таблицу и повторять сбор для выбранного региона.
Сейчас официальный маршрут к этим данным проходит через Yandex Search API в Yandex Cloud. Примеры старого подключения Wordstat нельзя переносить без проверки: здесь нужны каталог облака, сервисный аккаунт и подходящие права.
API не составляет SEO-стратегию и не пишет статьи. Он дает исходную статистику; группировку запросов, проверку намерения и сравнение с вашим контентом выполняете вы или отдельный процесс. Число запросов не равно числу людей и не обещает столько же посетителей сайта.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Есть отдельные методы для запросов, динамики и регионального распределения.
- Регион и устройство задаются явно, поэтому сбор можно повторить с одинаковыми условиями.
- Ответ содержит исходные формулировки и счетчики для последующей обработки.
- Дерево регионов помогает выбрать правильный код, а не угадывать его по названию.
Ограничения
- Нужны платежный аккаунт, каталог облака и права сервисного аккаунта.
- Популярные запросы и региональное распределение относятся к последним 30 дням, а не произвольному периоду.
- Методы работают синхронно и ограничены квотами сервиса.
- Пересечение фраз и широкое соответствие искажают оценку, если считать выдачу уникальной аудиторией.
Как использовать
1. Подготовка. Создайте каталог в Yandex Cloud с активным платежным аккаунтом. Возьмите одну тему, например «ии агент», и один регион. В справочнике код 213 соответствует Москве; для всей России выберите соответствующий код из дерева регионов.
2. Настройка. Создайте сервисный аккаунт с ролью search-api.webSearch.user и API-ключом со scope yc.search-api.execute. Храните ключ на сервере. Используйте Authorization: Api-key <ключ> и Content-Type: application/json; сохраните folderId своего каталога.
3. Первый результат. Выполните POST https://searchapi.api.cloud.yandex.net/v2/wordstat/topRequests с JSON: {"phrase":"ии агент","numPhrases":"10","regions":["213"],"devices":["DEVICE_ALL"],"folderId":"<folderId>"}. Из results возьмите phrase и count, сохраните десять формулировок и условия сбора. associations содержит отдельные связанные запросы.
4. Проверка. Сравните несколько формулировок с веб-Wordstat для того же региона и устройства; учитывайте дату обновления данных. Не сортируйте счетчики как строки и не суммируйте пересекающиеся фразы. 401/403, превышение квоты и пустой результат требуют разной обработки. Перед регулярным запуском проверьте стоимость метода и лимиты.
Примеры сценариев
- Найти запросы, которые еще не закрыты статьями.
- Сравнить сезонный спрос перед публикацией.
- Собрать черновик семантики с сохраненными параметрами.
Доступ и оплата
- Модель оплаты: Оплата по использованию
- Бесплатный тариф: Нет
- Работа в РФ: Да
- VPN: Не нужен
- Русский интерфейс: Да
- Русский язык: Не известно
Запросы Wordstat оплачиваются по тарифам Yandex Search API. GetTop, GetDynamics и распределение по регионам имеют свои условия; получение дерева регионов бесплатно. Бесплатный веб-интерфейс Wordstat не означает бесплатный API. Валюту и стоимость смотрите для своего платежного аккаунта.
Когда не подходит
- Прогнозировать посещаемость по одной частотности
- Складывать все пересекающиеся запросы в размер аудитории
- Получать позиции и клики своего сайта вместо Вебмастера
Альтернативы
Google Ads Keyword Planner API показывает спрос Google при доступе к рекламной платформе. DataForSEO API объединяет несколько источников SEO-данных на своих условиях. Yandex Webmaster API дает статистику вашего сайта, но не заменяет исследование общего спроса Wordstat.
