API документация · /yandex/search · 63 документа

Yandex Search API: Документация поиска Яндекса для разработчиков

Текстовый поиск в синхронном и отложенном режимах, поиск изображений, генеративный ответ и Wordstat; справочники REST и gRPC, квоты, тарифы и роли. Ищите на сайте или подключите MCP-сервер к Claude Code и Cursor — каждый ответ со ссылкой на aistudio.yandex.ru.

Искать в Yandex Search APIПодключить MCP

Попробуйте найти

Паспорт источника

Service ID
/yandex/search
Источник
aistudio.yandex.ru — официальная документация
Документов
63
Состав
26 страниц руководств · 19 страниц REST API · 18 страниц gRPC API
Проверка источника
05.06.2026
Версия API
не подтверждена
aistudio.yandex.ru/docs/ru/search-api/concepts/

Yandex Search API — один из 17 API в Bridge8. Тот же поиск и MCP-сервер работают для VK, Яндекса, Битрикс24, Авито и других:

Весь каталог: 25 источников →

Что включено

63 документа Yandex Search API в одном поиске

Сохранённые копии aistudio.yandex.ru. У каждого документа — ссылка на официальную страницу и дата импорта.

  • Начало работы, доступ и тарифы

    8

    О сервисе, быстрый старт с API-ключом, правила тарификации, управление доступом и роли, история изменений, аудитные логи, обзоры справочника и инструкций.

    • Как начать работать
    • Правила тарификации
    • Управление доступом

  • Концепции и квоты

    6

    Текстовый поиск, поиск изображений, генеративный ответ, язык запросов и поисковые операторы, Wordstat, квоты и лимиты.

    • Квоты и лимиты
    • Генеративный ответ
    • Поисковые операторы

  • Пошаговые инструкции

    10

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

    • Поиск в синхронном режиме
    • Мобильная выдача
    • Топ по ключевой фразе

  • Справочник REST API v2

    19

    WebSearch, WebSearchAsync, ImageSearch, GenSearch, Operation и Wordstat: тела запросов и ответов; аутентификация и заголовки для диагностики ошибок.

    • WebSearch.Search
    • GenSearch.Search
    • Operation.Get

  • Справочник gRPC API v2

    18

    Те же возможности в виде gRPC-вызовов: WebSearchService, WebSearchAsyncService, ImageSearchService, GenSearchService, OperationService, WordstatService.

    • WebSearchService.Search
    • WordstatService.GetTop
    • OperationService.Get

  • Коды ошибок и регионы

    2

    Коды и описания распространённых ошибок поисковых запросов, регионы поиска.

    • Коды ошибок
    • Регионы поиска

С чего начать

Как получить API-ключ и сделать первый запрос: пять шагов по документации

Коротко по официальному руководству «Как начать работать с Yandex Search API». Подробности каждого шага — в поиске Bridge8 или у вашего ИИ-агента.

  1. Войдите в AI StudioС аккаунтом Яндекс ID создайте организацию и облако — в организации автоматически появится каталог default.
  2. Привяжите платёжный аккаунтНужен активный платёжный аккаунт со статусом ACTIVE или TRIAL_ACTIVE. За первый аккаунт с привязанной картой начисляется стартовый грант.
  3. Создайте API-ключ«Создать API-ключ» в AI Studio: выберите срок действия и сохраните секретный ключ — после закрытия диалога он недоступен. Вместе с ключом создаётся сервисный аккаунт с ролью для Search API.
  4. Отправьте запросPOST https://searchapi.api.cloud.yandex.net/v2/web/search с заголовком Authorization: Api-Key. В теле — query (searchType, queryText), folderId и responseFormat.
  5. Декодируйте результатПоле rawData содержит выдачу в кодировке Base64: HTML или XML — в зависимости от responseFormat.

Квоты по умолчанию

Синхронные запросы
10 в секунду, 10 000 в час
Отложенные запросы
10 в секунду, 35 000 в час
Генеративный ответ
1 в секунду, 1 000 в час
Wordstat
10 в секунду, 100 в час

Квоты можно изменить через техническую поддержку. Лимиты неизменны: не более 250 результатов, запрос — до 400 символов и 40 слов.

aistudio.yandex.ru/docs/ru/search-api/concepts/limits
Ночью дешевле

С 00:00:00 по 07:59:59 UTC+3 для синхронных и отложенных запросов действуют льготные тарифы — см. «Правила тарификации».

Документация

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу aistudio.yandex.ru.

Методы REST API v2

7 из 11
Все 11 методов REST API в поиске

Как использовать

Три способа работать с документацией Yandex Search API

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

  1. 01 · На сайте

    Поиск без регистрации

    Выберите Yandex Search API в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на aistudio.yandex.ru.

    Yandex Search API · 63 → стоимость отложенных запросов

  2. 02 · ИИ-агент по MCP

    Спросите Claude Code или Cursor

    Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.

    «Напиши на Python клиент Yandex Search API: отложенный поиск через WebSearchAsync, опрос Operation.Get и декодирование rawData. Сверь методы с aistudio.yandex.ru»
    resolve_service → search_docs → get_document

  3. 03 · Документ целиком

    Читайте страницу полностью

    get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.

    get_document → WebSearch.Search

Пример ответа · POST /v2/web/search

Yandex Search API /yandex/search

POST /v2/web/search

WebSearch.Search — синхронный текстовый поиск. Результат приходит в поле rawData: XML (по умолчанию) или HTML в кодировке Base64.

Параметры

query.queryTextstring
Текст поискового запроса, не более 400 символов.
folderIdstring
Идентификатор каталога, не более 50 символов.
responseFormatenum
Формат выдачи: FORMAT_XML (по умолчанию) или FORMAT_HTML.
aistudio.yandex.ru/docs/ru/search-api/api-ref/WebSearch/search

REST API v2версия не подтверждена

Подключение

Подключите документацию Yandex Search API к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает Yandex Search API и ещё 16 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

  1. Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
  2. Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
  3. Спросите про Yandex Search API«Найди в Yandex Search API, как сделать отложенный поиск и забрать результат через Operation, и покажи ссылку на источник».
Получить токен
Только документация

Bridge8 не выдаёт API-ключи и IAM-токены, не создаёт сервисные аккаунты и не отправляет запросы в Search API от вашего имени. Агент получает документацию и сам пишет код.

Claude Code — команда
claude mcp add --transport http bridge8 \ https://bridge8.ru/mcp \ --header "Authorization: Bearer <TOKEN>"
JSON для --mcp-config
{ "mcpServers": { "bridge8": { "type": "http", "url": "https://bridge8.ru/mcp", "headers": { "Authorization": "Bearer <TOKEN>" } } } }

Инструменты сервера — в порядке вызова

  1. resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
  2. search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
  3. get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о Yandex Search API

Как получить API-ключ Yandex Search API?

Нужны организация в AI Studio и активный платёжный аккаунт. Нажмите «Создать API-ключ», выберите срок действия и сохраните секретный ключ: после закрытия диалога он недоступен. Вместе с ключом создаётся сервисный аккаунт с ролью для Search API. Ключ передают в заголовке Authorization: Api-Key <API-ключ>.

Какая роль нужна для запросов?

Инструкции требуют роль search-api.webSearch.user; при IAM-токене (Authorization: Bearer) её назначают на каталог и передают folderId в каждом запросе. В документах есть расхождение: «Управление доступом» называет роль search-api.executor устаревшей, а «Коды ошибок» для кода 42 советуют проверить её у сервисного аккаунта. Сверяйте с aistudio.yandex.ru.

Какие квоты действуют?

Синхронные запросы — 10 в секунду и 10 000 в час, отложенные — 10 в секунду и 35 000 в час, генеративный ответ — 1 в секунду и 1 000 в час, Wordstat — 10 в секунду и 100 в час. Квоты меняются через техподдержку. Лимиты неизменны: до 250 результатов, запрос до 400 символов и 40 слов.

Сколько стоит Yandex Search API?

По «Правилам тарификации» на дату выгрузки 2026-06-05, с НДС за 1000 запросов: дневные синхронные — 488 ₽, отложенные — 30,5 ₽; ночью (00:00–07:59:59 UTC+3) — 366 ₽ и 25,41 ₽; поиск изображений — 915 ₽, генеративный ответ — 5 080 ₽. Актуальные цены сверяйте на aistudio.yandex.ru.

В каком формате приходит выдача?

Текстовый поиск — XML или HTML, в синхронном и отложенном режимах; в REST результат лежит в поле rawData в кодировке Base64. Поиск изображений — XML или JSON, только синхронно. Генеративный ответ — только в синхронном режиме.

Есть ли в Search API Wordstat?

Да. Методы GetTop, GetDynamics, GetRegionsDistribution и GetRegionsTree возвращают статистику поисковых запросов к Яндексу; Wordstat работает только через API в синхронном режиме. Подробнее — на странице «Wordstat API» в Bridge8.

Это официальный сайт Yandex Search API?

Нет. Bridge8 хранит копию официальной документации aistudio.yandex.ru для поиска и ИИ-агентов. У каждого фрагмента — ссылка на первоисточник и дата импорта; версия API не подтверждена.

Bridge8 может выполнять поисковые запросы за меня?

Нет. Bridge8 — документация для разработчиков: он не выдаёт API-ключи, не хранит токены и не обращается к Search API от вашего имени. Запросы отправляет и оплачивает ваш аккаунт AI Studio.

Ещё в Bridge8

Один поиск и один MCP-сервер для 17 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Другие API в Bridge8

16 API · 5 695 документов

Яндекс

7 API

VK и MAX

3 API

CRM, телефония, банк

3 API

Объявления и рассылки

3 API

Справка и курсы

8 источников

Справка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.

Каталог на главной
← На главную: поиск по всем источникамbridge8.ru/#catalog

Нет нужного API?

Добавим документацию вашего API в Bridge8

Напишите, какой API нужен вам или вашим клиентам, и пришлите ссылку на официальную документацию. Мы проверим источник и подключим его к поиску, каталогу и MCP-серверу — со ссылкой на первоисточник у каждого ответа.

Написать намПредложить на GitHub

info@lidfly.rugithub.com/awaik/bridge8

Что прислать

  1. Ссылку на документациюОфициальный сайт, OpenAPI/Swagger или репозиторий с описанием методов.
  2. Название и версию APIНапример, «Ozon Seller API». Версии ищутся отдельно и не смешиваются.
  3. Для чего он нуженИнтеграция, ИИ-агент, поддержка клиентов — так мы поймём приоритет.