Веб-поиск

POST /api/search и POST /v1/search — веб-поиск по API: режимы Turbo, Base и Pro, цена за запрос, примеры и подключение поиска в чате.

Веб-поиск по API: возвращает результаты выдачи (заголовок, ссылка, сниппет) без скачивания содержимого страниц. Доступны POST /api/search и POST /v1/search.

POSThttps://plusvibeapi.ru/api/search

POSThttps://plusvibeapi.ru/v1/search

Параметры тела

Параметр	Тип	Описание
`query`обяз.	string	Поисковый запрос (до 1000 символов).
`num`	number	Сколько результатов вернуть, 1–20. По умолчанию 10.
`region`	"ru" \| "global"	Регион выдачи. По умолчанию ru.

Для /v1/search используются поля max_results (1–20, по умолчанию 10), country, language и mode (turbo, base, pro).

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

curl https://plusvibeapi.ru/api/search \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "лучшие нейросети 2026",
    "num": 10,
    "region": "ru"
	  }'

Ответ

Только результаты: title, url, snippet. Поле cost_rub — сколько списано за запрос.

{
  "results": [
    { "title": "…", "url": "https://…", "snippet": "…" }
  ],
  "searched": 10,
  "cost_rub": 0.13
}

Цена Turbo — 0.13₽ за запрос и не зависит от num; режимы Base и Pro стоят дороже, фактическая сумма приходит в поле cost_rub. Лимит — 32 запроса в минуту на клиента и до 10 результатов для чат-поиска. Если поиск недоступен, ответ приходит с ok: false и списание не производится. Для чата поиск включается любым из трёх способов: plugins:[{id:"web"}] (принимаются опции max_results, search_prompt, engine), поле web_search_options из OpenAI Chat Completions, или суффикс :online — он ставится последним и работает поверх пина линии: claude-opus-5:cxc:online. Любая комбинация оплачивается как один поиск. Работает на /v1/chat/completions, /v1/messages и /v1/responses. Покупаем до 10 результатов (больший max_results обрезается до 10 — тариф поставщика включает именно этот объём). Рельс :free по-прежнему отклоняется. Нативные server-tools веб-поиска, которые агентские SDK (Codex, Claude Code) добавляют к каждому запросу (web_search, web_search_preview, web_search_20250305), принимаются, но игнорируются: инструмент удаляется из запроса к модели, запрос уходит без поиска и поиск не списывается. Чтобы искать, используйте :online, plugins:[{id:"web"}] или web_search_options. Поиск покупается не чаще одного раза на реплику пользователя: шаг агентского цикла, который возвращает результат инструмента, с web_search_options новый поиск не покупает. Тот же вопрос от того же клиента в течение 10 минут получает уже купленные результаты бесплатно, а служебные блоки агентов (<environment_context>, <system-reminder> и т. п.) в запрос поиска не попадают.

← ПредыдущийFiles API Следующий →Embeddings