Yandex Search API: официальный API выдачи и альтернативы

Запрос «yandex search api» люди задают в двух разных ситуациях: одним нужен официальный API поиска от самого Яндекса, другим - любой рабочий способ получать выдачу программно. Разберём оба варианта: что из себя представляет официальный Search API, чем он хорош и неудобен, и когда практичнее взять стороннее решение.

Официальный Search API: наследник Яндекс XML

Много лет программный доступ к выдаче назывался «Яндекс.XML»: бесплатный сервис с суточными лимитами, привязкой к сайту в Вебмастере и ответом в XML. Потом Яндекс перевёз его в облачную платформу Yandex Cloud под именем Search API. Суть та же - вы отправляете запрос, получаете структурированную выдачу, - но обвязка теперь облачная: биллинг-аккаунт, каталог, сервисные аккаунты и авторизация по IAM-токенам.

Работает это надёжно: данные из первых рук, никакой борьбы с капчей, стабильный формат. Из полезного - режимы работы: синхронный, когда ответ приходит сразу, и отложенный, когда пачку запросов забираете позже, - второй дешевле и удобен для массовых задач вроде съёма позиций по всей семантике за ночь.

За что его не любят

Первое - порог входа. Чтобы сделать первый запрос, нужно завести облачный аккаунт с привязкой карты, создать каталог, сервисный аккаунт, выдать роли и разобраться с получением токенов. Для команды с DevOps это рутина на полчаса, для маркетолога - стена. Второе - квоты на скорость: лимит запросов в секунду выдаётся небольшим, под массовые задачи его приходится запрашивать отдельно. Третье - это API только про Яндекс: понадобится выдача Google - ищите второй сервис с другим форматом и биллингом.

Наконец, тарификация облачная: платите за пакеты запросов по тарифам Cloud, и стоимость надо считать под свой объём - вместе с трудозатратами на обвязку.

Формат ответа: что приходит в выдаче

Ответ - структурированный список результатов: URL, домен, заголовок, сниппет, плюс служебные блоки. Исторический формат - XML, и именно его понимает старый SEO-софт: Key Collector, Site-Auditor и прочие программы эпохи Яндекс XML. Важная деталь при самостоятельном разборе: в выдаче есть и реклама, и колдунщики, поэтому позицию сайта надо считать по органическим результатам, а не по порядковому номеру ссылки - подробнее об этой ловушке в статье про парсер выдачи Яндекса.

Альтернатива: наш API без облачной обвязки

JSON SEO делает ту же работу, но со стороны пользователя выглядит иначе: регистрация по почте, ключ в кабинете, первый запрос через минуту. Ответ - JSON с уже отделённой органикой или XML, совместимый с софтом под Яндекс XML: старые программы работают без переделки, как именно настроить - в статье про переезд с XMLRiver и XMLStock.

Цена фиксированная и простая: 0.01 ₽ за страницу выдачи, тысяча страниц - 10 ₽, стартовые 10 ₽ дают первую тысячу бесплатно. Рядом в том же API - выдача Google и Bing, частотность Вордстата и regions-справочники, то есть под задачу «позиции плюс семантика» второй сервис не нужен. А через MCP-сервер те же данные доступны ИИ-ассистенту в Claude Code или Cursor - официальный Search API в такой формат пока не завернули.

Что выбрать

Официальный Search API разумен, когда у вас уже есть инфраструктура в Yandex Cloud и нужен только Яндекс: корпоративный биллинг, предсказуемые квоты и никаких посредников. Если задача - быстро получать выдачу в скрипт, снять позиции по списку запросов или отдать данные ИИ-ассистенту, а тратить день на облачную обвязку не хочется, - начните с нашего API: тысяча бесплатных страниц покажет формат ответа на живых данных, и решение можно принимать по фактам.

Частые вопросы

Яндекс XML ещё работает?

В старом виде - нет: сервис переехал в Yandex Cloud и стал Search API. Софт, заточенный под формат Яндекс XML, при этом жив: ему нужен лишь совместимый источник данных - облачный API или сервис вроде нашего.

Это законно - получать выдачу через API?

Официальный Search API - сервис самого Яндекса, вопрос законности там не стоит вовсе. Сторонние API работают с публичной выдачей, которую видит любой пользователь; их применение для SEO-аналитики - общепринятая практика.

Как задать регион выдачи?

И в официальном API, и у нас регион задаётся кодом lr - числовым идентификатором города или области. Москва - 213, Санкт-Петербург - 2, полный список в справочнике регионов.

Можно ли получать больше 10 результатов на страницу?

Да, выдача листается страницами по 10 результатов: сколько страниц пройти, задаётся параметром глубины. Для съёма позиций выгоднее останавливать поиск на своём домене - за просмотренные страницы и платите, механика разобрана в заметке про break_domain.