Yandex Search API: как использовать в 2026
Официальный API Яндекс Поиска для парсинга выдачи. Что такое v1 и v2, сколько стоит, как зарегистрироваться, как встроить в код и AI-агенты вроде Claude Code или Cursor.
Что такое Yandex Search API
Yandex Search API — официальный платный сервис Яндекса, который отдаёт результаты поиска по запросу программно, в виде XML или JSON. Используется для SEO-мониторинга, парсинга выдачи, обогащения данных и встраивания «поиска по Яндексу» внутрь сторонних продуктов.
Это легальная альтернатива скрапингу — Yandex прямо разрешает использовать данные API в рамках лицензии и не банит за это IP.
Search API v1 vs Search API v2
v1 (XML, legacy)
Старый формат, отдаёт XML. До сих пор поддерживается, но Яндекс не рекомендует для новых интеграций. Лимит — ~10 000 запросов/сутки.
v2 (JSON, актуальная)
Современная версия. JSON-ответ, отдельные ручки на web/images/video, поддержка регионального поиска, групповая сортировка, контрольные суммы документов. Это то, что вы хотите использовать сегодня.
Сколько стоит Yandex Search API
Тарификация — за 1000 запросов, оплата помесячная через Yandex Cloud. Точная цена меняется (проверяйте в консоли YC), на 2026-й порядок: ~50–200 ₽ за 1000 запросов. Есть бесплатный тестовый объём — обычно 10 000 запросов в месяц для оценки.
Как начать: регистрация и ключ
- Заведите аккаунт в Yandex Cloud и создайте организацию.
- В консоли YC откройте сервис
Search APIи подключите его к биллингу. - Создайте сервисный аккаунт и API-ключ. Это и есть токен, который вы будете слать в каждом запросе.
- Получите
folder_id— он нужен в теле запроса.
Пример запроса (Python)
# v2 web search, JSON
import requests
r = requests.post(
"https://searchapi.api.cloud.yandex.net/v2/web/searchAsync",
headers={"Authorization": f"Api-Key {KEY}"},
json={
"query": {"searchType": "SEARCH_TYPE_RU", "queryText": "neuraldeep"},
"folderId": FOLDER_ID,
},
)
print(r.json())
Ответ возвращается в виде operation_id — асинхронно. Через 1–3 секунды забираете результат отдельным запросом в /v2/operations/{id}.
Yandex Search API в Claude Code и Cursor
Если вы пишете код в Claude Code или Cursor, неудобно каждый раз вспоминать схему запроса и парсить XML/JSON руками. В skillsbd есть готовые навыки, которые AI-агент подхватит автоматически:
# Установите CLI
$ npx skillsbd search яндекс
# Установите навык для Search API
$ npx skillsbd add yandex-search-api
# Готово — Claude Code / Cursor сами вызовут API
Навык содержит SKILL.md с описанием эндпоинтов, корректную схему запроса и пример обработки ответа. Агент пишет ваш код, используя эту инструкцию вместо своих галлюцинаций про устаревший API.
Частые вопросы
Есть ли бесплатный Yandex Search API?
Полностью бесплатного нет, но есть тестовый объём в Yandex Cloud (≈10 000 запросов/мес) — достаточно для прототипа.
Можно ли парсить выдачу без API?
Технически да, но Яндекс блокирует IP при систематическом скрапинге. Search API — единственный официально разрешённый путь.
Чем отличается от Yandex XML?
Yandex XML — устаревшее название Search API v1. Сегодня правильнее использовать v2 через Yandex Cloud.
Какие региональные коды поддерживаются?
Все стандартные регионы Яндекса (Россия — 213 Москва, 2 СПб, и т.д.), плюс отдельные коды для en/ua/tr/by/kz версий поиска.