> ## Documentation Index > Fetch the complete documentation index at: https://docs.tavily.com/llms.txt > Use this file to discover all available pages before exploring further. # Tavily Extract > Extract content from one URL or batch up to 20 URLs in one request. Successful URLs appear in results; per-URL failures appear in failed_results. Check both arrays even when the response is HTTP 200. Request options apply to every URL in the batch. ## OpenAPI ````yaml POST /extract openapi: 3.0.3 info: title: Tavily Search and Extract API description: >- Our REST API provides seamless access to Tavily Search, a powerful search engine for LLM agents, and Tavily Extract, an advanced web scraping solution optimized for LLMs. version: 1.0.0 servers: - url: https://api.tavily.com/ security: [] tags: - name: Search - name: Extract - name: Crawl - name: Map - name: Research - name: Feedback - name: Usage - name: Logs paths: /extract: post: summary: Retrieve raw web content from specified URLs description: >- Extract content from one URL or batch up to 20 URLs in one request. Successful URLs appear in results; per-URL failures appear in failed_results. Check both arrays even when the response is HTTP 200. Request options apply to every URL in the batch. operationId: extract requestBody: description: Parameters for the Tavily Extract request. required: true content: application/json: schema: type: object properties: urls: oneOf: - type: string description: The URL to extract content from. example: https://en.wikipedia.org/wiki/Artificial_intelligence - type: array items: type: string description: A list of 1–20 URLs to extract in one request. example: - https://en.wikipedia.org/wiki/Artificial_intelligence - https://en.wikipedia.org/wiki/Machine_learning - https://en.wikipedia.org/wiki/Data_science minItems: 1 maxItems: 20 query: type: string description: >- User intent for reranking extracted content chunks. When provided, chunks are reranked based on relevance to this query. chunks_per_source: type: integer description: >- Chunks are short content snippets (maximum 500 characters each) pulled directly from the source. Use `chunks_per_source` to define the maximum number of relevant chunks returned per source and to control the `raw_content` length. Chunks will appear in the `raw_content` field as: ` [...] [...] `. Available only when `query` is provided. Must be between 1 and 5. minimum: 1 maximum: 5 default: 3 extract_depth: type: string description: >- 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. enum: - basic - advanced default: basic include_images: type: boolean description: >- Include a list of images extracted from the URLs in the response. Default is false. default: false include_favicon: type: boolean description: Whether to include the favicon URL for each result. default: false format: type: string description: >- The format of the extracted web page content. `markdown` returns content in markdown format. `text` returns plain text and may increase latency. enum: - markdown - text default: markdown timeout: type: number format: float description: >- 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. minimum: 1 maximum: 60 default: None include_usage: type: boolean description: >- Whether to include credit usage information in the response. `NOTE:`The value may be 0 if the total successful URL extractions has not yet reached 5 calls. See our [Credits & Pricing documentation](https://docs.tavily.com/documentation/api-credits) for details. default: false required: - urls responses: '200': description: >- Extraction completed. Check results and failed_results for each URL. HTTP 200 can have an empty results array when all valid URLs fail during extraction; output order is not guaranteed. content: application/json: schema: type: object properties: results: type: array description: A list of extracted content from the provided URLs. items: type: object properties: url: type: string description: The URL from which the content was extracted. example: >- https://en.wikipedia.org/wiki/Artificial_intelligence raw_content: type: string description: >- The full content extracted from the page. When `query` is provided, contains the top-ranked chunks joined by `[...]` separator. example: >- "Jump to content\nMain menu\nSearch\nAppearance\nDonate\nCreate account\nLog in\nPersonal tools\n Photograph your local culture, help Wikipedia and win!\nToggle the table of contents\nArtificial intelligence\n161 languages\nArticle\nTalk\nRead\nView source\nView history\nTools\nFrom Wikipedia, the free encyclopedia\n\"AI\" redirects here. For other uses, see AI (disambiguation) and Artificial intelligence (disambiguation).\nPart of a series on\nArtificial intelligence (AI)\nshow\nMajor goals\nshow\nApproaches\nshow\nApplications\nshow\nPhilosophy\nshow\nHistory\nshow\nGlossary\nvte\nArtificial intelligence (AI), in its broadest sense, is intelligence exhibited by machines, particularly computer systems. It is a field of research in computer science that develops and studies methods and software that enable machines to perceive their environment and use learning and intelligence to take actions that maximize their chances of achieving defined goals.[1] Such machines may be called AIs.\nHigh-profile applications of AI include advanced web search engines (e.g., Google Search); recommendation systems (used by YouTube, Amazon, and Netflix); virtual assistants (e.g., Google Assistant, Siri, and Alexa); autonomous vehicles (e.g., Waymo); generative and creative tools (e.g., ChatGPT and AI art); and superhuman play and analysis in strategy games (e.g., chess and Go)................... images: type: array example: [] description: >- This is only available if `include_images` is set to `true`. A list of image URLs extracted from the page. items: type: string favicon: type: string description: The favicon URL for the result. example: >- https://en.wikipedia.org/static/favicon/wikipedia.ico failed_results: type: array example: [] description: A list of URLs that could not be processed. items: type: object properties: url: type: string description: The URL that failed to be processed. error: type: string description: >- An error message describing why the URL couldn't be processed. response_time: type: number format: float description: Time in seconds it took to complete the request. example: 0.02 usage: type: object description: Credit usage details for the request. example: credits: 1 request_id: type: string description: >- A unique request identifier you can share with customer support to help resolve issues with specific requests. example: 123e4567-e89b-12d3-a456-426614174111 examples: partialSuccess: summary: One URL succeeds and another fails value: results: - url: https://example.com/article raw_content: Example extracted article content. images: [] failed_results: - url: https://example.com/unavailable error: Failed to retrieve content response_time: 0.5 request_id: 123e4567-e89b-12d3-a456-426614174111 '400': description: >- Bad Request. More than 20 URLs, an empty URL list, or no URLs passing validation are rejected. When all URLs fail validation, detail.failed_results describes the individual failures. content: application/json: schema: allOf: - $ref: '#/components/schemas/ApiError' - type: object properties: detail: type: object properties: failed_results: type: array description: A list of URLs that could not be processed. items: type: object properties: url: type: string description: The URL that failed to be processed. error: type: string description: >- An error message describing why the URL couldn't be processed. examples: tooManyUrls: summary: More than 20 URLs value: detail: error: Max 20 URLs are allowed. allInvalidUrls: summary: No URL passes validation value: detail: error: All URLs failed validation. failed_results: - url: not-a-url error: 'Validation Error: Invalid URL format' '401': description: Unauthorized - Your API key is wrong or missing. content: application/json: schema: $ref: '#/components/schemas/ApiError' example: detail: error: 'Unauthorized: missing or invalid API key.' '429': description: >- Too Many Requests. Error messages and retry delays can vary by rate-limit rule. content: application/json: schema: $ref: '#/components/schemas/ApiError' example: detail: error: >- Your request has been blocked due to excessive requests. Please reduce the rate of requests. headers: Retry-After: $ref: '#/components/headers/RetryAfter' '432': description: Key limit or Plan Limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' example: detail: error: >- <432 Custom Forbidden Error (e.g This request exceeds your plan's set usage limit. Please upgrade your plan or contact support@tavily.com)> '433': description: PayGo limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' example: detail: error: >- This request exceeds the pay-as-you-go limit. You can increase your limit on the Tavily dashboard. '500': description: Internal Server Error - We had a problem with our server. content: application/json: schema: $ref: '#/components/schemas/ApiError' example: detail: error: Internal Server Error security: - bearerAuth: [] x-codeSamples: - lang: python label: Python SDK source: >- from tavily import TavilyClient tavily_client = TavilyClient(api_key="tvly-YOUR_API_KEY") response = tavily_client.extract("https://en.wikipedia.org/wiki/Artificial_intelligence") print(response) - lang: javascript label: JavaScript SDK source: >- const { tavily } = require("@tavily/core"); const tvly = tavily({ apiKey: "tvly-YOUR_API_KEY" }); const response = await tvly.extract("https://en.wikipedia.org/wiki/Artificial_intelligence"); console.log(response); components: schemas: ApiError: type: object properties: detail: type: object properties: error: type: string headers: RetryAfter: description: >- When present, the number of seconds to wait before retrying. Read the returned value; the delay can vary. schema: type: integer minimum: 0 example: 60 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Bearer authentication header in the form Bearer , where is your Tavily API key (e.g., Bearer tvly-YOUR_API_KEY). ````