Skip to main content
GET
Tavily Search
Beta catalog endpoint. Provider activation and live verification are in progress. An unavailable operation returns HTTP 503 and uses no credits.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string

Query Parameters

query
string
required
search_depth
enum<string>
Available options:
basic,
advanced,
fast,
ultra-fast
topic
enum<string>
Available options:
general,
news,
finance
time_range
enum<string>
Available options:
day,
week,
month,
year,
d,
w,
m,
y
max_results
integer
chunks_per_source
integer
include_images
boolean
include_image_descriptions
boolean
include_answer
boolean
include_raw_content
boolean
include_domains
string
exclude_domains
string
country
string
start_date
string
end_date
string

Response

Successful response. data is specific to this operation.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

Operation-specific data. Fields depend on the endpoint and upstream response; unavailable metrics may be null.