Перейти к основному содержанию
POST
Поиск в интернете
Эндпоинт ищет страницы в интернете по текстовому запросу и возвращает список результатов: заголовок, ссылку, выдержку из страницы и, по запросу, полный текст. Типичное применение — второй этап ответа: модель уточняет факты по свежим источникам, а вы передаёте ей найденные страницы. Модель для вызова не нужна. Запрос уходит на поисковую выдачу, а результаты приходят в том порядке, который задала выдача.

Минимальный запрос

cURL
Ключ передаётся заголовком Authorization: Bearer sk-.... Он создаётся в личном кабинете и показывается один раз — подробности на странице Аутентификация.

Поля запроса

Длины считаются в символах, а не в байтах: кириллический запрос из 100 символов занимает 200 байт и проходит проверку.
Поле count необязательное, но значение 0 — ошибка: явный ноль не равен отсутствующему полю. Чтобы получить 10 результатов, не передавайте count вовсе.

Ответ

200 OK:
Дата приходит строкой в том виде, в каком её отдала выдача, и может быть null. Не разбирайте её как дату ISO без проверки формата.

Стоимость

Стоимость вызова зависит от фактической работы поиска. Поле usage.cost — сумма, списанная с вашего баланса; оно отсутствует, если списание не зафиксировано. Поиск, который не нашёл ни одной страницы, не тарифицируется: в этом случае поле usage.cost не приходит. Фактический остаток после вызова проверяйте через GET /api/v1/balance.

Проверки перед вызовом

Ошибки приходят в конверте OpenAI — объект error с полями message, type, param и code. Полная таблица кодов — на странице Ошибки.

Что дальше

Загрузка страницы

Текст найденной страницы по ссылке

Ранжирование

Второй этап отбора документов

Баланс

Остаток кошелька по валютам

Ошибки

Полная таблица кодов

Авторизации

Authorization
string
header
обязательно

API-ключ в формате sk-.... Альтернативно — заголовок X-Api-Key: sk-... (совместимо с Anthropic SDK).

Тело

application/json
query
string
обязательно

Поисковый запрос. Обязательно; от 1 до 128 символов. Запрос из одних пробелов не принимается.

Required string length: 1 - 128
count
integer
по умолчанию:10

Сколько результатов вернуть. Необязательно; по умолчанию 10. Значение 0 отклоняется.

Требуемый диапазон: 1 <= x <= 50
ori_question
string

Исходный вопрос пользователя, которому служит поиск. Необязательно.

Maximum string length: 128
localization
string

Подсказка по языку и региону выдачи. Необязательно.

need_content
boolean
по умолчанию:false

Возвращать ли текст страницы целиком. По умолчанию false.

Ответ

Найденные страницы.

results
object[]
обязательно

Найденные страницы. Пустой массив — успешный ответ, а не ошибка.

usage
object
обязательно

Расход по вызову. Объект есть всегда, в каждом ответе.