Skip to main content
GET
Retrieve a search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Search resource ID returned by POST /search.

Response

The retained search.

Retained search results and provider attempt history.

attempts
object[]
required
expires_at
string<date-time>
required

Expiration of result IDs for deferred retrieval. Results expire 24 hours after search completion.

id
string
required

Search resource ID. Request tracing uses X-Request-Id.

Example:

"srch_abc123"

provider
string
required

Concrete serving provider, never auto or fallback.

query
string
required

Echo of the query. Native multi-query inputs are visible in the selected strategy target and the optional raw response.

results
object[]
required
usage
object
required
warnings
object[]
required
answer
string

Provider-generated answer when requested (e.g. via Tavily include_answer or Perplexity). Preserved independently of include_raw.

raw
any

Full serving-provider response, including top-level metadata that does not belong to a result. Present only with include_raw=true; untrusted provider data.