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.Use
application/json.Platform API key, formatted as
Bearer <api_key>.Request Body
URL(s) to extract.
Query for snippet reranking.
Max number of content snippets per source to return. Default is
3; range is 1 to 5. Available only when query is provided.Extraction mode. Common values include
basic and advanced. basic is set as the default value.Returns a list of images from the response URLs.
Include favicon URL from result.
Extracted Content Format. Common values include
markdown and text.URL extraction time limit in seconds. Range is
1.0 to 60.0. 10 for basic, 30 for advanced.Request Example
Response
Extracted results from URL(s). See Result Object.
Unprocessable URL(s). See Failed Result Object.
Request duration in seconds.
Unique request identifier.
Result Object
Response content URL.
Full page content.
Image URLs from page URL. Returned if
include_images is true.Site favicon URL. Returned if
include_favicon is true.Failed Result Object
Unprocessed URL(s)
URL processing error message.
Errors
The platform may return standard HTTP errors before forwarding the request, and Tavily may return upstream errors after forwarding.Invalid request body or unsupported parameter value. May occur if over 20 URLs are provided.
Missing or invalid API key.
Access denied by platform or upstream provider.
Route or requested resource not found.
Rate limit exceeded.
Internal server error.
Upstream provider error.
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