Получать частотность из Яндекс Wordstat программно на 15.11.2026 можно двумя путями. Официальный: методы Wordstat в Yandex Search API (платформа Yandex AI Studio), с оплатой за запросы и квотой 100 запросов в час. Сторонний: сервисы вроде xmlstock, Arsenkin Tools и Keys.so, которые отдают частотность по своему API. Старый бесплатный способ через отчёты Wordstat в API Директа версии 4 больше не работает: на наш вызов 15.11.2026 метод вернул ошибку 509 «Метод недоступен в данной версии API».
Какой бы путь вы ни выбрали, главная ошибка одна и та же: без операторов любой API возвращает широкую частотность, а её нельзя складывать. Ниже разбираем все способы, цены, квоты, пример запроса и то, как не получить спрос, раздутый в десятки раз.
Коротко
- Методы Wordstat в Yandex Search API: GetTop, GetDynamics, GetRegionsDistribution и бесплатный GetRegionsTree. Цена 20 ₽ за 1000 запросов для первых двух и 50 ₽ для распределения по регионам, с НДС.
- Квоты Search API для Wordstat: 10 запросов в секунду и 100 запросов в час. Их можно поднять через поддержку Yandex Cloud.
- В документации Search API на 15.11.2026 висит предупреждение: статистика за даты после 7 октября 2026 года в API недоступна.
- Метод CreateNewWordstatReport в API Директа v4 описан в справке без пометки об отключении, но с 2 ноября 2026 года на наших вызовах отвечает ошибкой 509.
- Поле
totalCountв GetTop по документации считает все запросы, где есть все слова фразы в любом порядке. Это широкая частотность.
Какие официальные способы есть у Яндекса
| Способ | Что отдаёт | Доступ | Статус на 15.11.2026 |
|---|---|---|---|
| Wordstat в Yandex Search API | Топ запросов за 30 дней, динамику, регионы, дерево регионов | Сервисный аккаунт Yandex Cloud, роль search-api.webSearch.user, API-ключ или IAM-токен | Работает, платно, с ограничением по датам после 07.10.2026 |
| Отдельный API Вордстата (api.wordstat.yandex.net) | Те же четыре метода по OAuth | OAuth-токен | Справка: «все возможности теперь доступны» в Search API |
| Отчёты Wordstat в API Директа v4 (Live) | Частотность за прошлый месяц и похожие фразы | OAuth-токен Директа, баллы API | Ошибка 509 на нашем вызове 15.11.2026 |
| keywordsresearch.hasSearchVolume в API Директа v5 | YES или NO по каждому типу устройств, без цифр | OAuth-токен Директа | Работает, до 10 000 фраз в запросе |
Метод hasSearchVolume годится только для чистки от фраз без показов. Лимит по справке: 20 запросов за 60 секунд на рекламодателя.
Как подключить методы Wordstat в Yandex Search API
search-api.webSearch.user и API-ключ с областью действия yc.search-api.execute. Запросы идут синхронно методом POST, ключ передаётся в заголовке Authorization: Api-Key, вместо него можно использовать IAM-токен.Порядок по документации AI Studio:
- Создайте или выберите каталог (folder) в Yandex Cloud и запомните его идентификатор.
- Создайте сервисный аккаунт и выдайте ему роль
search-api.webSearch.user. - Создайте для аккаунта API-ключ с областью
yc.search-api.execute. Ключ, созданный в AI Studio, уже имеет нужные права. - Отправляйте POST-запросы на
https://searchapi.api.cloud.yandex.net/v2/wordstat/topRequests(для GetTop) и соседние адреса для других методов.
Параметры GetTop по справочнику API: phrase до 400 символов, numPhrases от 1 до 2000 (по умолчанию 50), regions до 100 кодов, devices из значений DEVICE_ALL, DEVICE_DESKTOP, DEVICE_PHONE, DEVICE_TABLET, folderId. В ответе totalCount, список results и список похожих запросов associations (технический лимит: не больше 20).
Минимальный пример на Python. Ключ и каталог берутся из переменных окружения, в коде их нет:
import os
import requests
resp = requests.post(
"https://searchapi.api.cloud.yandex.net/v2/wordstat/topRequests",
headers={"Authorization": f"Api-Key {os.environ['YC_API_KEY']}"},
json={
"phrase": '"!купить !диван"', # операторы обязательны для точной частотности
"numPhrases": "50",
"devices": ["DEVICE_ALL"],
"folderId": os.environ["YC_FOLDER_ID"],
},
timeout=30,
)
resp.raise_for_status()
print(resp.json()["totalCount"])
Коды регионов для поля regions берите из метода GetRegionsTree: он не тарифицируется. Не храните ключ в репозитории и в общих таблицах: по нему с вашего счёта списываются деньги.
Сколько стоит и какие квоты
На одну фразу с точной частотностью уходит один запрос GetTop, поэтому деньги здесь почти не важны: 1000 фраз стоят 20 ₽. Узкое место это квота. При 100 запросах в час 1000 фраз собираются 10 часов, а ядро на 10 000 фраз больше четырёх суток. Если вы планируете регулярные замеры, заявку на увеличение квоты в поддержку Yandex Cloud стоит отправить до старта, а не после первой остановки скрипта.
Ограничение, о котором нужно знать до интеграции. На странице с описанием Wordstat в Search API прямо написано, что статистика за даты после 7 октября 2026 года в API недоступна. На 15.11.2026 предупреждение на месте, сроков снятия Яндекс не называет. Что это значит на практике:
- динамику за последние недели через GetDynamics так не получить;
- свежие цифры GetTop и GetRegionsDistribution сверяйте выборочно с веб-версией Вордстата, прежде чем строить на них отчёты;
- в документации и отчётах отмечайте, за какой период реально получены данные.
Что стало с отчётами Wordstat в API Директа
Схема была такой: CreateNewWordstatReport создаёт отчёт по списку фраз, GetWordstatReportList проверяет готовность, GetWordstatReport отдаёт результат, DeleteWordstatReport удаляет отчёт. По справке: не больше 10 фраз в отчёте, статистика по 1000 фраз в сутки на пользователя, на сервере хранятся не больше пяти отчётов, через пять часов они удаляются.
Если у вас в проекте остались скрипты на этом методе, они не упадут с явной ошибкой сети: API ответит корректным JSON с кодом 509. Проверьте, что ваш код такой ответ ловит, а не записывает пустую частотность как ноль.
Какие сторонние сервисы отдают частотность по API
| Что | Когда подходит | Чем платите | Почему важно |
|---|---|---|---|
| Yandex Search API (методы Wordstat) | Нужен первоисточник и договор с Яндексом, регулярные отчёты небольшого объёма | 20–50 ₽ за 1000 запросов, квотой 100 запросов в час, ограничением по датам после 07.10.2026 | Официальные данные, регионы и устройства |
| xmlstock | Массовый съём частотности по России, тысячи фраз за час | От 19 ₽ за 1000 запросов; регион в нашей проверке не учитывался | Самый быстрый путь к точной частотности на больших ядрах |
| Arsenkin Tools | Семантика под регион: базовая, в кавычках, с «!» и с порядком слов в одной задаче | Подпиской на тариф с API и лимитами; до 5 задач одновременно, 30 запросов в минуту | Четыре типа частотности и до 4 регионов без ручных операторов |
| Keys.so | Нужны частотности вместе с конкурентами и позициями, в том числе Google | Подпиской; 10 запросов за 10 секунд; данные из базы сервиса | Поля ws и wsk в выгрузках, без отдельного съёма |
Подробности, которые не всегда есть в документации:
- xmlstock. Ручка Wordstat в ответе возвращает
totalCountи список фраз. Если передать фразу в кавычках внутри параметраquery,totalCountдаёт частотность в кавычках. Наши проверки показали две особенности: параметр регионаlrэта ручка не учитывает (одинаковый ответ для Москвы, России и других регионов, проверка 11.09.2026), а у 0,5–2% фраз в кавычках полеtotalCountв ответе отсутствует. Мы досчитываем такие фразы запросом с квадратными скобками, а остаток помечаем как оценку. - Arsenkin Tools. Задачи асинхронные: отправка, проверка статуса, получение результата. Тип частотности задаётся полем
ws:base,quoted,overal(с «!»),exact(с «!» и порядком слов). В нашем тесте в августе 2026 года одна фраза с одним типом частотности в одном регионе стоила 1 лимит. - Keys.so. Частотность берётся из базы сервиса, привязанной к региону базы (
msk,spbи другие). Как работать с сервисом целиком, разобрано в статье про Keys.so.
Почему API легко раздувает спрос в десятки раз
Через API ошибка масштабируется: в веб-версии вы видите каждую цифру, а скрипт молча сложит тысячи широких значений. На музыкальной семантике у нас сумма широких частот дала 243 млн показов в месяц, а сумма точных 3,45 млн, разница в 70 раз. Подробный разбор с таблицей долей по диапазонам частоты есть в статье про Вордстат.
Схема 1. Где в автоматическом сборе чаще всего теряется точность и что проверять на каждом шаге.
Правила, которые мы закладываем в каждый скрипт:
- Операторы в самой фразе. Для точной частотности передавайте
"!слово !слово". Для Arsenkin достаточно выбрать типquotedилиoveral. - Своё поле для каждого типа. Храните широкую и точную частотность в разных колонках, никогда не в одной.
- Сверка выборки. Перед массовым запуском проверьте 5–10 фраз вручную в веб-версии с теми же операторами и регионом.
- Дедупликация словоформ. Кавычки склеивают словоформы, поэтому «детская песня» и «детские песни» дадут одну цифру. Считайте её один раз.
- Чистка интента до суммы. Нецелевые фразы с большой частотой искажают спрос сильнее любой технической ошибки. Как группировать фразы, описано в статье про кластеризацию семантического ядра.
Наши данные: сколько стоит и сколько длится сбор
Методика. Расчёт для точной частотности (один запрос на фразу, один регион) по ценам и квотам из документации на 15.11.2026. Строка xmlstock посчитана по нашему фактическому прогону: 61 430 фраз игровой семантики, 65 452 запроса с учётом досчётов, около 72 минут в 8 потоков, расход около 1 332 ₽. Спрос по теме статьи из Wordstat, Россия, 30 дней, срез 14.11.2026.
| Способ | 1 000 фраз: деньги | 1 000 фраз: время | 10 000 фраз: деньги | 10 000 фраз: время |
|---|---|---|---|---|
| Search API, GetTop, квота по умолчанию | 20 ₽ | 10 часов | 200 ₽ | 100 часов |
| xmlstock (наш прогон) | около 22 ₽ | около 1–2 минут | около 217 ₽ | около 12 минут |
| Arsenkin Tools, тип quoted | 1 000 лимитов | зависит от очереди задач | 10 000 лимитов | зависит от очереди задач |
| API Директа v4 | не работает: ошибка 509 на 15.11.2026 (до отключения: бесплатно, до 1 000 фраз в сутки) | |||
Что из этого следует:
- В официальном API дорого время, а не деньги. Разница между 20 ₽ и 22 ₽ за 1000 фраз несущественна, а между 10 часами и двумя минутами существенна. Для разового ядра на тысячи фраз сторонний сервис быстрее, для регулярного отчёта на сотню фраз хватит Search API.
- Регион стоит денег. Каждый регион в Search API и Arsenkin это отдельный запрос или лимит, а xmlstock регион в наших проверках не учитывал вовсе. Если нужна частотность по 10 городам, умножайте бюджет на 10 и выбирайте сервис, который регион действительно учитывает.
- Сама тема небольшая. По главному запросу этой темы в нашей семантике широкая частотность 404, точная 183, это 45,3%. Высокая доля точной формы значит, что люди ищут именно техническое решение, а не общие слова про Вордстат.
Кому API не нужен
- Небольшой сайт с одним ядром. Соберите фразы в веб-версии, выгрузите CSV кнопкой «Скачать» или используйте расширение для Вордстата.
- Нет разработчика. Сервисы сбора семантики с интерфейсом дадут тот же результат без кода. Обзор есть в статье аналоги Wordstat.
- Ядро уже собрано. Если задача только сгруппировать готовый список, частотность второй раз снимать не нужно. Как собрать ядро целиком, описано в статье семантическое ядро сайта: как собрать по шагам.
Частые вопросы
Есть ли у Вордстата официальный API?
Да. Методы Wordstat входят в Yandex Search API на платформе Yandex AI Studio: GetTop, GetDynamics, GetRegionsDistribution и GetRegionsTree. Нужен сервисный аккаунт с ролью search-api.webSearch.user и API-ключ.
Сколько стоит доступ к данным Вордстата через API?
В Search API GetTop и GetDynamics стоят 20 ₽ за 1000 запросов, GetRegionsDistribution 50 ₽, GetRegionsTree бесплатно, цены с НДС. Квота по умолчанию 100 запросов в час, увеличивается через поддержку Yandex Cloud.
Работает ли Wordstat через API Директа?
Метод CreateNewWordstatReport в API Директа v4 на 15.11.2026 отвечает ошибкой 509 «Метод недоступен в данной версии API», хотя в справке пометки об отключении нет. В API Директа v5 есть только hasSearchVolume, который показывает наличие показов без цифр.
Как получить через API точную частотность?
Передавайте фразу с операторами, например "!купить !диван". Без операторов поле totalCount в GetTop считает все запросы с этими словами в любом порядке, то есть широкую частотность. В сторонних сервисах выбирайте тип частотности в кавычках.
Можно ли парсить Вордстат без API?
Технически да, но такой сбор может упираться в капчу и ломается при каждом обновлении интерфейса. Для массового сбора надёжнее официальный Search API или сервисы с собственным API.
Источники
- Yandex Search API: сервис Wordstat, методы и ограничение по датам
- Yandex Search API: получение топа запросов по ключевой фразе, авторизация и операторы
- Справочник REST: метод GetTop, параметры и поля ответа
- Yandex Search API: правила тарификации
- Yandex Search API: квоты и лимиты
- Справка Wordstat: API Вордстата перенесён в Yandex Search API
- API Директа v4: метод CreateNewWordstatReport
- API Директа v5: метод keywordsresearch.hasSearchVolume
- xmlstock: сервисы и цены, включая API Вордстата
- Arsenkin Tools: общие правила API, тарифы и лимиты запросов
- Arsenkin Tools: API частотности Вордстата и типы частотности
- Keys.so: документация API, авторизация и коды баз