POST
/
search

Get your Exa API key

Authorizations

x-api-key
string
header
required

Body

application/json
query
string
required

The query string for the search.

category
enum<string>

A data category to focus on.

Available options:
company,
research paper,
news,
pdf,
github,
tweet,
personal site,
linkedin profile,
financial report
contents
object
endCrawlDate
string

Crawl date refers to the date that Exa discovered a link. Results will include links that were crawled before this date. Must be specified in ISO 8601 format.

endPublishedDate
string

Only links with a published date before this will be returned. Must be specified in ISO 8601 format.

excludeDomains
string[]

List of domains to exclude from search results. If specified, no results will be returned from these domains.

excludeText
string[]

List of strings that must not be present in webpage text of results. Currently, only 1 string is supported, of up to 5 words.

includeDomains
string[]

List of domains to include in the search. If specified, results will only come from these domains.

includeText
string[]

List of strings that must be present in webpage text of results. Currently, only 1 string is supported, of up to 5 words.

numResults
integer
default:
10

Number of results to return (up to thousands of results available for custom plans)

Required range: x < 10
startCrawlDate
string

Crawl date refers to the date that Exa discovered a link. Results will include links that were crawled after this date. Must be specified in ISO 8601 format.

startPublishedDate
string

Only links with a published date after this will be returned. Must be specified in ISO 8601 format.

type
enum<string>
default:
auto

The type of search. Neural uses an embeddings-based model, keyword is google-like SERP. Default is auto, which automatically decides between keyword and neural.

Available options:
keyword,
neural,
auto
useAutoprompt
boolean
default:
true

Autoprompt converts your query to an Exa-style query. Enabled by default for auto search, optional for neural search, and not available for keyword search.

Response

200 - application/json
results
object[]

A list of search results containing title, URL, published date, author, and score.

searchType
enum<string>

For auto searches, indicates which search type was selected.

Available options:
neural,
keyword