API reference
Every public endpoint, with full parameter and response detail.
Generated straight from the OpenAPI spec: every request parameter, response field, and status code for each endpoint. For a narrative walkthrough instead, start at Get started or Which search endpoint?.
Search documents
The core endpoint: run a search and get billed, ranked results back.
Search a single collection by name
Shorthand for search with the collection named in the path instead of the body.
Preview search results without charging
Same pipeline as search, free, returns teaser rows and an estimated cost.
Pay for previewed results and receive them in full
Pays for and returns some or all of a preview call's results.
Assisted search (verified results only)
Agentic retrieval: plans its own searches, verifies every candidate.
List collections
Every collection your key can search, at no cost.
Re-fetch cached results
Retrieve a prior search's results again for free within 7 days.
Current quota usage and limits
Daily and monthly query usage against your organization's limits.
Errors
Every status code, what causes it, and how to fix it.
Re-fetch cached results GET
Retrieve previously returned search results using the queryId from a prior search response. Returns the same results without billing. The request must use the same API key that performed the original search. Results are available for 7 days. Each result carries `locked`/`tokens`/`cost`: a result not yet paid for through POST /api/v1/search/unlock comes back as a teaser (`locked: true`), never the full text.