Retrieve a search
Returns the retained search resource exactly as it was returned by POST /search: results, attempts, warnings, usage, and expires_at. No provider is called and nothing is billed. Use it to look up a search by ID for debugging, cost review, or to recover result IDs before calling the contents endpoint. Inline content fetched at search time is included; content fetched later through the contents endpoint is not merged in. Missing, expired, or inaccessible searches return 404.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Search resource ID returned by POST /search.
Response
The retained search.
Retained search results and provider attempt history.
Expiration of result IDs for deferred retrieval. Results expire 24 hours after search completion.
Search resource ID. Request tracing uses X-Request-Id.
"srch_abc123"
Concrete serving provider, never auto or fallback.
Echo of the query. Native multi-query inputs are visible in the selected strategy target and the optional raw response.
Provider-generated answer when requested (e.g. via Tavily include_answer or Perplexity). Preserved independently of include_raw.
Full serving-provider response, including top-level metadata that does not belong to a result. Present only with include_raw=true; untrusted provider data.