Тот же запрос — 600 ₽ или 10 ₽ за тысячу. Ставку выбираем мы
Один запрос — три способа его обслужить. Из кэша за 10 ₽ / 1000, отложенным режимом Яндекса за 60 ₽, синхронно за 600 ₽ — только если иначе никак. Выбираем мы, платите вы по факту, и в ответе видно, по какой ставке он прошёл.
Прокси к поисковой выдаче Яндекса. Отдаём чистый JSON: результаты, сниппеты, домены, абсолютные позиции. Работает без корпоративного договора с Яндексом и без белых IP — только ваш sk_-ключ.
Возможности
Видно, за что списано
У совместимых эндпоинтов в ответе приходят заголовки X-Search-Source и X-Cost-Cents: видно, обслужен запрос из кэша, отложенным режимом или синхронно, и во сколько это обошлось. У пакетных то же самое приходит в теле, в блоке billing, с разбивкой по ставкам. Проверяемо по каждому вызову, а не только в конце месяца.
Пакетный поиск до 50 запросов
POST /v1/search/yandex/smart принимает до 50 запросов разом и возвращает по каждому статус, результаты и разбивку стоимости. Для фоновой работы — /async: отправили, забрали позже, платите по отложенной ставке.
Brave и Tavily — drop-in
POST /v1/search/yandex — Tavily-совместимо, GET /v1/search/yandex — Brave-совместимо. Меняете базовый URL существующего клиента, код остаётся прежним — и он автоматически получает умный подбор ставки.
Региональная выдача
Параметр country (ISO 3166-1) и параметр region с кодом региона Яндекса: 225 — Россия, 213 — Москва, 2 — СПб, 65 — Новосибирск. Поддержан и в POST (Tavily), и в GET (Brave).
MCP из коробки
Тот же endpoint доступен Claude и ChatGPT через наш MCP-сервер — без написания адаптера, без ручной конфигурации тулов.
Пример запроса
curl -X POST "https://proxy.unoapi.ru/v1/search/yandex" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"query": "нейросети", "max_results": 10, "region": 225}'
# X-Search-Source: cache | async | sync — чем обслужен запрос
# X-Cost-Cents: 1 | 6 | 60 — во сколько он вам обошёлсяconst res = await fetch('https://proxy.unoapi.ru/v1/search/yandex', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.UNOAPI_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ query: 'нейросети', max_results: 10, region: 225 }),
});
console.log(res.headers.get('x-search-source'), res.headers.get('x-cost-cents'));
const { results } = await res.json();import httpx, os
r = httpx.post(
"https://proxy.unoapi.ru/v1/search/yandex",
json={"query": "нейросети", "max_results": 10, "region": 225},
headers={"Authorization": f"Bearer {os.environ['UNOAPI_KEY']}"},
)
print(r.headers["x-search-source"], r.headers["x-cost-cents"])
results = r.json()["results"]# До 50 запросов за раз, каждый по своей ставке
curl -X POST "https://proxy.unoapi.ru/v1/search/yandex/smart" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"queries": [{"query": "ремонт квартир"}, {"query": "натяжные потолки"}],
"defaults": {"region": 213, "max_results": 20}
}'
# В ответе billing.breakdown: сколько ушло по каждой ставкеСравнение
| Параметр | УноАПИ.ru | Официальный API | Международные сервисы |
|---|---|---|---|
| Язык документации | Русский + английский | Русский | Английский |
| Оплата | Рубли, карта РФ | Рубли, корп. договор | USD, SWIFT / Stripe |
| Региональная выдача | ✓ Параметр region | ✓ | — |
| MCP-сервер | ✓ Из коробки | — | Только Tavily |
| Brave-совместимость | ✓ Drop-in | — | Brave — да, Яндекс — нет |
| Лимиты | По балансу | По тарифу | По плану подписки |
Часто задаваемые вопросы
Чем это отличается от прямого API Яндекса?
Прямой API Яндекс Поиска требует корпоративного договора и согласования. УноАПИ.ru — один sk_-ключ, оплата с любой карты РФ, доступ за минуты после регистрации.
Какие форматы ответа поддерживаются?
Tavily-совместимый (POST /v1/search/yandex, он же алиас POST /search) и Brave-совместимый (GET /v1/search/yandex). Одной выдачей можно обслужить оба протокола — меняете метод и базовый URL, клиентский код остаётся прежним.
Можно ли указывать регион поиска?
Да. Параметр `country` (ISO 3166-1, например `ru`) для страны и параметр `region` с кодом города Яндекса для точной локализации: 225 — Россия, 213 — Москва, 2 — СПб, 65 — Новосибирск. Работает и в POST (`{"region": 213}`), и в GET (`?region=213`). Если опустить — Яндекс определит регион по IP вызывающего.
Сколько стоит один запрос?
От 10 ₽ за 1000 (из кэша) до 600 ₽ (синхронно) — зависит от того, как его удалось обслужить. Актуальный прайс — на странице /pricing; новым пользователям начисляются ежемесячные бесплатные кредиты.
Почему одинаковые запросы стоят по-разному?
Потому что второй раз мы уже не ходим в Яндекс. Первый запрос оплачивает выдачу, следующий такой же берёт её из общего кэша за 10 ₽ за 1000 — в шесть раз дешевле отложенного запроса и в шестьдесят раз дешевле синхронного. Это не скидка, а факт: работа уже сделана. Поэтому цена в счёте зависит от того, насколько повторяются ваши запросы, а не только от их количества.
Можно ли искать пачками?
Да, до 50 запросов за вызов: POST /v1/search/yandex/smart. Общие параметры выносятся в defaults, каждый запрос может их переопределить. В /smart и /sync одинаковые запросы внутри пакета уходят в Яндекс один раз — повтор считается попаданием в кэш; в ответе приходит разбивка, сколько ушло по каждой ставке. Если результаты нужны не сразу, /async обойдётся в десять раз дешевле синхронного поиска (там каждый запрос отправляется отдельно, даже одинаковые).
Что отдаётся кроме заголовка и ссылки?
В собственном формате — абсолютная позиция в выдаче, идентификатор документа у Яндекса, домен, язык документа, дата изменения, размер, MIME-тип и ссылка на сохранённую копию. Плюс по каждому запросу: сколько всего документов нашёл Яндекс. Совместимые форматы Brave и Tavily этого не переносят — в их схемах таких полей просто нет.
Есть ли лимит RPS?
Жёсткого лимита нет — ограничение по балансу. Если нужна гарантированная полоса, [свяжитесь с нами](/contact) — выдадим отдельный ключ с выделенной квотой.
Как использовать API из Claude или ChatGPT?
Подключите наш MCP-сервер — Claude Desktop и ChatGPT увидят инструмент unoapi_search автоматически. Инструкция — в разделе /mcp.
Работает ли из-за границы?
Да. Запросы идут через наш backend в РФ, VPN клиенту не нужен. Единственное ограничение — биллинг принимает карты РФ и юрлица РФ.
Готовы попробовать?
Бесплатные месячные кредиты — без карты, без подписки.