Как получить доступ к API Вордстата в 2026 году?

Вордстат можно использовать не только в браузере. Его данные получают запросами из скрипта или через нейросеть, и тогда частотность собирается пачками, а не руками.

Сейчас официальный путь к такому доступу идёт через Yandex AI Studio. Он платный и состоит из четырёх частей. Ключ, баланс, роль и идентификатор каталога. Ниже я показываю, где взять каждую часть и как проверить, что всё сошлось.

Из чего состоит доступ

Удобно представить доступ как пропуск в офис. Ключ открывает входную дверь. Роль решает, в какие комнаты вас пустят. Баланс оплачивает сам пропуск. А Folder ID говорит, на какой адрес всё это оформлено.

Шаг 1. Создайте API-ключ

Откройте страницу Вордстата в документации Yandex Cloud и перейдите на платформу Yandex AI Studio. Внизу страницы указана роль, она понадобится на третьем шаге.

1. В правом верхнем углу нажмите «Создать API-ключ».
2. Напишите короткое описание, чтобы потом не гадать, для чего этот ключ.
3. Выберите срок действия. Я оставляю «Бессрочно». Если поставить срок, ключ придётся перевыпускать.
4. Нажмите «Создать» и дождитесь окна с результатом.

В окне появятся секретный ключ и его идентификатор. Секретный ключ показывается только один раз. Закроете окно, и посмотреть его уже не получится, поэтому сразу сохраните оба значения.

Выглядят они примерно так. Это выдуманные значения, они нигде не работают.

Настоящий секретный ключ длиннее и начинается на AQVN. Идентификатор начинается на aje.

Шаг 2. Пополните баланс

Запросы к Вордстату через AI Studio оплачиваются, поэтому на балансе должны быть деньги. Кнопка «Пополнить» находится рядом с суммой в правом верхнем углу.

Я кладу 400 ₽ на месяц. По факту за последние 30 дней ушло 186 ₽, расход виден прямо рядом с балансом.

Шаг 3. Проверьте роль у сервисного аккаунта

Ключ принадлежит сервисному аккаунту, он создаётся вместе с ключом. Но в Вордстат этот аккаунт сможет ходить только при наличии нужной роли.

1. Откройте сервис Identity and Access Management в консоли Yandex Cloud (console.yandex.cloud).
2. Зайдите в «Сервисные аккаунты». Роли каждого аккаунта видны в соседнем столбце.
3. Откройте нужный аккаунт и перейдите в «Права доступа».
4. Найдите роль search-api.webSearch.user. У меня она уже была.
5. Если роли нет, нажмите «Добавить роль», найдите её по названию, добавьте и сохраните.

Шаг 4. Найдите Folder ID

Идентификатор каталога написан на главной странице консоли Yandex Cloud, под названием каталога. Рядом есть ID облака, он выглядит похоже. Это другое значение, не перепутайте.

Это выдуманный пример. Настоящий начинается на b1g и состоит из 20 символов. Сохраните его в тот же файл.

Шаг 5. Поднимите лимит запросов

Без дополнительных действий в Вордстат можно сделать только 100 запросов в час. Для разового поиска хватит, а для сбора семантики пачками мало, придётся ждать часами. Лимит увеличивается через поддержку, оформить обращение нужно один раз.

1. В консоли Yandex Cloud откройте поддержку и нажмите «Новое обращение».
2. Выберите тип «Квоты» и сервис Yandex Search API.
3. В теме напишите «Увеличение квоты лимитов».
4. Вставьте текст ниже и подставьте свой Folder ID.
5. Отправьте обращение.

Проверьте, что доступ работает

Самая быстрая проверка это один запрос. Подставьте свой ключ и Folder ID. Цифра 225 означает всю Россию.

Если в ответе пришло общее число запросов и список фраз с частотой, значит ключ, роль, баланс и Folder ID настроены верно.

Если код вам не нужен, ключ и Folder ID можно просто передать нейросети. Как это сделать, я описал в статье про подключение нейросети к Метрике, Вебмастеру и Вордстату.

Как не потерять доступ и деньги

• Сохраняйте секретный ключ сразу при создании. Потом его уже не покажут, в списке видны только последние символы.
• Не отправляйте ключ в чаты и не выкладывайте его в публичные репозитории. Если он всё же попал не туда, удалите его в списке API-ключей и создайте новый.
• Следите за балансом. Когда деньги кончатся, запросы начнут возвращать ошибку оплаты.

Что может пойти не так