Семантическое ядро через Wordstat API: от seed до чистой таблицы ключей

Семантическое ядро через Wordstat API собирается по одной схеме: seed-фраза уходит в метод topRequests, из ответа берутся новые фразы как следующий уровень запроса, и так по кругу 3-5 раз, пока не наберется нужный объем. Дальше все фильтруется и выгружается в таблицу. Разберем весь путь по шагам, с кодом и реальными цифрами.

Пайплайн строится вокруг одного метода /v1/topRequests. Скрипт на Python прогоняет список seed-фраз, собирает 500-2000 уникальных запросов за 15-20 минут и складывает результат в Google Sheets через gspread. Дальше в статье: доступ к API, лимиты, фильтрация стоп-слов и готовый промпт для нейросети.

Что вообще дает Wordstat API для сбора семантики?

Wordstat API дает программный доступ к статистике поисковых запросов Яндекса без открытия браузера. Один запрос возвращает до 300 связанных фраз с частотностью за последние 30 дней.

Официальная документация Яндекса описывает четыре метода API: getRegionsTree, topRequests, dynamics и regions. Основной для сбора ядра, конечно, topRequests: он принимает фразу и возвращает массив похожих запросов с числом показов.

Раньше для такого объема данных приходилось сидеть в браузерной версии Wordstat и копировать таблицы вручную. Лиза из VibeCoderz так делала для одной ниши: 90 листов Excel, полтора миллиона ключей, собранных через похожий пайплайн на автоматизации Wordstat.

Лиза: «Он реально собирает реальную частотность, находит запросы, до которых я бы вручную никогда не додумалась. На 30 минут можно отойти, он собирает сам».

Именно эта разница и решает: ручной сбор занимает дни, автоматизация через API закрывает нишу за один вечер.

Как получить доступ к Wordstat API?

Доступ бесплатный, но требует заявки. Регистрируешь приложение в Яндекс ID, получаешь ClientId и токен, потом ждешь одобрения от поддержки Яндекс.Директа.

Заявку одобряют обычно в течение суток, иногда за пару часов. Базовая квота: 10 запросов в секунду и 1000 запросов в сутки. Для увеличения лимита нужно написать в поддержку с обоснованием объема задач, согласно официальной документации Wordstat.

Шаги по порядку:

1. Создать приложение в Яндекс ID, выбрав доступ к данным Wordstat.
2. Получить Client ID, Secret и Redirect URL.
3. Пройти авторизацию по ссылке, забрать код из адресной строки и обменять на токен.
4. Подать заявку на использование API, указав, что аккаунт привязан к Яндекс.Директу.

Без активной рекламной кампании в Директе заявку иногда отклоняют, это частая заминка у новичков. Проще всего создать одну минимальную кампанию с одной фразой и одним объявлением, только для галочки.

Из каких этапов состоит пайплайн от seed до таблицы?

Полный пайплайн: seed-фразы → topRequests → рекурсивное углубление → дедупликация → фильтр стоп-слов → сортировка → выгрузка. На выходе чистая таблица без ручной работы.

Шесть шагов, каждый со своей задачей. Пропустишь дедупликацию, получишь таблицу с сотнями повторов и раздутой академической тошнотой в будущих статьях под эти ключи.

По похожему принципу устроен и открытый проект на Streamlit для рекурсивного парсинга Wordstat: он собирает до 2000 фраз за раз и углубляется до пяти уровней, исключая дубликаты по пути.

Как работает метод topRequests на практике?

Метод принимает phrase, регионы и тип устройства, возвращает массив phrase-count пар за последние 30 дней. Один запрос тратит одну единицу суточной квоты.

Запрос уходит POST-методом на api.wordstat.yandex.net/v1/topRequests с телом вида {"phrase": "cursor ide", "regions": [225]}. В ответе приходит массив topRequests, где каждая запись это phrase и count.

Разработчикам, которые пишут такие интеграции в Cursor или Claude Code, важно помнить: метод не различает "прямые совпадения" и "похожие запросы" отдельными полями, все приходит одним списком. Разделение на смысловые группы придется делать самостоятельно, уже после получения данных.

Для более широкого охвата (не только Яндекс, но и генеративный поиск) есть альтернативный маршрут: Wordstat доступен и в Yandex Cloud Search API v2 через тот же ключ, что у YandexGPT, без привязки к Директу вообще, как описывает разбор на Хабре.

Какие лимиты и как под них подстроить скрипт?

Базовая квота: 10 запросов в секунду, 1000 в сутки. При превышении API отдает 503 ошибку, поэтому в скрипте обязателен rate-limit.

Тысяча запросов в день звучит много, пока не начнешь рекурсивно углубляться на 5 уровней от 15 seed-фраз. Уже на втором уровне счет идет на сотни запросов.

Практический прием: ставить паузу 0.12 секунды между запросами и добавлять прогресс-бар через tqdm, чтобы видеть, сколько осталось до дневного лимита. Если квоты не хватает регулярно, в заявке на увеличение указывай точный объем: конкретная цифра одобряется охотнее общей фразы «нужно больше».

Как выглядит рабочий промпт для сборки такого скрипта?

Готовый промпт для Claude Code или Cursor: описывает весь пайплайн от CSV с seed-фразами до готовой таблицы в Google Sheets, включая rate-limit и дедупликацию.

Не обязательно писать код руками. Достаточно дать нейросети точное техзадание с шагами, форматом данных и ограничениями API.

Напиши полный pipeline сборки семантического ядра через Wordstat API.
Шаги:
1. Принять список seed-фраз из CSV.
2. Для каждой: запрос topRequests + сбор всех фраз из ответа.
3. Дедупликация по точной фразе.
4. Фильтрация: удалить фразы из STOP_WORDS = ["скачать", "смотреть",
   "бесплатно", ...].
5. Сортировка по count DESC.
6. Выгрузка: phrase | count | source_seed в Google Sheets через gspread.
Добавь progress bar (tqdm), rate-limit 0.12 сек между запросами.

Для такой задачи неплохо подходит Claude Code: он держит контекст всего пайплайна в одной сессии и сам добавляет обработку ошибок API, которую в промпте явно не просили.

Чем Wordstat API отличается от Key Collector?

Key Collector дает больше ручных настроек парсинга и глубину сбора без API-лимитов, но требует установки десктопной программы. API проще интегрировать в автоматизацию.

В Key Collector есть параметр "глубина парсинга": 0, 1 или 2, который определяет, насколько сервис уходит вглубь по связанным запросам. Плюс там же настраивается группировка по папкам и парсинг подсказок отдельным шагом.

API про другое: никакой десктопной установки, никакой привязки к конкретному компьютеру, зато лимит в 1000 запросов в сутки жестче любых настроек Key Collector. Для разового сбора семантики под один сайт хватает и десктопной программы. Для регулярной автоматизации, встроенной в контент-конвейер, API удобнее.

Сколько ключей реально можно собрать таким способом?

При 15 seed-фразах и рекурсии на 3-4 уровня получается 500-2000 уникальных фраз за один запуск, 15-20 минут работы скрипта.

Цифра растет с масштабом ниши. Для широких коммерческих тем счет идет на тысячи листов и миллионы запросов, если собирать не одну нишу, а весь рынок целиком.

Дальше эти фразы кластеризуются под структуру статей, распределяются по страницам каталога и агентам под нужную профессию, например агенту для маркетолога, если ниша про автоматизацию рекламы.

FAQ

Нужно ли платить за доступ к Wordstat API в 2026 году?
Базовый доступ бесплатный. Платить нужно только за расширенную квоту, если стандартных 1000 запросов в сутки не хватает под объем задач.

Сколько фраз можно собрать за один запуск скрипта?
От 500 до 2000 уникальных фраз за 15-20 минут при рекурсивном обходе на 3-5 уровней от одной seed-фразы.

Чем Wordstat API отличается от Key Collector?
API дает прямой программный доступ без установки десктопного софта, но с более жесткими лимитами запросов в сутки, чем у настроенного Key Collector с прокси.

Можно ли использовать Wordstat API без опыта в Python?
Да. Промпт из этой статьи можно отдать Claude Code или Cursor целиком, и нейросеть напишет скрипт сама, включая обработку ошибок API.

Что делать, если Яндекс не одобряет заявку на доступ?
Проверить, что аккаунт привязан к Яндекс.Директу с хотя бы одной активной кампанией, и указать в заявке конкретный объем запросов вместо общей формулировки.

Как часто нужно обновлять семантическое ядро?
Для устоявшихся ниш раз в квартал. Для быстрорастущих тем вроде AI-инструментов лучше раз в месяц, там частотность запросов меняется быстро.

Можно ли собирать частотность не только по России?
Метод принимает список regions, поэтому можно ограничить сбор конкретным городом или регионом или оставить пустым для всей аудитории Яндекса.

Глоссарий

• Seed-фраза — стартовый запрос, с которого начинается рекурсивный сбор семантики.
• topRequests — метод Wordstat API, возвращающий связанные запросы с частотностью за 30 дней.
• Дедупликация — удаление повторяющихся фраз из итогового списка.
• Академическая тошнота — показатель плотности повторов слов в тексте, используется при SEO-анализе статей.
• gspread — библиотека Python для работы с Google Sheets без открытия браузера.
• Rate-limit — искусственная задержка между запросами, чтобы не упереться в лимит API.

Что в итоге

Сборка семантического ядра через Wordstat API не требует ни Key Collector, ни ручного копирования из браузера. Один скрипт на Python, готовый промпт для нейросети и час свободного времени закрывают нишу на несколько тысяч ключей. Дальше эти ключи ложатся в статьи, а статьи в структуру каталога.

Если нужна помощь с настройкой такого пайплайна под конкретный проект, можно посмотреть каталог AI-инструментов для выбора среды разработки или записаться на консультацию к Максиму.

Обновлено: март 2026.