Tavily Search

curl --request POST \
  --url https://api.novita.ai/v3/tavily/search \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "query": "<string>",
  "search_depth": [
    "<string>"
  ],
  "chunks_per_source": 123,
  "max_results": 123,
  "topic": [
    "<string>"
  ],
  "time_range": [
    "<string>"
  ],
  "start_date": "<string>",
  "end_date": "<string>",
  "include_answer": [
    {}
  ],
  "include_raw_content": [
    {}
  ],
  "include_images": {},
  "include_images_descriptions": {},
  "include_favicon": {},
  "include_domains": {},
  "exclude_domains": {},
  "country": [
    "<string>"
  ],
  "auto_parameters": true,
  "exact_match": true
}
'

import requests

url = "https://api.novita.ai/v3/tavily/search"

payload = {
    "query": "<string>",
    "search_depth": ["<string>"],
    "chunks_per_source": 123,
    "max_results": 123,
    "topic": ["<string>"],
    "time_range": ["<string>"],
    "start_date": "<string>",
    "end_date": "<string>",
    "include_answer": [{}],
    "include_raw_content": [{}],
    "include_images": {},
    "include_images_descriptions": {},
    "include_favicon": {},
    "include_domains": {},
    "exclude_domains": {},
    "country": ["<string>"],
    "auto_parameters": True,
    "exact_match": True
}
headers = {
    "Content-Type": "<content-type>",
    "Authorization": "<authorization>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>', Authorization: '<authorization>'},
  body: JSON.stringify({
    query: '<string>',
    search_depth: ['<string>'],
    chunks_per_source: 123,
    max_results: 123,
    topic: ['<string>'],
    time_range: ['<string>'],
    start_date: '<string>',
    end_date: '<string>',
    include_answer: [{}],
    include_raw_content: [{}],
    include_images: {},
    include_images_descriptions: {},
    include_favicon: {},
    include_domains: {},
    exclude_domains: {},
    country: ['<string>'],
    auto_parameters: true,
    exact_match: true
  })
};

fetch('https://api.novita.ai/v3/tavily/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.novita.ai/v3/tavily/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'search_depth' => [
        '<string>'
    ],
    'chunks_per_source' => 123,
    'max_results' => 123,
    'topic' => [
        '<string>'
    ],
    'time_range' => [
        '<string>'
    ],
    'start_date' => '<string>',
    'end_date' => '<string>',
    'include_answer' => [
        [
                
        ]
    ],
    'include_raw_content' => [
        [
                
        ]
    ],
    'include_images' => [
        
    ],
    'include_images_descriptions' => [
        
    ],
    'include_favicon' => [
        
    ],
    'include_domains' => [
        
    ],
    'exclude_domains' => [
        
    ],
    'country' => [
        '<string>'
    ],
    'auto_parameters' => true,
    'exact_match' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.novita.ai/v3/tavily/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"search_depth\": [\n    \"<string>\"\n  ],\n  \"chunks_per_source\": 123,\n  \"max_results\": 123,\n  \"topic\": [\n    \"<string>\"\n  ],\n  \"time_range\": [\n    \"<string>\"\n  ],\n  \"start_date\": \"<string>\",\n  \"end_date\": \"<string>\",\n  \"include_answer\": [\n    {}\n  ],\n  \"include_raw_content\": [\n    {}\n  ],\n  \"include_images\": {},\n  \"include_images_descriptions\": {},\n  \"include_favicon\": {},\n  \"include_domains\": {},\n  \"exclude_domains\": {},\n  \"country\": [\n    \"<string>\"\n  ],\n  \"auto_parameters\": true,\n  \"exact_match\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.novita.ai/v3/tavily/search")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "<authorization>")
  .body("{\n  \"query\": \"<string>\",\n  \"search_depth\": [\n    \"<string>\"\n  ],\n  \"chunks_per_source\": 123,\n  \"max_results\": 123,\n  \"topic\": [\n    \"<string>\"\n  ],\n  \"time_range\": [\n    \"<string>\"\n  ],\n  \"start_date\": \"<string>\",\n  \"end_date\": \"<string>\",\n  \"include_answer\": [\n    {}\n  ],\n  \"include_raw_content\": [\n    {}\n  ],\n  \"include_images\": {},\n  \"include_images_descriptions\": {},\n  \"include_favicon\": {},\n  \"include_domains\": {},\n  \"exclude_domains\": {},\n  \"country\": [\n    \"<string>\"\n  ],\n  \"auto_parameters\": true,\n  \"exact_match\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.novita.ai/v3/tavily/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = '<authorization>'
request.body = "{\n  \"query\": \"<string>\",\n  \"search_depth\": [\n    \"<string>\"\n  ],\n  \"chunks_per_source\": 123,\n  \"max_results\": 123,\n  \"topic\": [\n    \"<string>\"\n  ],\n  \"time_range\": [\n    \"<string>\"\n  ],\n  \"start_date\": \"<string>\",\n  \"end_date\": \"<string>\",\n  \"include_answer\": [\n    {}\n  ],\n  \"include_raw_content\": [\n    {}\n  ],\n  \"include_images\": {},\n  \"include_images_descriptions\": {},\n  \"include_favicon\": {},\n  \"include_domains\": {},\n  \"exclude_domains\": {},\n  \"country\": [\n    \"<string>\"\n  ],\n  \"auto_parameters\": true,\n  \"exact_match\": true\n}"

response = http.request(request)
puts response.read_body

{
  "400": {},
  "401": {},
  "403": {},
  "404": {},
  "429": {},
  "500": {},
  "502": {},
  "503": {},
  "query": "<string>",
  "answer": "<string>",
  "images": [
    {}
  ],
  "results": [
    {}
  ],
  "response_time": 123,
  "auto_parameters": {},
  "request_id": "<string>",
  "url": "<string>",
  "description": "<string>",
  "title": "<string>",
  "content": "<string>",
  "score": 123,
  "raw_content": "<string>",
  "favicon": "<string>"
}

POST

tavily

Tavily Search

curl --request POST \
  --url https://api.novita.ai/v3/tavily/search \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "query": "<string>",
  "search_depth": [
    "<string>"
  ],
  "chunks_per_source": 123,
  "max_results": 123,
  "topic": [
    "<string>"
  ],
  "time_range": [
    "<string>"
  ],
  "start_date": "<string>",
  "end_date": "<string>",
  "include_answer": [
    {}
  ],
  "include_raw_content": [
    {}
  ],
  "include_images": {},
  "include_images_descriptions": {},
  "include_favicon": {},
  "include_domains": {},
  "exclude_domains": {},
  "country": [
    "<string>"
  ],
  "auto_parameters": true,
  "exact_match": true
}
'

import requests

url = "https://api.novita.ai/v3/tavily/search"

payload = {
    "query": "<string>",
    "search_depth": ["<string>"],
    "chunks_per_source": 123,
    "max_results": 123,
    "topic": ["<string>"],
    "time_range": ["<string>"],
    "start_date": "<string>",
    "end_date": "<string>",
    "include_answer": [{}],
    "include_raw_content": [{}],
    "include_images": {},
    "include_images_descriptions": {},
    "include_favicon": {},
    "include_domains": {},
    "exclude_domains": {},
    "country": ["<string>"],
    "auto_parameters": True,
    "exact_match": True
}
headers = {
    "Content-Type": "<content-type>",
    "Authorization": "<authorization>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>', Authorization: '<authorization>'},
  body: JSON.stringify({
    query: '<string>',
    search_depth: ['<string>'],
    chunks_per_source: 123,
    max_results: 123,
    topic: ['<string>'],
    time_range: ['<string>'],
    start_date: '<string>',
    end_date: '<string>',
    include_answer: [{}],
    include_raw_content: [{}],
    include_images: {},
    include_images_descriptions: {},
    include_favicon: {},
    include_domains: {},
    exclude_domains: {},
    country: ['<string>'],
    auto_parameters: true,
    exact_match: true
  })
};

fetch('https://api.novita.ai/v3/tavily/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.novita.ai/v3/tavily/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'search_depth' => [
        '<string>'
    ],
    'chunks_per_source' => 123,
    'max_results' => 123,
    'topic' => [
        '<string>'
    ],
    'time_range' => [
        '<string>'
    ],
    'start_date' => '<string>',
    'end_date' => '<string>',
    'include_answer' => [
        [
                
        ]
    ],
    'include_raw_content' => [
        [
                
        ]
    ],
    'include_images' => [
        
    ],
    'include_images_descriptions' => [
        
    ],
    'include_favicon' => [
        
    ],
    'include_domains' => [
        
    ],
    'exclude_domains' => [
        
    ],
    'country' => [
        '<string>'
    ],
    'auto_parameters' => true,
    'exact_match' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.novita.ai/v3/tavily/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"search_depth\": [\n    \"<string>\"\n  ],\n  \"chunks_per_source\": 123,\n  \"max_results\": 123,\n  \"topic\": [\n    \"<string>\"\n  ],\n  \"time_range\": [\n    \"<string>\"\n  ],\n  \"start_date\": \"<string>\",\n  \"end_date\": \"<string>\",\n  \"include_answer\": [\n    {}\n  ],\n  \"include_raw_content\": [\n    {}\n  ],\n  \"include_images\": {},\n  \"include_images_descriptions\": {},\n  \"include_favicon\": {},\n  \"include_domains\": {},\n  \"exclude_domains\": {},\n  \"country\": [\n    \"<string>\"\n  ],\n  \"auto_parameters\": true,\n  \"exact_match\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.novita.ai/v3/tavily/search")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "<authorization>")
  .body("{\n  \"query\": \"<string>\",\n  \"search_depth\": [\n    \"<string>\"\n  ],\n  \"chunks_per_source\": 123,\n  \"max_results\": 123,\n  \"topic\": [\n    \"<string>\"\n  ],\n  \"time_range\": [\n    \"<string>\"\n  ],\n  \"start_date\": \"<string>\",\n  \"end_date\": \"<string>\",\n  \"include_answer\": [\n    {}\n  ],\n  \"include_raw_content\": [\n    {}\n  ],\n  \"include_images\": {},\n  \"include_images_descriptions\": {},\n  \"include_favicon\": {},\n  \"include_domains\": {},\n  \"exclude_domains\": {},\n  \"country\": [\n    \"<string>\"\n  ],\n  \"auto_parameters\": true,\n  \"exact_match\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.novita.ai/v3/tavily/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = '<authorization>'
request.body = "{\n  \"query\": \"<string>\",\n  \"search_depth\": [\n    \"<string>\"\n  ],\n  \"chunks_per_source\": 123,\n  \"max_results\": 123,\n  \"topic\": [\n    \"<string>\"\n  ],\n  \"time_range\": [\n    \"<string>\"\n  ],\n  \"start_date\": \"<string>\",\n  \"end_date\": \"<string>\",\n  \"include_answer\": [\n    {}\n  ],\n  \"include_raw_content\": [\n    {}\n  ],\n  \"include_images\": {},\n  \"include_images_descriptions\": {},\n  \"include_favicon\": {},\n  \"include_domains\": {},\n  \"exclude_domains\": {},\n  \"country\": [\n    \"<string>\"\n  ],\n  \"auto_parameters\": true,\n  \"exact_match\": true\n}"

response = http.request(request)
puts response.read_body

{
  "400": {},
  "401": {},
  "403": {},
  "404": {},
  "429": {},
  "500": {},
  "502": {},
  "503": {},
  "query": "<string>",
  "answer": "<string>",
  "images": [
    {}
  ],
  "results": [
    {}
  ],
  "response_time": 123,
  "auto_parameters": {},
  "request_id": "<string>",
  "url": "<string>",
  "description": "<string>",
  "title": "<string>",
  "content": "<string>",
  "score": 123,
  "raw_content": "<string>",
  "favicon": "<string>"
}

Tavily is a web data retrieval API designed for developers and AI applications. This document describes the Tavily passthrough endpoints exposed by the platform gateway. It is based on Tavily’s Search API with platform route prefixes applied. Base URL example: https://api.novita.ai Search the internet by keyword or natural-language question and retrieve a list of matching results (title, URL, summary/snippet, etc.).

Request Headers

All endpoints require platform API authentication.

Content-Type

string

required

Use application/json.

Authorization

string

required

Platform API key, formatted as Bearer <api_key>.

Request Body

query

string

required

Search query. Minimum length is 1.

search_depth

string[]

Search mode. Common values include advanced, basic, fast, ultra-fast. basic is set as the default value.

chunks_per_source

integer

Max number of content snippets per source to return. Default is 3; range is 1 to 3. Available only when search_depth is advanced.

max_results

integer

Max number of results to return. Default is 5; supported public range is 1 to 20.

topic

string[]

Data category hint. Known values include news, general, and finance.

time_range

string[]

Include links published or updated from the time range to now. Common values include day,d, week, w, month, m, year, and y.

start_date

string

Include links published after this YYYY-MM-DD date-time.

end_date

string

Include links published before this YYYY-MM-DD date-time.

include_answer

boolean | string[]

Returns an LLM-generated answer. basic and true returns quick answers; advanced returns detailed answers.

include_raw_content

boolean | string[]

Returns result in HTML content. markdown or true returns in markdown; text returns in plain text.

include_images

boolean

Returns a list of images along with the response.

include_images_descriptions

boolean

Includes a description to each image. Only works when include_images is true.

include_favicon

boolean

Include favicon URL from result.

include_domains

string[]

Restrict results to these domains. Maximum 300 domains.

exclude_domains

string[]

Exclude results from these domains. Maximum 150 domains.

country

string[]

Prioritize results from specified country. Only works when topic is general. Known values include 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, south africa, south korea, south sudan, spain, sri lanka, sudan, sweden, slovakia, slovenia, somalia, south africa, south korea, south sudan, spain, sri lanka, sudan, sweden, switzerland, syria, taiwan, tajikista, tanzania, thailand, togo, trinidad and tobago, tunisia, turkey, turkmenistan, uganda, ukraine, united arab emirates, united kingdom, united states, uruguay, uzbekistan, venezuela, vietnam, yemen, zambia, and zimbabwe.

auto_parameters

boolean

Automatically sets parameters for search. include_answer, include_raw_content,and max_results must be set manually if needed. search_depth may be set to advanced if search_depth is not explicitly set.

exact_match

boolean

Returns results containing the exact quoted phrase(s) from the query. Punctuation is ignored.

Request Example

curl -s -X POST 'https://api.novita.ai/v3/tavily/search' \
  -H 'Authorization: Bearer sk-123' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Who is Leo Messi?",
    "auto_parameters": false,
    "topic": "general",
    "search_depth": "basic",
    "chunks_per_source": 3,
    "max_results": 5,
    "include_answer": false,
    "include_raw_content": false,
    "include_images": false
  }'

Response

query

string

Executed search query.

answer

string

LLM-generated answer only when include_answeris requested.

images

object[]

List of images from image search. Returned if include_images is true. Image url and description are included if include_image_description is true. See Images Output Object.

results

object[]

Search results.

response_time

float

Request duration in seconds.

auto_parameters

object

Dictionary of automatically set parameters. Included if auto_parameters is true.

request_id

string

Unique request identifier.

Images Output Object

url

string

Image URL.

description

string

Image Description.

Result Object

title

string

Result title.

url

string

Result URL.

content

string

Result short snippet.

score

float

Result relevance score.

raw_content

string

Result HTML content. Returned if include_raw_content is true.

favicon

string

Site favicon URL.

images

object[]

List of images from search results. Returned if include_images is true. Image url and description are included if include_image_description is true. See Images Output Object.

Errors

The platform may return standard HTTP errors before forwarding the request, and Tavily may return upstream errors after forwarding.

400

status

Invalid request body or unsupported parameter value.

401

status

Missing or invalid API key.

403

status

Access denied by platform or upstream provider.

404

status

Route or requested resource not found.

429

status

Rate limit exceeded.

500

status

Internal server error.

502

status

Upstream provider error.

503

status

Service unavailable.

Notes

All request bodies are JSON.
Extra Tavily parameters not listed here may be passed through.
Response shapes can vary depending on request options.
This document intentionally omits billing-related fields.

References

For more details, see the Tavily Search API reference.

Last modified on June 23, 2026

Exa Answer Tavily Extract

⌘I

​Request Headers

​Request Body

​Request Example

​Response

​Images Output Object

​Result Object

​Errors

​Notes

​References

Request Headers

Request Body

Request Example

Response

Images Output Object

Result Object

Errors

Notes

References