POST /v1/search · engine=yandex
API Яндекс Поиска
Органическая выдача Яндекса в JSON или Markdown тем же запросом, что и Google: добавьте engine: "yandex" и укажите регион. Без аккаунта в Yandex Cloud, каталога и IAM-токена, с одним ключом SerpKite.
Обзор
Что умеет API Яндекс Поиска
У Яндекса собственный поисковый индекс, и по русскоязычным запросам, по России и большей части СНГ он часто знает больше, чем Google. SerpKite отдаёт эту выдачу через /v1/search: тот же конверт ответа, те же SDK и тот же ключ, что и для Google. Меняется только engine.
В ответе — органические результаты: title, link, domain, displayed_link и snippet, до 15 на страницу. country выбирает регион Яндекса (ru, ua, kz, tr, us, de и другие крупные рынки), page листает выдачу, а num больше одной страницы проходит страницы Яндекса подряд: 1 кредит за каждую страницу, где нашлись результаты.
Рекламы, колдунщиков и блоков с ответами в ответе нет, только органика. Фильтры time и safe: "active" Яндекс не поддерживает: запрос с ними и engine: "yandex" вернёт ошибку 400.
Как получить API-ключ
- 1 Зарегистрируйтесь. По email, через GitHub или Google. На счёт сразу придут 2 500 бесплатных кредитов, карта не нужна.
-
2
Скопируйте API-ключ. Ключ вида
skt_live_…создаётся в дашборде, в разделе ключей. Один ключ работает для Яндекса, Google, Bing, Brave, DuckDuckGo и Yahoo. -
3
Отправьте запрос. Ключ передаётся в заголовке
Authorization: Bearer, а в теле запроса нужныq,countryиengine: "yandex".
Что приходит в ответе
-
results[]array - Органические результаты: position, title, link (адрес страницы), domain, displayed_link и snippet.
-
requestobject - Параметры запроса после нормализации: q, engine, country, page, num.
-
metaobject - request_id, credits_used, cached, latency_ms, parse_quality, engine (движок, который ответил) и route (каждая попытка: движок, результат и время в мс).
Запрос
curl https://api.serpkite.com/v1/search \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"кофемашина","country":"ru","engine":"yandex"}'Ответ (живой ответ, сокращён до двух результатов)
{
"request": {
"country": "ru",
"endpoint": "search",
"engine": "yandex",
"language": "en",
"num": 10,
"page": 1,
"q": "кофемашина"
},
"results": [
{
"domain": "wildberries.ru",
"link": "https://www.wildberries.ru/catalog/721142966/detail.aspx",
"position": 1,
"snippet": "Доп. опции кофемашины. капучинатор; одновременное приготовление двух чашек; поддержание температуры готового кофе; подогрев чашек; подсветка...",
"title": "Кофемашина капсульная и рожковая с капучинатором"
},
{
"domain": "ozon.ru",
"link": "https://www.ozon.ru/product/kofemashina-avtomaticheskaya-zernovaya-kofevarka-s-kapuchinatorom-i-kofemolkoy-20-bar-3559390167/",
"position": 2,
"snippet": "Кофемашина автоматическая зерновая, кофеварка с капучинатором и кофемолкой, 20 Бар, предсмачивание, 12 программ, регулировка высоты стакана, управление по Wi-Fi...",
"title": "Кофемашина автоматическая зерновая, кофеварка с..."
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 1,
"cached": false,
"engine": "yandex",
"route": [
{
"provider": "yandex",
"outcome": "ok",
"ms": 770
}
],
"latency_ms": 795,
"parse_quality": "ok"
}
}
В каждом ответе есть заголовки X-Credits-Used, X-Credits-Remaining,
X-Cache и X-Tokens-Estimate.
Запустить этот запрос в песочнице
Один ключ, много поисковиков
Яндекс через SerpKite
- Тот же ключ, тот же конверт ответа и тот же вызов SDK, что и для Google: меняется только
engine. meta.engineназывает движок, который ответил, аmeta.routeперечисляет все попытки. Результат никогда не выдаётся за чужой.engine: "auto"оставляет Google первым и переходит к Яндексу последним, только если остальные движки не ответили. Как работает запасной маршрут- SerpKite читает публичные страницы Яндекса без входа в аккаунт и не связан с Яндексом.
Справочник
Параметры
Параметры /v1/search для Яндекса: в JSON-теле запроса или в строке запроса.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
q
обязательный
|
string | – | Поисковый запрос, до 2 048 символов. Пишите на языке аудитории: русские запросы работают в любом регионе. |
engine
|
string | string[] | "yandex" — только Яндекс. "auto" сначала пробует Google и переходит к другим движкам, только если он не ответил (Яндекс — последний запасной). Список, например ["google", "yandex"], ограничивает маршрут этими движками. | |
country
|
string | us | Регион Яндекса, двухбуквенный код ISO: ru, ua, kz, tr, us, de и другие крупные рынки. |
page
|
integer | 1 | Страница выдачи, 1–10. Каждая страница оплачивается отдельно. |
num
|
integer | 10 | Сколько результатов вернуть, до 100. Если нужно больше одной страницы, SerpKite проходит страницы Яндекса подряд: 1 кредит за каждую страницу с результатами. |
format
|
string | json | Формат ответа: json, compact (JSON только с полями, нужными агенту) или markdown (готовый текст для LLM). |
fields
|
string | – | Проекция через запятую, например results.title,results.link. Ответ короче, токенов меньше. |
max_age
|
integer | – | Принять результат из кэша не старше N секунд. Попадание в кэш стоит 0.5 кредита вместо 1. |
Полный справочник, коды ошибок и заголовки — в документации по провайдерам (на английском).
Сравнение
SerpKite и Yandex Cloud Search API
Yandex Cloud Search API — официальный продукт Яндекса. Если выдача Яндекса нужна рядом с Google, в одном формате и без облачной инфраструктуры, SerpKite проще подключить. Актуальные цены Yandex Cloud смотрите на сайте Yandex Cloud.
| Yandex Cloud Search API | SerpKite | |
|---|---|---|
| Что нужно для старта | Аккаунт Yandex Cloud, платёжный аккаунт, каталог (folder ID) и сервисный аккаунт с нужной ролью | Регистрация по email, GitHub или Google и один API-ключ |
| Авторизация | IAM-токен или API-ключ сервисного аккаунта | Authorization: Bearer skt_live_… |
| Формат ответа | XML или HTML выдачи | JSON, компактный JSON или Markdown, в том же конверте, что и у Google |
| Оплата | По тарифам Yandex Cloud, через платёжный аккаунт облака | Пакеты кредитов от $0.60 за 1000 запросов, без подписки; кредиты не сгорают, неудачные и пустые запросы бесплатны |
| Другие поисковики | Только Яндекс | Google, Bing, Brave, DuckDuckGo, Yahoo и Яндекс с тем же ключом; engine: "auto" для запасного маршрута |
| Источник данных | Официальный API Яндекса | Публичные страницы выдачи без входа в аккаунт; SerpKite не связан с Яндексом |
Задачи
Что строят на этом API
Позиции сайта в Яндексе
Проверяйте, на каком месте стоит сайт по русскоязычным запросам, с разбивкой по регионам: Россия, Казахстан, Турция и другие.
Массовый сбор выдачи
Ставьте до 100 запросов за раз в очередь POST /v1/batches: 0.5 кредита за страницу, результат придёт на вебхук.
Агенты и RAG на русском
Отдавайте агенту выдачу Яндекса в JSON или Markdown через MCP, LangChain или SDK для Python, TypeScript и Go.
Цены
Сколько стоит
Цена запроса
1 кредит
за страницу результатов, как у Google
- От $0.60 за 1000 запросов на крупном пакете, $1.00 на стартовом.
- Кредиты не сгорают. Без подписки.
- За неудачные, пустые и заблокированные запросы кредиты не списываются.
- 2 500 бесплатных кредитов при регистрации, затем 1 000 в месяц.
| Пакет | Цена | За 1000 запросов | Запросов в пакете |
|---|---|---|---|
| Starter | $10 | $1.00 | 10 000 |
| Growth | $50 | $0.80 | 62 500 |
| Pro | $300 | $0.60 | 500 000 |
Вопросы
Частые вопросы
Что ещё почитать
Связанные страницы
Начните сейчас
Ключ за 30 секунд
2 500 бесплатных кредитов, затем 1 000 каждый месяц. Без карты.