Billing note Billed per search: 19 credits for basic/fast/ultra-fast, 38 for advanced. With auto_parameters=true, 38 credits are reserved (Tavily may pick advanced) and the difference is refunded when Tavily reports it used a basic search.

TavilyFastHigh

Tavily Search

Real-time web search built for LLMs and agents - returns ranked results with relevant content snippets, an optional LLM-generated answer, raw page content, images and domain/date filters. 19 credits per basic search, 38 per advanced search.

19 credits

per search (basic/fast/ultra-fast; 38 for advanced)

Results ranked for LLM grounding, with relevant content chunks per source

Optional LLM-generated answer (basic or advanced)

Full page content as markdown or text with include_raw_content

general / news / finance topics, time range and date filters

Include or exclude domains, country and language boosting

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "tavily/search",
  "input": {
    "query": "latest AI video generation models 2026",
    "search_depth": "basic",
    "max_results": 5,
    "include_answer": "basic"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`query`	string	Yes	-	The search query. Write it in the language you want results in.
`search_depth`	string	No	basic	basic is a balanced generic search; advanced returns the most relevant content chunks at higher latency (2x price); fast and ultra-fast trade relevance for latency. basicadvancedfastultra-fast
`topic`	string	No	general	Search category. news returns recent articles with published dates. generalnewsfinance
`max_results`	integer	No	-	Maximum number of results (0-20). Omit for Tavily's default.
`chunks_per_source`	integer	No	-	Maximum relevant content chunks per source (1-3, default 3). Applies to basic, advanced and fast.
`time_range`	string	No	-	Only results published or updated within this window. dayweekmonthyear
`start_date`	string	No	-	Only results published or updated after this date (YYYY-MM-DD).
`end_date`	string	No	-	Only results published or updated before this date (YYYY-MM-DD).
`include_answer`	string	No	-	Add an LLM-generated answer to the query. advanced is more detailed. Omit for no answer. basicadvanced
`include_raw_content`	string	No	-	Add the cleaned full page content of each result in this format. Omit for snippets only. markdowntext
`include_images`	boolean	No	false	Add query-related images and per-result images.
`include_image_descriptions`	boolean	No	false	Add a text description to each image (needs include_images).
`include_favicon`	boolean	No	false	Add each result's favicon URL.
`include_published_date`	boolean	No	false	Add published_date to each result (always on for topic=news).
`include_domains`	array	No	-	Only return results from these domains (e.g. ["core.today"]). Up to 300.
`exclude_domains`	array	No	-	Never return results from these domains. Up to 150.
`country`	string	No	-	Boost results from a country, as a lowercase English name (e.g. south korea, united states). topic=general only.
`language`	string	No	-	Boost results in a language - ISO 639-1 code or English name (e.g. ko, en).
`auto_parameters`	boolean	No	false	Let Tavily pick parameters from the query intent (explicit values still win). May switch to advanced search - reserved at the advanced price and settled on the credits Tavily actually charged.
`exact_match`	boolean	No	false	Only results containing the quoted phrases in the query.
`safe_search`	boolean	No	false	Filter adult or unsafe content. Not supported for fast or ultra-fast.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Search with an answer

Five results plus a short LLM-generated answer.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "tavily/search",
  "input": {
    "query": "latest AI video generation models 2026",
    "search_depth": "basic",
    "max_results": 5,
    "include_answer": "basic"
  }
}'

Recent news from Korean sources

News from the past week, boosted toward Korea and Korean.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "tavily/search",
  "input": {
    "query": "생성형 AI 규제",
    "topic": "news",
    "time_range": "week",
    "language": "ko",
    "max_results": 10
  }
}'

Deep search on chosen domains

advanced search limited to two domains, with full page content as markdown.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "tavily/search",
  "input": {
    "query": "Seedance 2.5 reference to video pricing",
    "search_depth": "advanced",
    "include_domains": [
      "core.today",
      "byteplus.com"
    ],
    "include_raw_content": "markdown"
  }
}'