POST

/v1/web-search

API reference

Web search through the API: returns a list of found pages. Handy for feeding fresh data into a model prompt.

1Request example

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}'

2Parameters

Parameter	Type	Description
`query`	string	search query, required
`max_results`	int	how many results to return: 1 to 10, default 5. Out-of-range values are clamped

3Response

json

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

Individual result fields may be missing.

4Cost and requirements

Search is billed as a small token charge: the query and the result text are estimated at $0.30 per 1M tokens. In the charge history the line is called web-search.
Requires a verified email and a balance of at least $0.01. The key's daily and monthly limits apply; the allowed-models list does not.
The Zukko cache and Idempotency-Key do not apply to search.

5Errors

400 invalid_json — the body is not JSON;
400 invalid_request — no query;
401 — invalid key;
402 insufficient_balance — balance below $0.01;
403 email_unverified — email not verified;
429 key_daily_limit_reached / key_monthly_limit_reached — the key limit is used up;
503 provider_unavailable — search is temporarily unavailable;
502 web_search_failed or upstream_error — search failed, retry later.

POST /v1/responses

GET /api/status