Authorizations
Bearer authentication header in the form Bearer <token>, where <token> is your Tavily API key (e.g., Bearer tvly-YOUR_API_KEY).
Body
Parameters for the Tavily Extract request.
The URL to extract content from.
"https://en.wikipedia.org/wiki/Artificial_intelligence"
Include a list of images extracted from the URLs in the response. Default is false.
Whether to include the favicon URL for each result.
The depth of the extraction process. advanced
extraction retrieves more data, including tables and embedded content, with higher success but may increase latency.basic
extraction costs 1 credit per 5 successful URL extractions, while advanced
extraction costs 2 credits per 5 successful URL extractions.
basic
, advanced
The format of the extracted web page content. markdown
returns content in markdown format. text
returns plain text and may increase latency.
markdown
, text
Maximum time in seconds to wait for the URL extraction before timing out. Must be between 1.0 and 60.0 seconds. If not specified, default timeouts are applied based on extract_depth: 10 seconds for basic extraction and 30 seconds for advanced extraction.
1 <= x <= 60
Response
Extraction results returned successfully
A list of extracted content from the provided URLs.
A list of URLs that could not be processed.
[]
Time in seconds it took to complete the request.
0.02
A unique request identifier you can share with customer support to help resolve issues with specific requests.
"123e4567-e89b-12d3-a456-426614174111"