Skip to main content
POST
https://api.aisa.one/apis/v1
/
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",
  "start_date": "2025-02-09",
  "end_date": "2025-12-29",
  "include_answer": false,
  "include_raw_content": false,
  "include_images": false,
  "include_image_descriptions": false,
  "safe_search": false,
  "include_favicon": false,
  "include_domains": [
    "<string>"
  ],
  "exclude_domains": [
    "<string>"
  ],
  "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>",
      "raw_content": "<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. advanced gives the highest relevance with higher latency and cost; basic is balanced; fast and ultra-fast optimize for lower latency.

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
default:false

Include an LLM-generated answer. true uses the default answer mode; basic or advanced selects the answer generation mode.

​
include_raw_content
default:false

Include cleaned and parsed content for each search result. true or markdown returns markdown; text returns plain text and may increase latency.

​
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.

​
safe_search
boolean
default:false

Filter out adult or unsafe content from search results. Enterprise only; not supported when search_depth is fast or ultra-fast.

​
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 only when topic is general.

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 | null

A short LLM-generated answer. Present as null when include_answer is false or no answer is generated.

​
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.