Получить доступ к Wordstat API можно двумя способами: через старый прямой API Яндекса (нужен аккаунт Директа с рекламной кампанией) или через Yandex Cloud AI Studio, где вордстат оформлен как часть Search API v2. Второй вариант проще и не требует рекламного кабинета. Ниже разберем оба пути пошагово: что нужно для регистрации, какие лимиты действуют и какой вариант выбрать под вашу задачу.
Прямой Wordstat API работает через OAuth-токен и требует заявку с подтвержденным аккаунтом Яндекс Директа. Yandex Cloud AI Studio выдает API-ключ сразу после привязки платежного аккаунта, без рекламного кабинета. Формально это два разных сервиса Яндекса с разными правилами доступа, но одинаковыми данными на выходе.
Зачем вообще два способа доступа к Wordstat API?
Яндекс держит два параллельных сервиса: старый Wordstat API через Директ и новый Search API v2 в облаке. Они не связаны между собой и требуют разной регистрации.
Wordstat API v1 (домен api.wordstat.yandex.net) существует давно и завязан на рекламный кабинет. Search API v2 в Yandex Cloud AI Studio запустился как часть общей платформы для LLM и поиска, вордстат туда добавили отдельным методом. Для получения данных о частотности оба варианта подходят одинаково хорошо.
Разница в пороге входа. Старый способ требует действующую кампанию в Директе, что многим кажется лишним шагом ради одной функции. Новый способ создавался под разработчиков, которым нужен API-ключ, а не рекламный кабинет. По факту это два совершенно разных цикла регистрации.
Мы в VibeCoderz разбираем оба пути ниже. Дальше сравним конкретные шаги, лимиты и то, кому какой вариант подходит.
Как получить доступ к прямому Wordstat API через Direct?
Прямой Wordstat API требует OAuth-токен, зарегистрированный ClientId и одобренную заявку от службы поддержки Яндекс Директа. Отправить заявку можно только с аккаунта, где есть хотя бы одна рекламная кампания.
Яндекс регистрирует заявки на прямой Wordstat API только с аккаунтов Директа с реальной, пусть и минимальной, рекламной активностью. По официальной документации нужно создать приложение на oauth.yandex.ru, выбрать доступ хотя бы к одному типу данных и получить ClientId. Затем этот идентификатор передается в поддержку Директа вместе с логином аккаунта.
Если на аккаунте нет ни одной кампании, придется создать черновик: одна фраза, одно объявление, на модерацию отправлять не обязательно. Только после этого заявку на доступ к API рассматривают. Ожидание одобрения занимает от нескольких дней до пары недель, конкретные сроки Яндекс не публикует.
После одобрения токен передается в заголовке Authorization: Bearer <OAuth-токен> на каждый запрос к https://api.wordstat.yandex.net. Метод /v1/topRequests отдает частотность и похожие запросы за последние 30 дней, а /v1/userInfo показывает остаток дневной квоты.
Какие лимиты у прямого Wordstat API?
По умолчанию действует квота 1000 запросов в сутки и ограничение по скорости в 10 запросов в секунду. Увеличить лимит можно заявкой в поддержку с обоснованием объема.
Квота персональная, привязана к конкретному OAuth-токену. Метод /v1/userInfo возвращает и лимит, и уже потраченный остаток за текущие сутки, так что план запросов удобно строить заранее.
Если 1000 запросов в день не хватает, есть возможность подать отдельное обращение с описанием задачи и требуемым объемом. Яндекс рассматривает такие заявки индивидуально, гарантированного увеличения нет. Для небольших SEO-проектов дефолтной квоты обычно достаточно, для программатик-контента на тысячи ниш придется договариваться отдельно или уходить на второй способ.
Как подключить Wordstat через Yandex Cloud AI Studio?
Нужен активный платежный аккаунт Yandex Cloud, сервисный аккаунт с ролью search-api.webSearch.user и API-ключ с областью yc.search-api.execute. Без активного биллинга ключ создать нельзя даже для бесплатного лимита.
С 2026 года Yandex Cloud требует привязанную карту еще до выдачи API-ключа, это подтверждают и наши тесты, и свежие разборы на Хабре. Регистрация выглядит так: сначала создается платежный аккаунт и привязывается карта, затем система ждет, пока статус аккаунта станет активным. Обычно это занимает от нескольких минут до пары часов.
Дальше в консоли Yandex Cloud открывается раздел AI Studio, там создается API-ключ. Вместе с ключом автоматически появляется сервисный аккаунт, которому нужно назначить роль search-api.webSearch.user через Identity and Access Management. Область действия ключа должна включать yc.search-api.execute, иначе запросы к вордстату будут отклоняться с ошибкой прав.
Последний обязательный элемент, folder_id, находится в адресной строке консоли после /folders/ и обычно начинается с b1. Он передается в теле каждого запроса на https://searchapi.api.cloud.yandex.net/v2/wordstat/topRequests вместе с заголовком Authorization: Api-Key <ключ>.
Лиза: «Для одной ниши собрала 90 листов Excel, полтора миллиона ключей. Он реально собирает реальную частотность, находит запросы, до которых я бы вручную никогда не додумалась. На 30 минут можно отойти, собирает сам».
Сколько стоит Wordstat через Yandex Cloud AI Studio?
Тарификация идет за 1000 запросов, порядок цены на 2026 год: 50-200 рублей за тысячу, точную цифру нужно смотреть в консоли. Бесплатный тестовый лимит обычно около 10 000 запросов в месяц.
Точная цена зависит от тарифного плана и региона аккаунта, поэтому ориентир мы даем по нижней и верхней границе. Для сравнения: при 500 запросах в день на программатик-контент выходит условно 750-3000 рублей в месяц, что заметно дешевле найма человека на ручной сбор семантики.
Бесплатный лимит подходит для тестирования интеграции и для небольших проектов на 10-20 ниш. Как только объем растет, полезно сразу считать unit-экономику на один материал, чтобы не сливать бюджет в холостую, как это уже случалось у команды VibeCoderz на других API.
Direct API или Yandex Cloud AI Studio: что выбрать?
Для разработки и небольших объемов выгоднее AI Studio: проще регистрация, нет привязки к рекламному кабинету. Для интеграций внутри существующей инфраструктуры Директа логичнее остаться на прямом API.
Если у вас уже есть рабочий аккаунт Директа с активными кампаниями, получить прямой доступ к Wordstat API будет быстрее: заявка через поддержку, токен, готово. Строить отдельный биллинг в облаке ради этого не имеет смысла.
Если рекламного кабинета нет и заводить его специально не хочется, путь через AI Studio выигрывает по времени и по порогу входа. Плюс тот же API-ключ подходит для YandexGPT и других моделей внутри AI Studio, если вы уже используете нейросети для контента.
| Критерий | Wordstat API (Direct) | Yandex Cloud AI Studio |
|---|---|---|
| Что нужно | Аккаунт Директа с кампанией | Платежный аккаунт Yandex Cloud |
| Тип доступа | OAuth-токен | API-ключ + folder_id |
| Роль/область | Одобрение поддержкой | search-api.webSearch.user, yc.search-api.execute |
| Лимит по умолчанию | 1000 запросов/сутки | Около 10 000 запросов/месяц бесплатно |
| Оплата сверх лимита | Заявка на увеличение квоты | 50-200 руб. за 1000 запросов |
| Срок получения | Дни-недели (модерация) | Минуты-часы после активации биллинга |
Как работать с Wordstat API через MCP-коннектор?
Ключ и folder_id из Yandex Cloud AI Studio подставляются в конфиг MCP-сервера, дальше вордстат доступен как инструмент прямо в Cursor, Claude Code или другом AI IDE.
Для вайбкодеров, которые уже работают в Cursor или Claude Code, есть готовые MCP-серверы под Yandex Wordstat, куда просто вставляются YANDEX_SEARCH_API_KEY и YANDEX_FOLDER_ID. Это избавляет от написания собственного враппера под REST API.
Один нюанс, который легко пропустить: ключ Yandex показывает один раз, при закрытии диалога без копирования придется пересоздавать заново. Второй нюанс -> без активного платежного аккаунта конфиг MCP просто не заработает, даже если ключ и folder_id указаны верно.
Часто задаваемые вопросы про доступ к Wordstat API
Можно ли получить Wordstat API без аккаунта Директа?
Да, через Yandex Cloud AI Studio и Search API v2. Нужен только платежный аккаунт Yandex Cloud, рекламный кабинет для этого не требуется.
Сколько ждать одобрения заявки на прямой Wordstat API?
Официальных сроков Яндекс не публикует, по практике сообщества это от нескольких дней до двух недель после подачи ClientId в поддержку Директа.
Что делать, если Yandex Cloud пишет ошибку про folder ID?
Обычно причина в том, что folder_id в запросе не совпадает с фолдером сервисного аккаунта. Проверьте id в адресной строке консоли после /folders/.
Нужна ли карта для тестового доступа к Yandex Cloud AI Studio?
Да, с 2026 года платежный аккаунт со статусом «активен» обязателен даже для использования бесплатного лимита запросов.
Какая роль нужна сервисному аккаунту для Wordstat?
Роль search-api.webSearch.user. Без нее запросы к методу вордстата будут отклоняться с ошибкой прав доступа.
Можно ли использовать один API-ключ и для Wordstat, и для YandexGPT?
Да, ключ из AI Studio общий для сервисов Search API и генеративных моделей, если у сервисного аккаунта назначены нужные роли для каждого из них.
Что дешевле: Direct API или Yandex Cloud AI Studio?
Прямой Wordstat API формально бесплатный в рамках квоты, но требует рекламный кабинет. AI Studio платный сверх бесплатного лимита, зато порог входа ниже и настройка быстрее.
Разобраться с доступом к Wordstat API это только первый шаг. Дальше данные о частотности удобно собирать прямо в связке с AI-инструментами вроде тех, что собраны в каталоге AI-инструментов VibeCoderz. Если нужна помощь с настройкой конкретно под ваш проект, запишитесь на консультацию к Максиму.
Обновлено: октябрь 2026
