Skip to main content
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