Tavily / Search the web

Request parameters

• auto_parameters body · optional

  When `auto_parameters` is enabled, Tavily automatically configures search parameters based on your query's content and intent. You can still set other parameters manually, and your explicit values will override the automatic ones. The parameters `include_answer`, `include_raw_content`, and `max_results` must always be set manually, as they directly affect response size. Note: `search_depth` may be automatically set to advanced when it's likely to improve results. This uses 2 API credits per r...

• chunks_per_source body · optional

  Chunks are short content snippets (maximum 500 characters each) pulled directly from the source. Use `chunks_per_source` to define the maximum number of relevant chunks returned per source and to control the `content` length. Chunks will appear in the `content` field as: `<chunk 1> [...] <chunk 2> [...] <chunk 3>`. Available when `search_depth` is `advanced`, `basic` or `fast`.

• country body · optional

  Boost search results from a specific country. This will prioritize content from the selected country in the search results. Available only if topic is `general`.

• end_date body · optional

  Will return all results before the specified end date based on publish date or last updated date. Required to be written in the format YYYY-MM-DD. Example: "2025-12-29"

• exact_match body · optional

  Ensure that only search results containing the exact quoted phrase(s) in the query are returned, bypassing synonyms or semantic variations. Wrap target phrases in quotes within your query (e.g. `"John Smith" CEO Acme Corp`). Punctuation is typically ignored inside quotes.

• exclude_domains body · optional

  A list of domains to specifically exclude from the search results. Maximum 150 domains.

• filter_by_language body · optional

  Strictly filter out search results that don't match the `language` parameter, instead of only boosting them in ranking. Requires `language` to be set; returns a 400 error otherwise.

• include_answer body · optional

  Include an LLM-generated answer to the provided query. `basic` or `true` returns a quick answer. `advanced` returns a more detailed answer.

• include_domains body · optional

  A list of domains to specifically include in the search results. Maximum 300 domains.

• include_domains_mode body · optional

  Controls how `include_domains` is applied. `filter` restricts results to only the listed domains. `boost` also searches the rest of the web, so results outside `include_domains` can still surface, rather than excluding them. Requires `include_domains` to be set; returns a 400 error otherwise.

• include_favicon body · optional

  Whether to include the favicon URL for each result.

• include_image_descriptions body · optional

  When `include_images` is `true`, also add a descriptive text for each image.

• include_images body · optional

  Include images in the response. Returns both a top-level `images` list of query-related images and an `images` array inside each result object with images extracted from that specific source.

• include_raw_content body · optional

  Include the cleaned and parsed HTML content of each search result. `markdown` or `true` returns search result content in markdown format. `text` returns the plain text from the results and may increase latency.

• include_usage body · optional

  Whether to include credit usage information in the response.

• language body · optional

  Boost search results in a specific language. Accepts an ISO 639-1 code (e.g. `en`, `fr`, `zh-cn`) or an English language name (e.g. `english`, `french`). By default this only boosts matching-language results in ranking; pass `filter_by_language: true` to strictly filter out non-matching results instead. For best results, write your `query` in the same language you set here. Example: "en"

• max_results body · optional

  The maximum number of search results to return. Example: 1

• query body · required

  The search query to execute with Tavily. Example: "who is Leo Messi?"

• safe_search body · optional

  Whether to filter out adult or unsafe content from results. Not supported for `fast` or `ultra-fast` search depths.

• search_depth body · optional

  Controls the latency vs. relevance tradeoff and how `results[].content` is generated: - `advanced`: Highest relevance with increased latency. Best for detailed, high-precision queries. Returns multiple semantically relevant snippets per URL (configurable via `chunks_per_source`). - `basic`: A balanced option for relevance and latency. Ideal for general-purpose searches. Returns multiple semantically relevant snippets per URL (configurable via `chunks_per_source`). - `fast`: Prioritizes lower...

• start_date body · optional

  Will return all results after the specified start date based on publish date or last updated date. Required to be written in the format YYYY-MM-DD. Example: "2025-02-09"

• time_range body · optional

  The time range back from the current date to filter results based on publish date or last updated date. Useful when looking for sources that have published or updated data.

• topic body · optional

  The category of the search.`news` is useful for retrieving real-time updates, particularly about politics, sports, and major current events covered by mainstream media sources. `general` is for broader, more general-purpose searches that may include a wide range of sources.