Skip to main content
POST
/
tavily
/
search
Execute a search query using Tavily Search.
curl --request POST \
  --url https://api.aisa.one/apis/v1/tavily/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "Who is Leo Messi?",
  "search_depth": "basic",
  "chunks_per_source": 3,
  "max_results": 5,
  "topic": "general",
  "time_range": "day",
  "start_date": "2025-02-09",
  "end_date": "2025-12-29",
  "include_answer": false,
  "include_raw_content": false,
  "include_images": false,
  "include_image_descriptions": false,
  "include_favicon": false,
  "include_domains": [
    "<string>"
  ],
  "exclude_domains": [
    "<string>"
  ],
  "country": "afghanistan",
  "auto_parameters": false,
  "include_usage": false
}
'
{
  "query": "<string>",
  "answer": "<string>",
  "images": [
    {
      "url": "<string>",
      "description": "<string>"
    }
  ],
  "results": [
    {
      "title": "<string>",
      "url": "<string>",
      "content": "<string>",
      "score": 123,
      "favicon": "<string>"
    }
  ],
  "response_time": 123,
  "usage": {
    "credits": 123
  },
  "request_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
query
string
required

The search query to execute with Tavily.

Example:

"Who is Leo Messi?"

​
search_depth
enum<string>
default:basic

Controls the latency vs. relevance tradeoff.

Available options:
advanced,
basic,
fast,
ultra-fast
​
chunks_per_source
integer
default:3

Maximum number of relevant chunks returned per source.

Required range: 1 <= x <= 3
​
max_results
integer
default:5

Maximum number of search results to return.

Required range: 0 <= x <= 20
​
topic
enum<string>
default:general

Category of the search.

Available options:
general,
news,
finance
​
time_range
enum<string>

Time range to filter results based on publish date.

Available options:
day,
week,
month,
year,
d,
w,
m,
y
​
start_date
string<date>

Return results after the specified start date.

Example:

"2025-02-09"

​
end_date
string<date>

Return results before the specified end date.

Example:

"2025-12-29"

​
include_answer
boolean
default:false

Include an LLM-generated answer to the query.

​
include_raw_content
boolean
default:false

Include cleaned and parsed HTML content of each search result.

​
include_images
boolean
default:false

Perform an image search and include results.

​
include_image_descriptions
boolean
default:false

Add descriptive text for each image when include_images is true.

​
include_favicon
boolean
default:false

Include the favicon URL for each result.

​
include_domains
string[]

List of domains to specifically include in the search results.

Maximum array length: 300
​
exclude_domains
string[]

List of domains to specifically exclude from the search results.

Maximum array length: 150
​
country
enum<string>

Boost search results from a specific country.

Available options:
afghanistan,
albania,
algeria,
andorra,
angola,
argentina,
armenia,
australia,
austria,
azerbaijan,
bahamas,
bahrain,
bangladesh,
barbados,
belarus,
belgium,
belize,
benin,
bhutan,
bolivia,
bosnia and herzegovina,
botswana,
brazil,
brunei,
bulgaria,
burkina faso,
burundi,
cambodia,
cameroon,
canada,
cape verde,
central african republic,
chad,
chile,
china,
colombia,
comoros,
congo,
costa rica,
croatia,
cuba,
cyprus,
czech republic,
denmark,
djibouti,
dominican republic,
ecuador,
egypt,
el salvador,
equatorial guinea,
eritrea,
estonia,
ethiopia,
fiji,
finland,
france,
gabon,
gambia,
georgia,
germany,
ghana,
greece,
guatemala,
guinea,
haiti,
honduras,
hungary,
iceland,
india,
indonesia,
iran,
iraq,
ireland,
israel,
italy,
jamaica,
japan,
jordan,
kazakhstan,
kenya,
kuwait,
kyrgyzstan,
latvia,
lebanon,
lesotho,
liberia,
libya,
liechtenstein,
lithuania,
luxembourg,
madagascar,
malawi,
malaysia,
maldives,
mali,
malta,
mauritania,
mauritius,
mexico,
moldova,
monaco,
mongolia,
montenegro,
morocco,
mozambique,
myanmar,
namibia,
nepal,
netherlands,
new zealand,
nicaragua,
niger,
nigeria,
north korea,
north macedonia,
norway,
oman,
pakistan,
panama,
papua new guinea,
paraguay,
peru,
philippines,
poland,
portugal,
qatar,
romania,
russia,
rwanda,
saudi arabia,
senegal,
serbia,
singapore,
slovakia,
slovenia,
somalia,
south africa,
south korea,
south sudan,
spain,
sri lanka,
sudan,
sweden,
switzerland,
syria,
taiwan,
tajikistan,
tanzania,
thailand,
togo,
trinidad and tobago,
tunisia,
turkey,
turkmenistan,
uganda,
ukraine,
united arab emirates,
united kingdom,
united states,
uruguay,
uzbekistan,
venezuela,
vietnam,
yemen,
zambia,
zimbabwe
​
auto_parameters
boolean
default:false

Automatically configure search parameters based on query content.

​
include_usage
boolean
default:false

Include credit usage information in the response.

Response

200 - application/json

Search results returned successfully.

​
query
string

The search query that was executed.

​
answer
string

A short answer to the user's query, generated by an LLM.

​
images
object[]
​
results
object[]
​
response_time
number<float>

Time in seconds it took to complete the request.

​
usage
object
​
request_id
string

Unique request identifier.