{"uid":"cap_7yOHWmuCsSNHr7sHc9N0G","slug":"exa-contents-url-content-retrieval-ebc08a6d","name":"Exa Contents - URL Content Retrieval","description":"Exa Contents - Retrieve content from URLs","url":"https://stable-enrich-git-fix-stableenrich-exa-leg-547ea8-merit-systems.vercel.app/api/exa/contents","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"$schema":"https://json-schema.org/draft/2020-12/schema"},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"text":{"verbosity":"standard","maxCharacters":1000,"includeHtmlTags":false},"urls":["https://example.com"],"livecrawl":"fallback","highlights":false,"maxAgeHours":24},"response":{"results":[{"id":"https://example.com","url":"https://example.com","text":"Example Domain\n\n# Example Domain\n\nThis domain is for use in documentation examples without needing permission. Avoid use in operations.","title":"Example Domain","author":null,"favicon":"data:,","entities":[{"id":"https://exa.ai/library/organization/qmfkd8nk6b1","type":"company","version":1,"properties":{"name":"Selbstständig","workforce":{"total":11136},"financials":null,"webTraffic":null,"description":"sss","foundedYear":null,"headquarters":null}}]}],"statuses":[{"id":"https://example.com","source":"cached","status":"success"}],"requestId":"3e9c02b77d3af34e2b6204d1cc59df34","searchTime":16.47236599959433,"costDollars":{"total":0.001,"contents":{"text":0.001}}}},"exampleRequest":{"text":{"verbosity":"standard","maxCharacters":1000,"includeHtmlTags":false},"urls":["https://example.com"],"livecrawl":"fallback","highlights":false,"maxAgeHours":24},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bNHd89I-IPgyo_59UnEB9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves and extracts text content from one or more URLs, with options for verbosity, live crawling, and entity extraction","exampleAgentPrompt":"Can you fetch the text content from https://techcrunch.com/2024/01/15/openai-news/ — I want the full article text up to 2000 characters, skip HTML tags, and use live crawl as a fallback if the cached version is older than 24 hours.","exampleUseCases":[{"title":"Extract article text for summarization","prompt":"Grab the text from this news article — https://www.reuters.com/technology/ai-regulation-2024/ — up to 1500 characters, no HTML, and use the cached version if available, otherwise crawl it live."},{"title":"Competitor research from product pages","prompt":"Pull the full text content from these three URLs: https://competitor-a.com/pricing, https://competitor-b.com/pricing, and https://competitor-c.com/pricing — standard verbosity, no HTML tags, max 1000 characters each."},{"title":"Verify and extract webpage entities","prompt":"Fetch the content of https://example-company.com/about and extract any company or organization entities mentioned — standard verbosity, up to 2000 characters, live crawl if the cached page is more than 12 hours old."}],"resultDescription":"Returns an array of results per URL, each containing the extracted text, page title, author (if found), favicon, and any detected entities (companies, organizations, etc.). Also includes per-URL status (cached or live crawled), a request ID, total search time, and a cost breakdown in dollars.","failureModes":["URL is inaccessible or returns a non-200 status — status field shows 'error'","Live crawl timeout if the page is slow to respond","Cached content missing and live crawl not enabled — returns empty text","Max characters too low to capture meaningful content","Invalid URL format causing a request validation error","Rate limits or quota exceeded for the underlying Exa service"],"whenToPreferThis":"Use this endpoint when you already have specific URLs and need to retrieve their text content, as opposed to discovering URLs via search. Ideal when you need structured extraction (title, author, entities) alongside raw text, or when you want control over caching vs. live crawling behavior. Prefer this over a general web scraper when you need entity extraction and cost-efficient caching via Exa's index.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:37.222Z","isFirstParty":false}