Веб-поиск

POST /api/search и POST /v1/search — веб-поиск по API. Turbo стоит 0.13₽ за запрос: $0.001 себестоимость при курсе 88₽/$ и марже 30%. Примеры и plugin для чата.

Веб-поиск по 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₽ за запрос: себестоимость Parallel $0.001 при курсе 88₽/$, делённая на 1 − 0.30. Цена не зависит от num; Base/Pro рассчитываются от своей оценки провайдера. Лимит — 10 запросов в минуту на клиента и до 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 (web_search, web_search_preview, web_search_20250305) конвертируются в этот же поиск: инструмент удаляется из запроса к модели, ответ получает найденные URL, а списывается один поиск. Нативные блоки web_search_call и web_search_tool_result не синтезируются.

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