{"uid":"cap_DXo0TIXnC2WxqDfP-TZ_6","slug":"exa-contents-dbbcbc2a","name":"Exa Contents","description":"Retrieve page contents by URL or document ID","url":"https://api.exa.ai/contents?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","oneOf":[{"required":["ids"]},{"required":["urls"]}],"properties":{"ids":{"type":"array","items":{"type":"string","maxLength":2048,"minLength":1},"maxItems":100,"minItems":1,"description":"Document IDs obtained from searches."},"text":{"anyOf":[{"oneOf":[{"type":"boolean","title":"Simple text retrieval","default":false,"description":"If true, returns full page text with default settings. If false, disables text return."},{"type":"object","title":"Advanced text options","properties":{"verbosity":{"anyOf":[{"enum":["compact","standard","full"],"type":"string","default":"compact","description":"Controls text rendering verbosity. compact focuses on main content, standard includes more surrounding page context, and full requests the most complete rendered text. Some pages may produce identical standard and full output. Use maxAgeHours: 0 when you need this applied to freshly fetched content."},{"type":"null"}]},"maxCharacters":{"anyOf":[{"type":"integer","maximum":1000000,"minimum":1,"description":"Maximum character limit for the full page text. Useful for controlling response size and API costs."},{"type":"null"}]},"excludeSections":{"anyOf":[{"type":"array","items":{"enum":["header","navigation","banner","body","sidebar","footer","metadata"],"type":"string"},"description":"Exclude content classified into these semantic page sections. Section classification is best-effort. Use maxAgeHours: 0 when you need this applied to freshly fetched content."},{"type":"null"}]},"includeHtmlTags":{"anyOf":[{"type":"boolean","default":false,"description":"If true, include lightweight HTML tags in returned text instead of plain markdown-style text. Use maxAgeHours: 0 when you need this applied to freshly fetched content."},{"type":"null"}]},"includeSections":{"anyOf":[{"type":"array","items":{"enum":["header","navigation","banner","body","sidebar","footer","metadata"],"type":"string"},"description":"Best-effort. Only include content classified into these semantic page sections. Section classification may be unavailable or incomplete for some pages; validate output if strict filtering is required. Use maxAgeHours: 0 when you need this applied to freshly fetched content."},{"type":"null"}]}},"description":"Advanced options for controlling text extraction. Use this when you need to limit text length or include HTML structure."}],"description":"Text extraction options for each result."},{"type":"null"}]},"urls":{"type":"array","items":{"type":"string","maxLength":2048,"minLength":1},"maxItems":100,"minItems":1,"description":"URLs to crawl (backwards compatible with the `ids` parameter)."},"extras":{"anyOf":[{"type":"object","properties":{"links":{"anyOf":[{"type":"integer","default":0,"maximum":1000,"minimum":0,"description":"Number of URLs to return from each webpage."},{"type":"null"}]},"richLinks":{"anyOf":[{"type":"integer","default":0,"maximum":1000,"minimum":0,"description":"Number of rich links to return for each result."},{"type":"null"}]},"codeBlocks":{"anyOf":[{"type":"integer","default":0,"maximum":1000,"minimum":0,"description":"Number of code blocks to return for each result."},{"type":"null"}]},"imageLinks":{"anyOf":[{"type":"integer","default":0,"maximum":1000,"minimum":0,"description":"Number of images to return for each result."},{"type":"null"}]},"richImageLinks":{"anyOf":[{"type":"integer","default":0,"maximum":1000,"minimum":0,"description":"Number of rich image links to return for each result."},{"type":"null"}]}},"description":"Extra parameters to pass."},{"type":"null"}]},"context":{"anyOf":[{"oneOf":[{"type":"boolean","deprecated":true,"description":"Deprecated. Use `highlights` or `text` instead. Returns page contents as a combined context string.","x-exa-lifecycle":"deprecated","x-exa-replacement":["highlights","text"]},{"type":"object","deprecated":true,"properties":{"maxCharacters":{"type":"integer","maximum":1000000,"minimum":1,"description":"Maximum character limit for the context string."}},"description":"Deprecated. Use `highlights` or `text` instead. Returns page contents as a combined context string.","x-exa-lifecycle":"deprecated","x-exa-replacement":["highlights","text"]}],"deprecated":true,"description":"Deprecated. Use `highlights` or `text` instead. Returns page contents as a combined context string.","x-exa-lifecycle":"deprecated","x-exa-replacement":["highlights","text"]},{"type":"null"}]},"summary":{"anyOf":[{"type":"object","properties":{"query":{"anyOf":[{"type":"string","description":"Custom query for the LLM-generated summary."},{"type":"null"}]},"schema":{"anyOf":[{"type":"object","description":"JSON schema for structured output from summary. See https://json-schema.org/overview/what-is-jsonschema for JSON Schema documentation.","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{"type":"null"},{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/JsonValue"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/JsonValue"}}],"description":"Any JSON value."}},{"type":"null"}]}},"description":"Summary of the webpage."},{"type":"null"}]},"subpages":{"anyOf":[{"type":"integer","default":0,"maximum":100,"minimum":0,"description":"The number of subpages to crawl. The actual number crawled may be limited by system constraints."},{"type":"null"}]},"livecrawl":{"anyOf":[{"enum":["never","always","fallback","preferred"],"type":"string","deprecated":true,"description":"Deprecated. Use `maxAgeHours` instead. Does not guarantee freshly fetched content, which may be served according to server freshness policy. Do not send livecrawl and maxAgeHours together.","x-exa-lifecycle":"deprecated","x-exa-replacement":"maxAgeHours"},{"type":"null"}]},"compliance":{"anyOf":[{"enum":["hipaa"],"type":"string","description":"Enterprise-only compliance mode. Set to `hipaa` for HIPAA mode. Requires cache-only retrieval with supported parameters. See the HIPAA docs for details."},{"type":"null"}]},"highlights":{"anyOf":[{"oneOf":[{"type":"boolean","title":"Simple highlights retrieval","default":false,"description":"If true, returns highlights with default settings. If false, disables highlights."},{"type":"object","title":"Advanced highlights options","properties":{"query":{"anyOf":[{"type":"string","description":"Custom query that guides which highlights the LLM picks."},{"type":"null"}]},"dynamic":{"anyOf":[{"type":"boolean","x-mint":{"post":["Beta"]},"description":"Enable Dynamic Highlights (research preview): considers all results together and allocates a single shared context budget across the result set instead of a per-document budget. Not compatible with maxCharacters. Beta: requires the `Exa-Beta: dynamic-highlights-2026-08-28` request header; requests setting `dynamic` without it are rejected.","x-exa-beta-flag":"dynamic-highlights-2026-08-28","x-exa-lifecycle":"beta"},{"type":"null"}]},"verbosity":{"anyOf":[{"enum":["low","medium","high"],"type":"string","x-mint":{"post":["Beta"]},"description":"Preset highlight length: `low`, `medium`, and `high` allocate progressively larger token budgets for the returned highlights. With highlights.dynamic, the preset sets a single shared budget across the whole result set instead of a per-URL budget. Exact budgets are tuned by Exa and may change. Not compatible with maxCharacters or numSentences. Beta: requires the `Exa-Beta: dynamic-highlights-2026-08-28` request header; requests setting `verbosity` without it are rejected.","x-exa-beta-flag":"dynamic-highlights-2026-08-28","x-exa-lifecycle":"beta"},{"type":"null"}]},"numSentences":{"anyOf":[{"type":"integer","minimum":1,"deprecated":true,"description":"Deprecated. Use `maxCharacters` instead. Currently mapped to a character budget of about 1333 characters per sentence. Pass highlights: true for default highlights, or { query } to guide selection with your own query.","x-exa-lifecycle":"deprecated","x-exa-replacement":"maxCharacters"},{"type":"null"}]},"maxCharacters":{"anyOf":[{"type":"integer","maximum":1000000,"minimum":1,"description":"Maximum number of characters to return for highlights. Controls the total length of highlight text returned per URL. Not compatible with highlights.dynamic."},{"type":"null"}]},"highlightsPerUrl":{"anyOf":[{"type":"integer","minimum":1,"deprecated":true,"description":"Deprecated. Currently ignored. Pass highlights: true for default highlights, or { query } to guide selection with your own query.","x-exa-lifecycle":"deprecated"},{"type":"null"}]}},"description":"Advanced options for steering highlight extraction. Pass highlights: true for the highest-quality default; supply this object only when you need to guide selection with your own query."}],"description":"Text snippets the LLM identifies as most relevant from each page."},{"type":"null"}]},"maxAgeHours":{"anyOf":[{"type":"integer","maximum":720,"minimum":-1,"description":"Maximum age of cached content in hours. Positive values use cached content if it is less than this many hours old; 0 fetches fresh content and is the supported way to apply text rendering options to newly fetched pages; -1 always uses cache; omitted uses fallback fetching when cached content is unavailable. Maximum supported value is 720 hours."},{"type":"null"}]},"snapshotAsOf":{"anyOf":[{"oneOf":[{"type":"string","format":"date-time","description":"ISO 8601 date-time."},{"type":"string","format":"date","description":"ISO 8601 date (`YYYY-MM-DD`), interpreted as midnight UTC."}],"description":"Return the newest stored version of each page as of this instant. Accepts an ISO 8601 date-time (`2026-01-15T00:00:00Z`) or a date-only value (`2026-01-15`), which is interpreted as midnight UTC. Historical requests are served from stored versions only and never fetch the live page."},{"type":"null"}]},"subpageTarget":{"anyOf":[{"oneOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"array","items":{"type":"string","maxLength":100,"minLength":1},"maxItems":100,"minItems":0}],"description":"Term to find specific subpages of search results. Can be a single string or an array of strings."},{"type":"null"}]},"userIdentifier":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":64,"minLength":1},{"type":"null"}],"example":"7f3a9c52-1d4e-4b8a-9e60-2c5d8a1f0b37","description":"An opaque identifier your platform generates for the end user this request is made on behalf of, such as a UUID. Exa records it with the request so that usage and abuse can be attributed to one end user instead of your whole team. It must not be or contain personal information such as an email address, phone number, username, or name; send a hash if that is all you have. 1 to 64 characters: letters, digits, underscores, and hyphens. It is retained under Zero Data Retention and does not change results."},"livecrawlTimeout":{"anyOf":[{"type":"integer","default":10000,"maximum":90000,"description":"The timeout for livecrawling in milliseconds.","exclusiveMinimum":0},{"type":"null"}]},"crawledBeforeDate":{"anyOf":[{"type":"string"},{"type":"null"}],"format":"date-time","deprecated":true,"description":"Deprecated. Use `snapshotAsOf` instead. Alias of snapshotAsOf with identical behavior.","x-exa-lifecycle":"deprecated","x-exa-replacement":"snapshotAsOf"}},"description":"Provide either `ids` or `urls`, but not both."},"responseSchema":{"type":"object","properties":{"context":{"type":"string","deprecated":true,"description":"Deprecated. Use `results[].highlights` or `results[].text` instead. Combined context string from search results.","x-exa-lifecycle":"deprecated","x-exa-replacement":["results[].highlights","results[].text"]},"results":{"type":"array","items":{"type":"object","required":["title","url"],"properties":{"id":{"type":"string","description":"The temporary ID for the document. Useful for the /contents endpoint."},"url":{"type":"string","format":"uri","description":"The URL of the search result."},"text":{"type":"string","description":"The full content text of the search result."},"image":{"type":"string","format":"uri","description":"The URL of an image associated with the search result, if available."},"title":{"type":"string","description":"The title of the search result."},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"If available, the author of the content."},"extras":{"type":"object","properties":{"links":{"type":"array","items":{"type":"string"},"description":"Array of links from the search result."},"richLinks":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"The URL of the link."},"anchor":{"type":"string","description":"The anchor text of the link, when the page provides one."}},"additionalProperties":false},"description":"Array of links with their anchor text, in the order they appear on the page."},"codeBlocks":{"type":"array","items":{"type":"object","required":["text","source"],"properties":{"text":{"type":"string","description":"The contents of the code block."},"source":{"type":"string","description":"The language the code block is annotated with, if any."}},"additionalProperties":false},"description":"Array of code blocks from the search result."},"imageLinks":{"type":"array","items":{"type":"string"},"description":"Array of image URLs from the search result."},"richImageLinks":{"type":"array","items":{"type":"object","required":["url"],"properties":{"alt":{"type":"string","description":"The alt text of the image, when the page provides one."},"url":{"type":"string","description":"The URL of the image."}},"additionalProperties":false},"description":"Array of images with their alt text, in the order the images appear on the page."}},"description":"Results from extras. Each field is returned only when requested via contents.extras.","additionalProperties":false},"favicon":{"type":"string","format":"uri","description":"The URL of the favicon for the search result's domain."},"summary":{"type":"string","description":"Summary of the webpage."},"entities":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","required":["id","type","version","properties"],"properties":{"id":{"type":"string","description":"Stable company entity identifier."},"type":{"type":"string","const":"company","description":"Entity discriminator."},"version":{"type":"integer","minimum":1,"description":"Entity schema version."},"properties":{"type":"object","required":["name","foundedYear","description","workforce","headquarters","financials","webTraffic","research"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Company name."},"research":{"anyOf":[{"type":"object","required":["worksCount","citationCount","areas","notableWorks","topResearchers"],"properties":{"areas":{"type":"array","items":{"type":"string"},"description":"Ranked research areas, most active first."},"worksCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of works with an affiliated author."},"notableWorks":{"type":"array","items":{"type":"object","required":["title","year","venue","citationCount","doi","id","type"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Resolved publication entity identifier, when available."},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Digital Object Identifier."},"type":{"anyOf":[{"enum":["article","book","book-chapter","dataset","dissertation","preprint","report","review"],"type":"string"},{"type":"null"}],"description":"Publication type."},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Publication year."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Publication title."},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Publication venue."},"citationCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of works citing this publication."}},"additionalProperties":false},"description":"Most-cited notable works."},"citationCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Lifetime citation count."},"topResearchers":{"type":"array","items":{"type":"object","required":["person","worksCount","citationCount"],"properties":{"person":{"anyOf":[{"type":"object","required":["name","id"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Referenced person entity identifier."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Referenced person name."}},"additionalProperties":false},{"type":"null"}],"description":"Referenced researcher."},"worksCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of works produced at the organization."},"citationCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of citations for works produced at the organization."}},"additionalProperties":false},"description":"Researchers ordered by works produced at the organization."}},"additionalProperties":false},{"type":"null"}],"description":"Company research information."},"workforce":{"anyOf":[{"type":"object","required":["total"],"properties":{"total":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Total estimated employee count."}},"additionalProperties":false},{"type":"null"}],"description":"Company workforce information."},"financials":{"anyOf":[{"type":"object","required":["revenueAnnual","fundingTotal","fundingLatestRound"],"properties":{"fundingTotal":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Total funding raised in USD."},"revenueAnnual":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Estimated annual revenue in USD."},"fundingLatestRound":{"anyOf":[{"type":"object","required":["name","date","amount"],"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Funding round date."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Funding round name."},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Funding round amount in USD."}},"additionalProperties":false},{"type":"null"}],"description":"Most recent funding round, when available."}},"additionalProperties":false},{"type":"null"}],"description":"Company financial information."},"webTraffic":{"anyOf":[{"type":"object","required":["visitsMonthly","countryRank","avgDurationSeconds","history"],"properties":{"history":{"type":"array","items":{"type":"object","required":["value","dateFrom","dateTo"],"properties":{"value":{"type":"number","description":"Estimated monthly visits for this period."},"dateTo":{"type":"string","description":"End month for this value, formatted as YYYY-MM."},"dateFrom":{"type":"string","description":"Start month for this value, formatted as YYYY-MM."}},"additionalProperties":false},"description":"Historical monthly website visits."},"countryRank":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Estimated website traffic rank within the company's primary country."},"visitsMonthly":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Estimated monthly website visits."},"avgDurationSeconds":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Estimated average visit duration, in seconds."}},"additionalProperties":false},{"type":"null"}],"description":"Company web traffic information."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Short company description."},"foundedYear":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Year the company was founded."},"headquarters":{"anyOf":[{"type":"object","required":["address","city","postalCode","country"],"properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Company headquarters city."},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Company headquarters street address."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Company headquarters country."},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Company headquarters postal code."}},"additionalProperties":false},{"type":"null"}],"description":"Company headquarters information."}},"description":"Company-specific entity fields.","additionalProperties":false}},"additionalProperties":false},{"type":"object","required":["id","type","version","properties"],"properties":{"id":{"type":"string","description":"Stable person entity identifier."},"type":{"type":"string","const":"person","description":"Entity discriminator."},"version":{"type":"integer","minimum":1,"description":"Entity schema version."},"properties":{"type":"object","required":["name","firstName","lastName","location","workHistory","educationHistory","research"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Person name."},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Person last name."},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Person location."},"research":{"anyOf":[{"type":"object","required":["worksCount","citationCount","hIndex","firstPublicationYear","latestPublicationYear","areas","notableWorks"],"properties":{"areas":{"type":"array","items":{"type":"string"},"description":"Ranked research areas, most active first."},"hIndex":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Research h-index."},"worksCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Lifetime number of works."},"notableWorks":{"type":"array","items":{"type":"object","required":["title","year","venue","citationCount","doi","id","type"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Resolved publication entity identifier, when available."},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Digital Object Identifier."},"type":{"anyOf":[{"enum":["article","book","book-chapter","dataset","dissertation","preprint","report","review"],"type":"string"},{"type":"null"}],"description":"Publication type."},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Publication year."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Publication title."},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Publication venue."},"citationCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of works citing this publication."}},"additionalProperties":false},"description":"Most-cited notable works."},"citationCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Lifetime citation count."},"firstPublicationYear":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Year of the first publication."},"latestPublicationYear":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Year of the latest publication."}},"additionalProperties":false},{"type":"null"}],"description":"Person research information."},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Person first name."},"workHistory":{"type":"array","items":{"type":"object","required":["title","location","dates","company"],"properties":{"dates":{"anyOf":[{"type":"object","required":["from","to"],"properties":{"to":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End date for the date range."},"from":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start date for the date range."}},"additionalProperties":false},{"type":"null"}],"description":"Role date range."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Role title."},"company":{"anyOf":[{"type":"object","required":["id","name"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Referenced company identifier."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Referenced company name."}},"additionalProperties":false},{"type":"null"}],"description":"Company for this role."},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Role location."}},"additionalProperties":false},"description":"Known professional roles for this person."},"educationHistory":{"type":"array","items":{"type":"object","required":["degree","dates","institution"],"properties":{"dates":{"anyOf":[{"type":"object","required":["from","to"],"properties":{"to":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End date for the date range."},"from":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start date for the date range."}},"additionalProperties":false},{"type":"null"}],"description":"Education date range."},"degree":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Degree or credential."},"institution":{"anyOf":[{"type":"object","required":["id","name"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Referenced institution identifier."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Referenced institution name."}},"additionalProperties":false},{"type":"null"}],"description":"Education institution."}},"additionalProperties":false},"description":"Known education history for this person."}},"description":"Person-specific entity fields.","additionalProperties":false}},"additionalProperties":false},{"type":"object","required":["id","type","version","properties"],"properties":{"id":{"type":"string","description":"Stable publication entity identifier."},"type":{"type":"string","const":"publication","description":"Entity discriminator."},"version":{"type":"integer","minimum":1,"description":"Entity schema version."},"properties":{"type":"object","required":["title","year","date","type","language","citationCount","authors","referenceCount","abstract","doi"],"properties":{"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Bare DOI identifier (e.g. 10.1234/abcd)."},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Publication date."},"type":{"anyOf":[{"enum":["article","book","book-chapter","dataset","dissertation","preprint","report","review"],"type":"string"},{"type":"null"}],"description":"Publication type."},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Publication year."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Publication title."},"authors":{"type":"array","items":{"type":"object","required":["name","id"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Resolved person entity identifier, when available."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Author display name."}},"additionalProperties":false},"description":"Ordered list of authors."},"abstract":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Publication abstract text."},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Publication language."},"citationCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of works citing this publication (incoming references)."},"referenceCount":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of works this publication cites (outgoing references)."}},"description":"Publication-specific entity fields.","additionalProperties":false}},"additionalProperties":false}],"discriminator":{"mapping":{"person":"#/components/schemas/SearchPersonEntityOutput","company":"#/components/schemas/SearchCompanyEntityOutput","publication":"#/components/schemas/SearchPublicationEntityOutput"},"propertyName":"type"}},"description":"Structured entity data for company, person, publication, or product search results. Returned for supported entity-backed categories and for product listing pages."},"subpages":{"type":"array","items":{"type":"object","required":["title","url"],"properties":{"id":{"type":"string","description":"The temporary ID for the document. Useful for the /contents endpoint."},"url":{"type":"string","format":"uri","description":"The URL of the search result."},"image":{"type":"string","format":"uri","description":"The URL of an image associated with the search result, if available."},"title":{"type":"string","description":"The title of the search result."},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"If available, the author of the content."},"favicon":{"type":"string","format":"uri","description":"The URL of the favicon for the search result's domain."},"publishedDate":{"type":"string","format":"date-time","description":"An estimate of the creation date, from parsing HTML content. Format is YYYY-MM-DD."}},"additionalProperties":false},"description":"Array of subpages for the search result."},"highlights":{"type":"array","items":{"type":"string"},"description":"Array of highlights extracted from the search result content."},"publishedDate":{"type":"string","format":"date-time","description":"An estimate of the creation date, from parsing HTML content. Format is YYYY-MM-DD."},"highlightScores":{"type":"array","items":{"type":"number","format":"float"},"description":"Array of cosine similarity scores for each highlighted snippet."}},"additionalProperties":false}},"statuses":{"type":"array","items":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string","description":"The URL or document ID that was requested."},"error":{"anyOf":[{"type":"object","properties":{"tag":{"type":"string","description":"Specific error type."},"httpStatusCode":{"anyOf":[{"type":"integer","maximum":599,"minimum":100},{"type":"null"}],"description":"The corresponding HTTP status code."}},"additionalProperties":false},{"type":"null"}],"description":"Error details, only present when status is \"error\"."},"source":{"enum":["cached","crawled"],"type":"string","description":"Where the returned content was sourced from."},"status":{"enum":["success","error"],"type":"string","description":"Status of the content fetch operation."}},"additionalProperties":false},"description":"Status information for each requested URL or document ID."},"requestId":{"type":"string","description":"Unique identifier for the request."},"searchTime":{"type":"number","description":"Server-side processing time in milliseconds, measured at the gateway. Covers retrieval but may exclude later phases such as structured output synthesis, so it can be lower than end-to-end request latency."},"costDollars":{"type":"object","properties":{"total":{"type":"number","format":"float","description":"Estimated total dollar cost for the completed request. This response value is not an invoice record."},"search":{"type":"object","properties":{"neural":{"type":"number","format":"float","description":"Cost of neural search operations."},"keyword":{"type":"number","format":"float","description":"Cost of keyword search operations."}},"description":"Endpoint-dependent estimated search cost breakdown by retrieval mode. Instant, fast, and auto search responses may include neural search cost. Deep search modes may be reflected only in total.","additionalProperties":false},"summary":{"type":"number","format":"float","description":"Cost of synthesized summary generation for search requests."},"contents":{"type":"object","properties":{"text":{"type":"number","format":"float","description":"Cost of text extraction."},"summary":{"type":"number","format":"float","description":"Cost of per-result summary generation."},"highlights":{"type":"number","format":"float","description":"Cost of highlight extraction."}},"description":"Estimated cost breakdown for standalone content retrieval (text, highlights, and summaries billed outside the bundled search price).","additionalProperties":false}},"description":"Endpoint-dependent estimated dollar cost breakdown for the completed request. Billing is computed from usage counters rather than this response object.","additionalProperties":false}},"additionalProperties":false},"example":{"request":{"urls":["https://www.wikipedia.org/wiki/Artificial_intelligence","https://www.example.com/"]},"response":{"_truncated":true,"_originalSize":127904}},"exampleRequest":{"urls":["https://www.wikipedia.org/wiki/Artificial_intelligence","https://www.example.com/"]},"tags":["search","web-search","content","ai-search","ai"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.83","successRate":"1.00","reviews":1,"stars":"4.3","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"9.8900","medianCents":"10.0000","p90Cents":"10.0000","minCents":"9.8900","maxCents":"10.0000","p95Cents":"10.0000","sampleCount":90,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SphZMsDEgNZ4VORL3TYWT","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Exa","brandSlug":"exa","brandBaseUrl":"https://exa.ai","brandDocsUrl":"https://docs.exa.ai/reference/mpp-guide","whatItDoes":"Fetches and returns the full page contents of one or more URLs using Exa's web retrieval infrastructure","exampleAgentPrompt":"Can you fetch the full page contents of these two URLs for me: https://www.wikipedia.org/wiki/Artificial_intelligence and https://www.bbc.com/news/technology ?","exampleUseCases":null,"resultDescription":"Returns the full text and content of each requested URL, including the page body and article text. The response may be truncated for very large pages.","failureModes":["URL is unreachable or returns a non-200 status — content may be empty or missing","Page is paywalled or requires authentication — content may be partial or blocked","Very large pages may be truncated in the response","Invalid or malformed URLs in the input list may produce errors","Dynamic JavaScript-rendered content may not be fully captured"],"whenToPreferThis":"Choose this endpoint when you already have specific URLs and need their full text content — not when you need to search for pages. Prefer this over a general search endpoint when the user provides direct links and wants the page body extracted. Use instead of Answer when you need raw content rather than an AI-synthesized response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":91,"lastUsedAt":"2026-10-08T02:19:03.760Z","lastSuccessfullyRanAt":"2026-10-08T02:19:03.760Z","lastHealthCheckAt":"2026-10-12T23:21:03.061Z","isFirstParty":false,"canonicalSlug":"exa-contents-dbbcbc2a"}