Skip to main content
POST
Tavily Search
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.
string
required
Use application/json.
string
required
Platform API key, formatted as Bearer <api_key>.

Request Body

string
required
Search query. Minimum length is 1.
string[]
Search mode. Common values include advanced, basic, fast, ultra-fast. basic is set as the default value.
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.
integer
Max number of results to return. Default is 5; supported public range is 1 to 20.
string[]
Data category hint. Known values include news, general, and finance.
string[]
Include links published or updated from the time range to now. Common values include day,d, week, w, month, m, year, and y.
string
Include links published after this YYYY-MM-DD date-time.
string
Include links published before this YYYY-MM-DD date-time.
boolean | string[]
Returns an LLM-generated answer. basic and true returns quick answers; advanced returns detailed answers.
boolean | string[]
Returns result in HTML content. markdown or true returns in markdown; text returns in plain text.
boolean
Returns a list of images along with the response.
boolean
Includes a description to each image. Only works when include_images is true.
boolean
Include favicon URL from result.
string[]
Restrict results to these domains. Maximum 300 domains.
string[]
Exclude results from these domains. Maximum 150 domains.
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.
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.
boolean
Returns results containing the exact quoted phrase(s) from the query. Punctuation is ignored.

Request Example

Response

string
Executed search query.
string
LLM-generated answer only when include_answeris requested.
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.
object[]
Search results.
float
Request duration in seconds.
object
Dictionary of automatically set parameters. Included if auto_parameters is true.
string
Unique request identifier.

Images Output Object

string
Image URL.
string
Image Description.

Result Object

string
Result title.
string
Result URL.
string
Result short snippet.
float
Result relevance score.
string
Result HTML content. Returned if include_raw_content is true.
string
Site favicon URL.
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.
status
Invalid request body or unsupported parameter value.
status
Missing or invalid API key.
status
Access denied by platform or upstream provider.
status
Route or requested resource not found.
status
Rate limit exceeded.
status
Internal server error.
status
Upstream provider error.
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