Exa

Exa is an AI-powered search engine designed specifically for developers and researchers, providing highly relevant and up-to-date information from across the web. It combines advanced semantic search capabilities with AI understanding to deliver more accurate and contextually relevant results than traditional search engines.

With Exa, you can:

  • Search with natural language: Find information using conversational queries and questions
  • Get precise results: Receive highly relevant search results with semantic understanding
  • Access up-to-date information: Retrieve current information from across the web
  • Find similar content: Discover related resources based on content similarity
  • Extract webpage contents: Retrieve and process the full text of web pages
  • Answer questions with citations: Ask questions and receive direct answers with supporting sources
  • Run deep research: Use Exa Agent for multi-step research, list building, and enrichment
  • Return structured data: Supply a JSON schema and get typed fields back with field-level citations

In Sim, the Exa integration allows your agents to search the web for information, retrieve content from specific URLs, answer questions with citations, and run deep research with Exa Agent—all programmatically through API calls. This enables your agents to access real-time information from the internet, enhancing their ability to provide accurate, current, and relevant responses. The integration is particularly valuable for research tasks, information gathering, content discovery, and answering questions that require up-to-date information from across the web.

Migration notes. Exa has retired its standalone Research endpoint — use the Agent operation for deep research. Workflows still configured with the old Research operation are routed to Agent automatically. Exa has also deprecated Find Similar Links in favor of Search, and livecrawl in favor of maxAgeHours.

Usage Instructions

Integrate Exa into the workflow. Can search the web, get page contents, find similar links, answer a question with citations, and run deep research with Exa Agent.

Actions

Search the web using Exa AI. Returns relevant search results with titles, URLs, and text snippets.

Input

ParameterTypeRequiredDescription
querystringYesThe search query to execute
numResultsnumberNoNumber of results to return (1-100). Default: 10
typestringNoSearch type: "instant", "fast", "auto", "deep-lite", "deep", or "deep-reasoning". Default: "auto"
includeDomainsstringNoComma-separated list of domains to include in results (e.g., "github.com, stackoverflow.com")
excludeDomainsstringNoComma-separated list of domains to exclude from results (e.g., "reddit.com, pinterest.com")
categorystringNoFilter by category: company, publication, news, personal site, financial report, people
textbooleanNoInclude full text content in results (default: false)
highlightsbooleanNoInclude highlighted snippets in results (default: false)
summarybooleanNoInclude AI-generated summaries in results (default: false)
summaryQuerystringNoQuery to focus the generated summaries on a specific question
subpagesnumberNoNumber of subpages to crawl per result (0-100). Default: 0
subpageTargetstringNoComma-separated keywords to target specific subpages (e.g., "docs,pricing,about")
extrasLinksnumberNoNumber of links to extract from each result page (0-1000). Default: 0
extrasImageLinksnumberNoNumber of image URLs to extract from each result page (0-1000). Default: 0
outputSchemajsonNoJSON Schema describing a synthesized answer to build from the results. Returned in structuredOutput.
systemPromptstringNoAdditional guidance for generating the synthesized output
userLocationstringNoTwo-letter ISO country code to localize results (e.g., "US")
maxAgeHoursnumberNoCache freshness in hours (-1 to 720). 0 always crawls live, -1 uses cache only. Cannot be combined with livecrawl.
livecrawlTimeoutnumberNoLive crawl timeout in milliseconds (max 90000). Default: 10000
livecrawlstringNoDeprecated: use maxAgeHours instead. Live crawling mode: never, fallback, always, or preferred
startPublishedDatestringNoOnly include results published on or after this ISO 8601 date (e.g., "2024-01-01" or "2024-01-01T00:00:00.000Z")
endPublishedDatestringNoOnly include results published on or before this ISO 8601 date
startCrawlDatestringNoDeprecated: use startPublishedDate. Only include results crawled on or after this ISO 8601 date
endCrawlDatestringNoDeprecated: use endPublishedDate. Only include results crawled on or before this ISO 8601 date
apiKeystringYesExa AI API Key
pricingcustomNoNo description
rateLimitstringNoNo description

Output

ParameterTypeDescription
resultsarraySearch results with titles, URLs, and text snippets
idstringResult identifier, usable as an id on the Get Contents operation
titlestringThe title of the search result
urlstringThe URL of the search result
publishedDatestringDate when the content was published
authorstringThe author of the content
summarystringA brief summary of the content
faviconstringURL of the site's favicon
imagestringURL of a representative image from the page
textstringText snippet or full content from the page
highlightsarrayRelevant snippets extracted from the page
highlightScoresarraySimilarity score for each highlight
subpagesjsonCrawled subpages of the result
entitiesjsonStructured entity data for company, people, and publication results
extrasjsonExtracted links and image links when requested
scorenumberRelevance score. Only returned by the legacy neural search type
requestIdstringExa request identifier, useful for support
structuredOutputjsonSynthesized answer matching outputSchema, when one was supplied
groundingjsonField-level citations backing the synthesized output

exa_get_contents

Retrieve the contents of webpages using Exa AI. Returns the title, text content, and optional summaries for each URL.

Input

ParameterTypeRequiredDescription
urlsstringNoComma-separated list of URLs to retrieve content from (1-100). Provide either urls or ids, not both.
idsstringNoComma-separated list of result IDs from a prior Exa search (1-100). Provide either urls or ids, not both.
textbooleanNoIf true, returns full page text with default settings. If false, disables text return.
summarybooleanNoInclude an AI-generated summary of each page (default: false)
summaryQuerystringNoQuery to guide the summary generation
subpagesnumberNoNumber of subpages to crawl from the provided URLs (0-100)
subpageTargetstringNoComma-separated keywords to target specific subpages (e.g., "docs,tutorial,about")
highlightsbooleanNoInclude highlighted snippets in results (default: false)
extrasLinksnumberNoNumber of links to extract from each page (0-1000). Default: 0
extrasImageLinksnumberNoNumber of image URLs to extract from each page (0-1000). Default: 0
maxAgeHoursnumberNoCache freshness in hours (-1 to 720). 0 always crawls live, -1 uses cache only. Cannot be combined with livecrawl.
livecrawlTimeoutnumberNoLive crawl timeout in milliseconds (max 90000). Default: 10000
livecrawlstringNoDeprecated: use maxAgeHours instead. Live crawling mode: never, fallback, always, or preferred
apiKeystringYesExa AI API Key
pricingcustomNoNo description
rateLimitstringNoNo description

Output

ParameterTypeDescription
resultsarrayRetrieved content from URLs with title, text, and summaries
idstringExa identifier for the retrieved document
urlstringThe URL that content was retrieved from
titlestringThe title of the webpage
textstringThe full text content of the webpage
summarystringAI-generated summary of the webpage content
highlightsarrayRelevant snippets extracted from the page
highlightScoresarraySimilarity score for each highlight
subpagesjsonCrawled subpages of the document
entitiesjsonStructured entity data for company, people, and publication pages
extrasjsonExtracted links and image links when requested
statusesjsonPer-URL crawl outcome, showing which pages succeeded and whether they came from cache
requestIdstringExa request identifier, useful for support

Find webpages similar to a given URL using Exa AI. Deprecated by Exa in favor of Search — prefer Search for new workflows.

Input

ParameterTypeRequiredDescription
urlstringYesThe URL to find similar links for
numResultsnumberNoNumber of similar links to return (1-100). Default: 10
textbooleanNoWhether to include the full text of the similar pages
includeDomainsstringNoComma-separated list of domains to include in results (e.g., "github.com, stackoverflow.com")
excludeDomainsstringNoComma-separated list of domains to exclude from results (e.g., "reddit.com, pinterest.com")
excludeSourceDomainbooleanNoExclude the source domain from results (default: false)
categorystringNoFilter by category: company, publication, news, personal site, financial report, people
highlightsbooleanNoInclude highlighted snippets in results (default: false)
summarybooleanNoInclude AI-generated summaries in results (default: false)
maxAgeHoursnumberNoCache freshness in hours (-1 to 720). 0 always crawls live, -1 uses cache only. Cannot be combined with livecrawl.
livecrawlTimeoutnumberNoLive crawl timeout in milliseconds (max 90000). Default: 10000
livecrawlstringNoDeprecated: use maxAgeHours instead. Live crawling mode: never, fallback, always, or preferred
apiKeystringYesExa AI API Key
pricingcustomNoNo description
rateLimitstringNoNo description

Output

ParameterTypeDescription
similarLinksarraySimilar links found with titles, URLs, and text snippets
idstringExa identifier for the similar page
titlestringThe title of the similar webpage
urlstringThe URL of the similar webpage
textstringText snippet or full content from the similar webpage
summarystringAI-generated summary of the similar webpage
highlightsarrayRelevant snippets extracted from the page
scorenumberSimilarity score indicating how similar the page is
requestIdstringExa request identifier, useful for support

exa_answer

Get an AI-generated answer to a question with citations from the web using Exa AI.

Input

ParameterTypeRequiredDescription
querystringYesThe question to answer
textbooleanNoInclude the full page text of each cited source (default: false). This does not affect the answer itself.
outputSchemajsonNoJSON Schema describing the answer shape. When supplied, the answer is returned as a structured object instead of a string.
apiKeystringYesExa AI API Key
pricingcustomNoNo description
rateLimitstringNoNo description

Output

ParameterTypeDescription
answerjsonAI-generated answer to the question. A string, or an object matching outputSchema when one was supplied.
citationsarraySources and citations for the answer
idstringExa identifier for the cited source
titlestringThe title of the cited source
urlstringThe URL of the cited source
textstringFull page text of the cited source, when text is enabled
authorstringThe author of the cited source
publishedDatestringPublication date of the cited source
requestIdstringExa request identifier, useful for support

exa_agent

Run a deep research task with Exa Agent. Handles multi-step list building, enrichment, and research, returning a written answer with field-level citations and optional structured output.

Input

ParameterTypeRequiredDescription
querystringYesThe research question or instructions for the agent
effortstringNoCost and depth tradeoff: minimal, low, medium, high, xhigh, or auto (default: auto)
outputSchemajsonNoJSON Schema describing the structured result to return. Returned in the structured output.
systemPromptstringNoAdditional guidance for how the agent should behave or format its answer
previousRunIdstringNoID of a completed agent run to continue from, for follow-up questions
apiKeystringYesExa AI API Key
pricingcustomNoNo description
rateLimitstringNoNo description

Output

ParameterTypeDescription
runIdstringIdentifier of the agent run, reusable as previousRunId
statusstringFinal status of the agent run
stopReasonstringWhy the agent stopped, such as schema_satisfied
textstringThe written answer produced by the agent
structuredjsonStructured result matching outputSchema, when one was supplied
groundingjsonField-level citations backing the agent output
researcharrayThe agent answer in the shape the retired Research operation emitted, so workflows that reference it keep resolving

On this page