Обзор

Единый интерфейс для веб-поиска. Каждый провайдер доступен по пути /v1/search/{provider} и понимает три формата: Tavily (POST), Brave Search (GET) и собственный пакетный, который отдаёт всё, что присылает провайдер.

Провайдеры

ЯндексРусский и кириллический контент. От 10 ₽ за 1000 запросов

Общая структура

Метод	Эндпоинт	Формат	Описание
`POST`	`/v1/search/{provider}`	Tavily	Drop-in для AI-агентов
`GET`	`/v1/search/{provider}`	Brave	Поиск с фильтрами и листанием
`POST`	`/v1/search/{provider}/smart`	Собственный	1–50 запросов за вызов, полные поля выдачи

Цена зависит от того, кто ответил

Один и тот же запрос можно обслужить по-разному, и мы выбираем самый дешёвый доступный способ: сначала кэш, потом отложенный режим провайдера, синхронный запрос — только если иначе никак. Ставки различаются в шестьдесят раз, поэтому каждый ответ говорит, что произошло:

X-Search-Source — cache, async или sync
X-Cost-Cents — сколько списано, в копейках
X-Search-Rungs — из чего сложилась сумма, если ставок было несколько

У пакетных эндпоинтов та же разбивка приходит в теле, в блоке billing.

Кэш

Выдача хранится 24 часа по умолчанию. В пакетных запросах срок меняется параметром cache_ttl — до 30 дней либо 0, чтобы сходить за свежими данными. Кэш общий: выдачу, за которую заплатил один запрос, получает следующий такой же.