POST

/v1/web-search

Справочник API

Поиск в интернете через API: возвращает список найденных страниц. Удобно, чтобы подложить свежие данные в промпт модели.

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

bash

curl https://api.zukko.pro/v1/web-search \
  -H "Authorization: Bearer fetch_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"latest AI news","max_results":5}'

2Параметры

Параметр	Тип	Описание
`query`	string	поисковый запрос, обязателен
`max_results`	int	сколько результатов вернуть: от 1 до 10, по умолчанию 5. Значения вне диапазона приводятся к границе

3Ответ

json

{
  "results": [
    {
      "title": "...",
      "url": "https://...",
      "snippet": "..."
    }
  ]
}

Отдельные поля результата могут отсутствовать.

4Стоимость и требования

Поиск оплачивается как небольшой расход токенов: оцениваются запрос и текст результатов, цена — $0.30 за 1M токенов. В истории списаний строка называется web-search.
Нужны подтверждённый email и баланс не меньше $0.01. Дневной и месячный лимиты ключа действуют, список разрешённых моделей — нет.
Кэш Zukko и Idempotency-Key к поиску не применяются.

5Ошибки

400 invalid_json — тело не JSON;
400 invalid_request — нет query;
401 — неверный ключ;
402 insufficient_balance — на балансе меньше $0.01;
403 email_unverified — email не подтверждён;
429 key_daily_limit_reached / key_monthly_limit_reached — исчерпан лимит ключа;
503 provider_unavailable — поиск временно недоступен;
502 web_search_failed или upstream_error — поиск не выполнился, повторите позже.

POST /v1/responses

GET /api/status