{"uid":"cap_7EgVaagyqjc6GaAxc6kEH","slug":"exa-search-eaa916e8","name":"Exa Web Search","description":"Perform a search with an Exa prompt-engineered query and retrieve a list of relevant results. Optionally get contents.","url":"https://api.exa.ai/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"type":{"anyOf":[{"enum":["instant","fast","auto","deep-lite","deep","deep-reasoning"],"type":"string","default":"auto","description":"The search mode to use. `auto` (default) is a balanced mode that optimizes for both quality and speed and is recommended for most applications. `fast` returns high-quality results with reduced latency, making it a good fit for user-facing search and interactive workflows. `instant` is optimized for minimum response time, trading some search depth for speed in real-time experiences such as chat, voice agents, and autocomplete. `deep-lite` performs lightweight research with synthesized results and a consistent 4-second latency, lower than full deep search. `deep` conducts comprehensive multi-step research with synthesis, while `deep-reasoning` adds stronger reasoning for complex analysis and decision-making tasks."},{"type":"null"}]},"query":{"type":"string","minLength":1,"description":"The query string for the search."},"stream":{"anyOf":[{"type":"boolean","default":false,"description":"Requests server-sent events for synthesized output streaming. Streaming is currently used only when outputSchema is provided; otherwise the endpoint returns the normal JSON search response."},{"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"}]},"category":{"anyOf":[{"enum":["company","publication","news","personal site","financial report","people"],"type":"string","description":"A data category to focus on. Known categories include `company`, `publication`, `news`, `personal site`, `financial report`, and `people`. Other strings are accepted and used as category hints for search. The `people` and `company` categories have improved quality for finding people profiles and company pages. The `publication` category surfaces scholarly publications such as research papers, preprints, and journal articles, with structured metadata like authors, venue, and citations. Note: The `company` and `people` categories only support a limited set of filters. The following parameters are NOT supported for these categories: `startPublishedDate`, `endPublishedDate`, `excludeDomains`. Using unsupported parameters will result in a 400 error."},{"type":"null"}]},"contents":{"anyOf":[{"type":"object","properties":{"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"}]},"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":{"$ref":"#/components/schemas/JsonValue"}},{"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"}]},"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"}]},"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"}}},{"type":"null"}]},"objective":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}],"description":"The broader goal this search serves: the task the caller is working on, beyond the query itself. When exposing this field to an agent as a tool parameter, describe it as: \"Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.\""},"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"}]},"moderation":{"anyOf":[{"type":"boolean","default":false,"description":"Enable content moderation to filter unsafe content from search results."},{"type":"null"}]},"numResults":{"anyOf":[{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Number of results to return. Limits vary by search type. The maximum public limit is 100 results. Contact sales (hello@exa.ai) to discuss higher limits."},{"type":"null"}]},"excludeText":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":4096},"maxItems":50},{"type":"null"}],"deprecated":true,"description":"Deprecated. List of strings that must not be present in the webpage text of results. Matching is approximate (word-level rather than exact phrase). Up to 50 strings, each up to 4096 characters.","x-exa-lifecycle":"deprecated"},"includeText":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":4096},"maxItems":50},{"type":"null"}],"deprecated":true,"description":"Deprecated. List of strings that must be present in the webpage text of results. Matching is approximate (word-level rather than exact phrase), so a multi-word entry can match pages where its words appear separately. Up to 50 strings, each up to 4096 characters.","x-exa-lifecycle":"deprecated"},"endCrawlDate":{"anyOf":[{"type":"string","format":"date-time","deprecated":true,"description":"Deprecated. Ignored by the API.","x-exa-lifecycle":"deprecated"},{"type":"null"}]},"outputSchema":{"anyOf":[{"type":"object","oneOf":[{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"text"},"description":{"type":"string"}}},{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"object"},"required":{"type":"array","items":{"type":"string"}},"properties":{"type":"object","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."}},"description":{"type":"string"},"additionalProperties":{"type":"boolean"}},"additionalProperties":{"oneOf":[{"type":"null"},{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"array","items":{"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":"object","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."}}],"description":"Any JSON value."}}],"description":"JSON schema for synthesized output. Supported root types are \"text\" and \"object\". When provided, the response includes an output object whose content matches this schema. Works with every search type and adds about 2 seconds of synthesis latency on top of the selected search type. Object schemas are limited to 10 properties in total (nested and array items properties count toward the limit) and 2 levels of nesting, and every array must define items.","discriminator":{"mapping":{"text":"#/components/schemas/OutputSchemaText","object":"#/components/schemas/OutputSchemaObject"},"propertyName":"type"}},{"type":"null"}]},"systemPrompt":{"anyOf":[{"type":"string","description":"Additional instructions that guide generated output or agent behavior. Use this for source preferences, novelty constraints, duplication constraints, or other behavior guidance."},{"type":"null"}]},"userLocation":{"anyOf":[{"oneOf":[{"type":"string","description":"The two-letter ISO 3166-1 country code of the user, e.g. `US`."},{"type":"object","required":["country"],"properties":{"country":{"type":"string","description":"The two-letter ISO 3166-1 country code of the user, e.g. `US`."}},"description":"Object form of `userLocation` carrying only the user's country. Equivalent to the string form.","additionalProperties":false},{"type":"object","required":["latitude","longitude"],"properties":{"country":{"type":"string","description":"The two-letter ISO 3166-1 country code of the user, e.g. `US`."},"latitude":{"type":"number","maximum":90,"minimum":-90,"description":"The user's latitude in decimal degrees. Must be sent together with `longitude`."},"longitude":{"type":"number","maximum":180,"minimum":-180,"description":"The user's longitude in decimal degrees. Must be sent together with `latitude`."}},"description":"Object form of `userLocation` carrying the user's coordinates (`latitude` and `longitude` are required together) and optionally the country.","additionalProperties":false}],"description":"The end user's location, used to localize results. Either a two-letter ISO 3166-1 country code string (e.g. `US`) or an object with `country` and/or `latitude` + `longitude` in decimal degrees. Coordinates are optional and must be sent together; `country` alone is equivalent to the string form. Send only the precision your use case needs."},{"type":"null"}]},"excludeDomains":{"anyOf":[{"type":"array","items":{"type":"string"},"maxItems":1200,"description":"List of domains or domain paths to exclude from search results. Each entry can be a hostname (for example, `example.com`), a hostname with a path prefix (for example, `example.com/docs`), or a wildcard subdomain (for example, `*.example.com`). If specified, no results will be returned from the matching domains or paths. Use this parameter for domain or path filtering instead of adding a `site:` operator to the query."},{"type":"null"}]},"includeDomains":{"anyOf":[{"type":"array","items":{"type":"string"},"maxItems":1200,"description":"List of domains or domain paths to include in the search. Each entry can be a hostname (for example, `example.com`), a hostname with a path prefix (for example, `example.com/docs`), or a wildcard subdomain (for example, `*.example.com`). If specified, results will only come from the matching domains or paths. Use this parameter for domain or path filtering instead of adding a `site:` operator to the query."},{"type":"null"}]},"startCrawlDate":{"anyOf":[{"type":"string","format":"date-time","deprecated":true,"description":"Deprecated. Ignored by the API.","x-exa-lifecycle":"deprecated"},{"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."},"endPublishedDate":{"anyOf":[{"type":"string","format":"date-time","description":"Only links with a published date before this will be returned. Must be specified in ISO 8601 format."},{"type":"null"}]},"additionalQueries":{"anyOf":[{"type":"array","items":{"type":"string"},"maxItems":10,"minItems":1,"description":"Additional query variations for deep-search variants. Only works with a deep-search type. When provided, these queries are used alongside the main query for broader results."},{"type":"null"}]},"startPublishedDate":{"anyOf":[{"type":"string","format":"date-time","description":"Only links with a published date after this will be returned. Must be specified in ISO 8601 format."},{"type":"null"}]}}},"responseSchema":{"oneOf":[{"type":"object","required":["results","output"],"properties":{"output":{"type":"object","required":["content","grounding"],"properties":{"content":{"oneOf":[{"type":"string"},{"type":"object","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."}}],"description":"Synthesized content. String by default, or object when outputSchema is provided."},"grounding":{"type":"array","items":{"type":"object","required":["field","citations","confidence"],"properties":{"field":{"type":"string","description":"Field path in output.content, for example content or companies[0].funding."},"citations":{"type":"array","items":{"type":"object","required":["url","title"],"properties":{"url":{"type":"string","format":"uri","description":"Source URL."},"title":{"type":"string","description":"Source title."}},"additionalProperties":false},"description":"Sources supporting this output field."},"confidence":{"enum":["low","medium","high"],"type":"string","description":"Model-reported reliability for this field."}},"additionalProperties":false},"description":"Field-level grounding for synthesized output."}},"description":"Synthesized output. Returned when outputSchema is provided.","additionalProperties":false},"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":[{"$ref":"#/components/schemas/SearchCompanyEntityOutput"},{"$ref":"#/components/schemas/SearchPersonEntityOutput"},{"$ref":"#/components/schemas/SearchPublicationEntityOutput"}],"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},"description":"A list of search results containing title, URL, published date, and author."},"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},"resolvedSearchType":{"type":"string","deprecated":true,"description":"Deprecated. May be an empty string. Do not branch on this value.","x-exa-lifecycle":"deprecated"}},"additionalProperties":false},{"type":"object","required":["results"],"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":[{"$ref":"#/components/schemas/SearchCompanyEntityOutput"},{"$ref":"#/components/schemas/SearchPersonEntityOutput"},{"$ref":"#/components/schemas/SearchPublicationEntityOutput"}],"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},"description":"A list of search results containing title, URL, published date, and author."},"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},"resolvedSearchType":{"type":"string","deprecated":true,"description":"Deprecated. May be an empty string. Do not branch on this value.","x-exa-lifecycle":"deprecated"}},"additionalProperties":false}]},"example":{"request":{"query":"artificial intelligence","numResults":10},"response":{"results":[{"id":"https://en.wikipedia.org/wiki/Artificial_intelligence","url":"https://en.wikipedia.org/wiki/Artificial_intelligence","title":"Artificial intelligence - Wikipedia"},{"id":"https://hai.stanford.edu/ai-definitions/what-is-artificial-intelligence-ai","url":"https://hai.stanford.edu/ai-definitions/what-is-artificial-intelligence-ai","image":"https://hai.stanford.edu/assets/images/glossary-card-mockup@2x.png","title":"What is Artificial Intelligence (AI)? | Stanford HAI","favicon":"https://hai.stanford.edu/favicon.ico"},{"id":"https://en.wikipedia.org/wiki/Artificial_Intelligence","url":"https://en.wikipedia.org/wiki/Artificial_Intelligence","image":"https://upload.wikimedia.org/wikipedia/commons/thumb/e/e8/General_Formal_Ontology.svg/330px-General_Formal_Ontology.svg.png","title":"Artificial intelligence","publishedDate":"2026-05-26T00:00:00.000Z"},{"id":"https://plato.stanford.edu/entries/artificial-intelligence/","url":"https://plato.stanford.edu/entries/artificial-intelligence/","image":"https://plato.stanford.edu/symbols/sep-man-red.png","title":"Artificial Intelligence (Stanford Encyclopedia of Philosophy)"},{"id":"https://www.nasa.gov/what-is-artificial-intelligence/","url":"https://www.nasa.gov/what-is-artificial-intelligence/","title":"What is Artificial Intelligence? - NASA","publishedDate":"2024-05-13T00:00:00.000Z"},{"id":"https://www.ibm.com/think/topics/artificial-intelligence","url":"https://www.ibm.com/think/topics/artificial-intelligence","title":"What Is Artificial Intelligence (AI)? - IBM"},{"id":"https://cloud.google.com/learn/what-is-artificial-intelligence","url":"https://cloud.google.com/learn/what-is-artificial-intelligence","title":"What is Artificial Intelligence (AI)? | Google Cloud"},{"id":"https://www.oed.com/dictionary/artificial-intelligence_n?tab=factsheet&tl=true","url":"https://www.oed.com/dictionary/artificial-intelligence_n?tab=factsheet&tl=true","image":"https://www.oed.com/images/OED-square-logo-1.jpg","title":"artificial intelligence, n. meanings, etymology and more | Oxford English Dictionary","author":"J. McCarthy","favicon":"https://www.oed.com/images/icons/favicon-32x32.png"},{"id":"https://aws.amazon.com/what-is/artificial-intelligence/","url":"https://aws.amazon.com/what-is/artificial-intelligence/","title":"What is AI? - Artificial Intelligence Explained - AWS","favicon":"https://a0.awsstatic.com/libra-css/images/site/fav/favicon.ico"}],"requestId":"c63e72ac448bac75bde7ca7e8483befb","searchTime":1057.1,"costDollars":{"total":0.007,"search":{"neural":0.007}},"resolvedSearchType":""}},"exampleRequest":{"query":"artificial intelligence","numResults":10},"tags":["search","web-search","content","ai-search","ai"],"displayCostAmount":"0.007","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":10,"rating":{"score":"0.71","successRate":"0.99","reviews":10,"stars":"3.8","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"0.7000","medianCents":"0.7000","p90Cents":"0.7000","minCents":"0.7000","maxCents":"0.7000","p95Cents":"0.7000","sampleCount":369,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vCAqPeBRvIylwCvnZ867x","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.007","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":"Search the web using AI-powered semantic search and return ranked results with titles, URLs, and metadata","exampleAgentPrompt":"Search Exa for the top 10 web results about 'quantum computing breakthroughs in 2025' and give me the titles and URLs.","exampleUseCases":null,"resultDescription":"An array of ranked web search results, each containing a result ID, URL, page title, published date, and optionally an image and favicon URL. Results are ordered by relevance to the query.","failureModes":["Empty or vague query may return low-quality or irrelevant results","Requesting too many results may slow response or hit limits","Very niche queries may return few or no results","Paywalled or non-indexed pages may not appear in results","Insufficient USDC balance may cause payment failure at $0.005 per call"],"whenToPreferThis":"Use this endpoint when you need to retrieve a ranked list of web pages relevant to a natural language query, especially when semantic relevance matters more than keyword matching. Prefer this over generic search APIs when you want AI-powered ranking and clean structured metadata per result. Choose this over Exa's Answer endpoint when you want raw URLs and page metadata rather than a synthesized answer, and over FindSimilar when you have a query string rather than a reference URL.","instructions":null,"reviewSummary":"Exa Search reliably delivers ranked, content-rich results across a wide range of queries — archival video research, prospect profiling, and product research — with fast response times (under 2 seconds) and accurate source URLs. Performance is strong when queries and budget caps are configured correctly, but some runs fail due to wallet or cost-cap issues, particularly when content enrichment silently inflates the charge beyond the base search price. A small share of runs return irrelevant or unusable results with no clear cause.","reviewSummaryHighlights":["Fast retrieval with relevant, freshness-dated results across diverse query types","Supports content extraction via numResults and contents.text parameters","Strong performance on niche and technical queries including archival and prospect research"],"reviewSummaryConcerns":["Content enrichment surcharges not clearly signaled upfront, causing unexpected cost-cap failures","Occasional runs return completely irrelevant or no usable results","Broad aggregator results sometimes mixed in, requiring manual filtering"],"reviewSummaryGeneratedAt":"2026-10-08T08:15:07.608Z","activationCount":1618,"lastUsedAt":"2026-10-07T20:04:20.134Z","lastSuccessfullyRanAt":"2026-10-07T20:03:25.899Z","lastHealthCheckAt":"2026-10-12T23:00:00.282Z","isFirstParty":false,"canonicalSlug":"exa-search-eaa916e8"}