Billing note Billed per successfully extracted URL: 3.72 credits (basic) or 7.44 (advanced), rounded up per request. The full URL count is reserved, failed URLs are refunded, and a request whose URLs all fail is billed one URL.

TavilyFastHigh

Tavily Extract

Extract clean, LLM-ready content (markdown or text) from up to 20 web pages in one call, optionally reranked to a query. Billed per successfully extracted URL - about 4 credits per URL (basic), failed URLs are refunded.

4 credits

per extracted URL (3.72/URL basic, 7.44 advanced; failed URLs refunded)

Up to 20 URLs per request, processed together

Clean main content as markdown or plain text

Optional query reranks the extracted chunks by relevance

advanced depth extracts tables and embedded content

Per-URL failures reported in failed_results and not billed

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/extract",
  "input": {
    "urls": [
      "https://docs.tavily.com/documentation/api-credits"
    ],
    "extract_depth": "basic",
    "format": "markdown"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`urls`	array	Yes	-	Web page URLs to extract (1-20).
`query`	string	No	-	Optional intent to rerank the extracted chunks by relevance. With a query, raw_content holds the top chunks joined by [...].
`chunks_per_source`	integer	No	-	Chunks per URL when query is set (1-5, default 3).
`extract_depth`	string	No	basic	advanced also extracts tables and embedded content and succeeds on more pages, at 2x price and higher latency. basicadvanced
`format`	string	No	markdown	Format of raw_content. markdowntext
`include_images`	boolean	No	false	Add the image URLs found on each page.
`include_favicon`	boolean	No	false	Add each page's favicon URL.
`timeout`	number	No	-	Per-request timeout in seconds (1-60). Default 10s for basic, 30s for advanced.

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

Extract a page as markdown

Returns the main content of one page.

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/extract",
  "input": {
    "urls": [
      "https://docs.tavily.com/documentation/api-credits"
    ],
    "extract_depth": "basic",
    "format": "markdown"
  }
}'

Rerank several pages to a question

Top 3 chunks per page that answer the query.

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/extract",
  "input": {
    "urls": [
      "https://en.wikipedia.org/wiki/Retrieval-augmented_generation",
      "https://en.wikipedia.org/wiki/Large_language_model"
    ],
    "query": "how does retrieval reduce hallucination",
    "chunks_per_source": 3
  }
}'