MoreSEOОб авторе

Wordstat API: официальный доступ, сторонние сервисы и ловушки частотности

Методы Вордстата в Yandex Search API, что стало с отчётами в API Директа, xmlstock, Arsenkin и Keys.so. Цены, квоты и ловушка широкой частотности.

Обновлено 15 ноября 2026
11 мин. чтения
Обложка: частотность по APIДва блока, соединённые кабелем: слева окно с фигурными скобками кода, справа столбики частотности

Получать частотность из Яндекс 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 по документации считает все запросы, где есть все слова фразы в любом порядке. Это широкая частотность.

Какие официальные способы есть у Яндекса

Рабочий официальный способ один: Wordstat в составе Yandex Search API. Отдельный API Вордстата на api.wordstat.yandex.net справка Яндекса называет перенесённым в Search API. Отчёты Wordstat в API Директа v4 не отвечают, а метод hasSearchVolume в API Директа v5 возвращает только «есть показы или нет», без чисел.
СпособЧто отдаётДоступСтатус на 15.11.2026
Wordstat в Yandex Search APIТоп запросов за 30 дней, динамику, регионы, дерево регионовСервисный аккаунт Yandex Cloud, роль search-api.webSearch.user, API-ключ или IAM-токенРаботает, платно, с ограничением по датам после 07.10.2026
Отдельный API Вордстата (api.wordstat.yandex.net)Те же четыре метода по OAuthOAuth-токенСправка: «все возможности теперь доступны» в Search API
Отчёты Wordstat в API Директа v4 (Live)Частотность за прошлый месяц и похожие фразыOAuth-токен Директа, баллы APIОшибка 509 на нашем вызове 15.11.2026
keywordsresearch.hasSearchVolume в API Директа v5YES или NO по каждому типу устройств, без цифрOAuth-токен ДиректаРаботает, до 10 000 фраз в запросе

Метод hasSearchVolume годится только для чистки от фраз без показов. Лимит по справке: 20 запросов за 60 секунд на рекламодателя.

Как подключить методы Wordstat в Yandex Search API

Нужны каталог в Yandex Cloud, сервисный аккаунт с ролью search-api.webSearch.user и API-ключ с областью действия yc.search-api.execute. Запросы идут синхронно методом POST, ключ передаётся в заголовке Authorization: Api-Key, вместо него можно использовать IAM-токен.

Порядок по документации AI Studio:

  1. Создайте или выберите каталог (folder) в Yandex Cloud и запомните его идентификатор.
  2. Создайте сервисный аккаунт и выдайте ему роль search-api.webSearch.user.
  3. Создайте для аккаунта API-ключ с областью yc.search-api.execute. Ключ, созданный в AI Studio, уже имеет нужные права.
  4. Отправляйте 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: он не тарифицируется. Не храните ключ в репозитории и в общих таблицах: по нему с вашего счёта списываются деньги.

Сколько стоит и какие квоты

По тарифам AI Studio GetTop и GetDynamics стоят 20 ₽ за 1000 запросов, GetRegionsDistribution 50 ₽, GetRegionsTree бесплатно. Единица тарификации это один запрос, ошибки сервера и авторизации не оплачиваются. Квоты: 10 запросов в секунду и 100 в час, увеличиваются через поддержку.

На одну фразу с точной частотностью уходит один запрос GetTop, поэтому деньги здесь почти не важны: 1000 фраз стоят 20 ₽. Узкое место это квота. При 100 запросах в час 1000 фраз собираются 10 часов, а ядро на 10 000 фраз больше четырёх суток. Если вы планируете регулярные замеры, заявку на увеличение квоты в поддержку Yandex Cloud стоит отправить до старта, а не после первой остановки скрипта.

Ограничение, о котором нужно знать до интеграции. На странице с описанием Wordstat в Search API прямо написано, что статистика за даты после 7 октября 2026 года в API недоступна. На 15.11.2026 предупреждение на месте, сроков снятия Яндекс не называет. Что это значит на практике:

  • динамику за последние недели через GetDynamics так не получить;
  • свежие цифры GetTop и GetRegionsDistribution сверяйте выборочно с веб-версией Вордстата, прежде чем строить на них отчёты;
  • в документации и отчётах отмечайте, за какой период реально получены данные.

Что стало с отчётами Wordstat в API Директа

Годами самым популярным способом были отчёты Wordstat в API Директа v4 Live: бесплатно, за баллы API. Справка по методу CreateNewWordstatReport до сих пор не содержит пометки об отключении, но с 2 ноября 2026 года метод на наших вызовах отвечает ошибкой 509 «Метод недоступен в данной версии API». Повторная проверка 15.11.2026 дала тот же ответ.

Схема была такой: CreateNewWordstatReport создаёт отчёт по списку фраз, GetWordstatReportList проверяет готовность, GetWordstatReport отдаёт результат, DeleteWordstatReport удаляет отчёт. По справке: не больше 10 фраз в отчёте, статистика по 1000 фраз в сутки на пользователя, на сервере хранятся не больше пяти отчётов, через пять часов они удаляются.

Если у вас в проекте остались скрипты на этом методе, они не упадут с явной ошибкой сети: API ответит корректным JSON с кодом 509. Проверьте, что ваш код такой ответ ловит, а не записывает пустую частотность как ноль.

Какие сторонние сервисы отдают частотность по API

Три сервиса, которыми мы пользуемся сами: xmlstock (от 19 ₽ за 1000 запросов к Вордстату), Arsenkin Tools (API на тарифах «Стандарт» и «Корпоративный», оплата лимитами) и Keys.so (частотности из базы сервиса вместе с позициями сайтов). Все они удобнее официального 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 раз. Подробный разбор с таблицей долей по диапазонам частоты есть в статье про Вордстат.

Конвейер сбора частотности через APIПять шагов: список фраз, операторы в каждой фразе, выбор источника, сверка выборки с веб-версией Вордстата, сумма точных частот по группам. Под шагами указаны типичные ошибки. Сбор частотности через API без раздутых цифр 1. Фразы чистка интента до сбора 2. Операторы "!слово !слово" в каждой фразе 3. Источник Search API или сервис, регион, квота 4. Сверка 5–10 фраз вручную в Вордстате 5. Спрос сумма точных частот по группе Где теряется точность чужой интент с большой частотой без кавычек totalCount = широкая регион не учтён, ошибка записана как 0 данные после 07.10.2026 в Search API сумма широких частот: раздув в десятки раз Широкую и точную частотность храните в разных колонках
Конвейер сбора частотности через API: фразы, операторы, выбор источника, сверка выборки с веб-версией, сумма точных частот по группам

Схема 1. Где в автоматическом сборе чаще всего теряется точность и что проверять на каждом шаге.

Правила, которые мы закладываем в каждый скрипт:

  1. Операторы в самой фразе. Для точной частотности передавайте "!слово !слово". Для Arsenkin достаточно выбрать тип quoted или overal.
  2. Своё поле для каждого типа. Храните широкую и точную частотность в разных колонках, никогда не в одной.
  3. Сверка выборки. Перед массовым запуском проверьте 5–10 фраз вручную в веб-версии с теми же операторами и регионом.
  4. Дедупликация словоформ. Кавычки склеивают словоформы, поэтому «детская песня» и «детские песни» дадут одну цифру. Считайте её один раз.
  5. Чистка интента до суммы. Нецелевые фразы с большой частотой искажают спрос сильнее любой технической ошибки. Как группировать фразы, описано в статье про кластеризацию семантического ядра.

Наши данные: сколько стоит и сколько длится сбор

Методика. Расчёт для точной частотности (один запрос на фразу, один регион) по ценам и квотам из документации на 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, тип quoted1 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 не нужен

Если вы проверяете десятки фраз в месяц, хватит веб-версии Вордстата и ручного сбора, например расширением. 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.

Источники

Частный SEO-специалист. Пишу про поиск и нейропоиск, а цифры беру из Wordstat и первоисточников.

Читайте также

© MoreSEO, Алексей Демкин · все статьи