Exa Web Search is a paid API for AI agents from Exa at api.exa.ai, paid per call via MPP, $0.007/call, status healthy (last checked 2026-10-12, last successful call 2026-10-07).
Search the web using AI-powered semantic search and return ranked results with titles, URLs, and metadata
Perform a search with an Exa prompt-engineered query and retrieve a list of relevant results. Optionally get contents.
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.
POSThttps://api.exa.ai/search?utm_source=zero.xyzUse 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.
{
"query": "artificial intelligence",
"numResults": 10
}| Field | Type | Description |
|---|---|---|
| type | — | |
| queryrequired | string | The query string for the search. |
| stream | — | |
| context | — | |
| category | — | |
| contents | — | |
| objective | — | 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 | — | |
| moderation | — | |
| numResults | — | |
| excludeText | — | 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. |
| includeText | — | 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. |
| endCrawlDate | — | |
| outputSchema | — | |
| systemPrompt | — | |
| userLocation | — | |
| excludeDomains | — | |
| includeDomains | — | |
| startCrawlDate | — | |
| userIdentifier | — | 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 | — | |
| additionalQueries | — | |
| startPublishedDate | — |
{
"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": ""
}{
"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
}
]
}Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"