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

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

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

Поля запроса

Какие адреса принимаются

  • Схема адреса — http или https. Другие схемы отклоняются.
  • Адрес должен быть абсолютным и содержать хост.
  • Логин и пароль в адресе не допускаются.
  • Адрес не должен вести во внутреннюю сеть: приватный диапазон, loopback и link-local отклоняются с 403 url_not_allowed.
Публичный адрес по http допускается.
Внутренние адреса отклоняются всегда, в том числе 127.0.0.1 и localhost. Через эндпоинт нельзя достать до внутренних адресов платформы.

Ответ

200 OK:
Текст приходит в Markdown: заголовки, списки и таблицы сохраняются. Если у страницы нет пригодного содержимого, придёт 404 not_found.

Стоимость

Стоимость зависит от объёма загрузки. Поле 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
url
string
обязательно

Адрес страницы. Обязательно; до 8192 символов. Схема — http или https, хост обязателен, логин и пароль в адресе не допускаются.

Maximum string length: 8192

Ответ

Заголовок и текст страницы.

title
string
обязательно

Заголовок страницы.

content
string
обязательно

Текст страницы в Markdown.

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

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