Гайд · официальный API выдачи Яндекса

Yandex Search API: цена, подключение и альтернативы

Yandex Search API — платный официальный API, который отдаёт выдачу Яндекса в формате XML. Он заменил бесплатный Яндекс.XML. Ниже — сколько он стоит на самом деле, как получить ключ, как сделать первый запрос и когда дешевле взять тот же Search API у посредника.

Цены и данные проверены 5 октября 2026 ·как мы проверяем

Что такое Yandex Search API

Это сервис Яндекса для автоматических запросов к поисковой базе. Вы отправляете текст запроса, регион и настройки, а в ответ получаете выдачу: адреса страниц, заголовки, сниппеты. Капча, блокировки и прокси здесь не нужны — это легальный доступ от самого поисковика.

Названий у сервиса несколько — Yandex Search API, Yandex Cloud Search API, «API поиска Яндекса», — речь об одном и том же продукте.

Для чего его используют:

• съём позиций сайта по ключевым фразам в нужном регионе;
• сбор топа конкурентов и кластеризация семантического ядра по выдаче;
• проверка индексации и поиск по своему сайту или группе сайтов;
• поиск для RAG-систем и AI-агентов — для этого есть смарт-сниппеты и генеративный ответ.

До осени 2023 года ту же задачу решал бесплатный Яндекс.XML с лимитами, которые зависели от ваших сайтов в Вебмастере. Как он работал и что от него осталось — в разборечто такое XML-лимиты и Яндекс XML.

Версии v1 и v2: что изменилось

v1 — переходный формат, совместимый со старым Яндекс.XML: GET-запрос видаyandex.com/search/xml?folderid=…&apikey=…&query=…, ответ сразу в XML. Так его описывал анонс Yandex Cloud от 29 октября 2023 года, когда Search API стал доступен всем по тарифам.

v2 — актуальный интерфейс: REST, gRPC и SDK, синхронный и отложенный режимы, поиск изображений, смарт-сниппеты и генеративные ответы. Выдача по-прежнему приходит в XML (или в HTML, если попросить), но завёрнутой в JSON: поле rawData в кодировке Base64. Документация переехала из Yandex Cloud в Yandex AI Studio.

Сколько стоит Yandex Search API: цены за 1000 запросов

Единица тарификации — один запрос. Стоимость зависит от режима и времени суток: с 00:00 до 07:59 по Москве действуют ночные тарифы. Бесплатного объёма в прайсе нет.

Через тот же API доступна и частотность Wordstat: топ фраз и динамика — 20 ₽ за 1000 запросов, распределение по регионам — 50 ₽. Квота — 100 запросов статистики в час.

Расчёт стоимости на типичных объёмах

Один запрос с groupsOnPage=100 возвращает топ-100 по фразе. Сравним официальные режимы с тем же Search API у посредника — XMLstock на бессрочном тарифе без предоплаты (28 ₽ за 1000).

Синхронный или отложенный режим

В отложенном режиме Яндекс возвращает объект операции с идентификатором. Его нужно периодически опрашивать, пока поле done не станет true, и только тогда забиратьresponse.rawData. Это лишний код и очередь на вашей стороне — цена низкая именно за готовность ждать.

Квоты и лимиты

Яндекс разделяет ограничения на два вида. Квоты — организационные, их можно поднять через поддержку. Лимиты — технические, их изменить нельзя.

Квоты — можно поднять через поддержку

Лимиты — не меняются

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

1. Аккаунт и платёжный аккаунт. Войдите в Yandex Cloud / AI Studio и привяжите платёжный аккаунт — без него запросы не выполняются.
2. Каталог. Создайте каталог или выберите существующий. Его идентификатор — этоfolderId, он передаётся в каждом запросе.
3. Сервисный аккаунт. Создайте его в том же каталоге — от его имени пойдут запросы.
4. Роль. Назначьте сервисному аккаунту роль search-api.webSearch.user. Роль search-api.executor, которую до сих пор советуют старые инструкции, относится к устаревшему API.
5. Ключ. Выпустите API-ключ сервисного аккаунта и сохраните сразу — повторно его не покажут. Вместо ключа можно использовать IAM-токен, но он живёт ограниченное время и его придётся обновлять.
6. Проверка. Отправьте тестовый запрос из примера ниже. Если в ответе ошибка доступа — проверьте роль и что каталог в запросе тот же, где создан сервисный аккаунт.

Подробно и со скриншотами консоли шаги описаны вдокументации AI Studio. Интерфейс облака меняется чаще, чем сами шаги, поэтому здесь — последовательность без привязки к кнопкам.

Пример запроса на Python

Синхронный запрос v2: топ-100 по фразе для Москвы (регион 213). Ключ и каталог берутся из переменных окружения, чтобы не попасть в код.

import base64, os
import xml.etree.ElementTree as ET
import requests

resp = requests.post(
    "https://searchapi.api.cloud.yandex.net/v2/web/search",
    headers={"Authorization": f"Api-Key {os.environ['YC_API_KEY']}"},
    json={
        "query": {"searchType": "SEARCH_TYPE_RU", "queryText": "яндекс xml"},
        "groupSpec": {"groupMode": "GROUP_MODE_DEEP", "groupsOnPage": "100", "docsInGroup": "1"},
        "region": "213",
        "folderId": os.environ["YC_FOLDER_ID"],
        "responseFormat": "FORMAT_XML",
    },
    timeout=60,
)
resp.raise_for_status()

xml = base64.b64decode(resp.json()["rawData"])
for position, doc in enumerate(ET.fromstring(xml).iter("doc"), start=1):
    print(position, doc.findtext("url"))

Тот же топ-100 у посредника — обычный GET без облака, ключ выдают сразу после регистрации:

https://xmlstock.com/yandex/xml/?user=USER_ID&key=API_KEY&query=яндекс+xml&lr=213&groupby=100

Что приходит в ответе

После декодирования rawData получается XML в том же формате, что был у Яндекс.XML. Вот начало реального ответа: запрос «яндекс xml», Москва, 100 результатов на странице. Мы получили его через Search API у XMLstock 5 октября 2026 года — в одном ответе пришли все 100 позиций.

<response date="20261005T080301">
  <found priority="all">567148</found>
  <found-human>Нашлось 567 тыс. ответов</found-human>
  <results>
    <grouping attr="d" mode="deep" groups-on-page="100" docs-in-group="1">
      <page first="1" last="101">0</page>
      <group>
        <doc>
          <url>https://yandex.ru/dev/xml/?</url>
          <domain>yandex.ru</domain>
          <title><hlword>Яндекс</hlword>.<hlword>XML</hlword> — Технологии <hlword>Яндекса</hlword></title>
          <passages>
            <passage>Сервис для получения ответов поисковой базы <hlword>Яндекса</hlword> в формате <hlword>XML</hlword>.</passage>
          </passages>
        </doc>
      </group>
      …ещё 99 групп
    </grouping>
  </results>
</response>

• <found> — сколько документов нашёл поиск;
• <group> — один результат выдачи; позиция — порядковый номер группы;
• <url>, <domain>, <title> — адрес, домен и заголовок;
• <passage> — фрагменты сниппета; <hlword> — слова, которые Яндекс подсветил.

XML содержит только органическую выдачу. Реклама, быстрые ответы и другие блоки страницы есть лишь в HTML-формате. Если нужна выдача «как у пользователя» — с Директом, колдунщиками и мобильной версией, — берут живую выдачу у посредника: у XMLstock это режим Live. Отсюда и частое расхождение позиций в API с тем, что вы видите в браузере.

Официальный API или посредник

Отложенный режим Яндекса выигрывает только по цене и только если вы готовы ждать и писать код для очереди операций. Для съёма позиций в привычных программах и для любых задач, где ответ нужен сразу, посредник проще и дешевле. Тарифы посредников — в обзорах XMLstockи XMLriver (Search API у них стоит одинаково).

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

Дальше: сравнение XMLstock и XMLriver ивсе способы получить выдачу Яндекса и Google.