Skip to main content
GET /api/search is the core of the product. It accepts unsigned callers, browser sessions, Settings API keys, and agent access tokens.
Try it live in the API playground.

​
Parameters

Unknown parameters or bad values answer 400 with the issues named.

​
Identity

Send a credential when you have one:
Authorization: Bearer <access_token> works the same. Get a token at Authentication.

​
Limits and spend

  • Unsigned callers get 50 free searches per UTC day per IP, plus a small per-minute burst. Past the cap: 429 with an authUrl.
  • Claimed accounts, sessions, and Settings API keys get 100 free searches per UTC day when the prepaid balance is empty.
  • Pre-claim agent tokens have no free grant. Their searches spend prepaid credits only, and answer 402 when the balance is empty.
  • Each identified search spends one credit ($0.05) from a non-empty prepaid balance.

​
When search answers 402

A 402 means the caller is identified and out of credits. The response carries a WWW-Authenticate: Payment challenge (Machine Payments Protocol) so an agent can settle without a human, plus a packsUrl for humans. See Credits and payments for the full paid rail, receipts, and failure modes.