Retrieve raw web content from specified URLs
Changed onExtract 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.
post/extract
Request
- Base URLhttps://api.tavily.com
- URLhttps://api.tavily.com/extract
- AuthHTTP bearer
Request body
Example request
{
"urls": "https://en.wikipedia.org/wiki/Artificial_intelligence"
}Response
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.
Example response
{
"results": [
{
"url": "https://en.wikipedia.org/wiki/Artificial_intelligence",
"raw_content": "\"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": [],
"favicon": "https://en.wikipedia.org/static/favicon/wikipedia.ico"
}
],
"failed_results": [],
"response_time": 0.02,
"usage": {
"credits": 1
},
"request_id": "123e4567-e89b-12d3-a456-426614174111"
}Changes
- breaking
the
/request property's minItems was increased to1 - breaking
the response's body type changed from
objectto no type for status - warning
removed the optional property
from the response with the status - info
api operation id
extractwas added - info
added
subschema #2to the response bodyallOflist for the response status
- breaking