Tavily Extract
Tavily
Tavily Extract
POST
Tavily Extract
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 Extract API with platform route prefixes applied.
Base URL example:
https://api.novita.ai
Extract web page content from one or more specified URLs.
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 | string[]
required
URL(s) to extract.
string
Query for snippet reranking.
integer
Max number of content snippets per source to return. Default is
3; range is 1 to 5. Available only when query is provided.string
Extraction mode. Common values include
basic and advanced. basic is set as the default value.boolean
Returns a list of images from the response URLs.
boolean
Include favicon URL from result.
string
Extracted Content Format. Common values include
markdown and text.float
URL extraction time limit in seconds. Range is
1.0 to 60.0. 10 for basic, 30 for advanced.Request Example
Response
object[]
Extracted results from URL(s). See Result Object.
object[]
Unprocessable URL(s). See Failed Result Object.
float
Request duration in seconds.
string
Unique request identifier.
Result Object
string
Response content URL.
string
Full page content.
string[]
Image URLs from page URL. Returned if
include_images is true.string
Site favicon URL. Returned if
include_favicon is true.Failed Result Object
string
Unprocessed URL(s)
string
URL processing error message.
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. May occur if over 20 URLs are provided.
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 Extract API reference.Last modified on June 23, 2026