Skip to main content
POST
执行神经语义网页搜索。
按语义而不是关键词搜索网页。query 必填;可用 categoryincludeDomainsexcludeDomainsstartPublishedDateendPublishedDate 收窄,用 numResults 控制条数。返回 requestIdresolvedSearchTypesearchTimecostDollarsresults[](含 idtitleurl)。id 就是 URL,也正是 post_exa_contents 要的东西。实测 1.4 秒,是这里最快的搜索。按次固定计费 $0.08。⚠️ 结果默认不带页面正文:要么传 contents,要么再调一次 post_exa_contents。查询是一段描述而不是关键词时,选它而不是 post_tavily_search;想在同一次调用里拿到正文,选 Tavily;想要一段写好的答案而不是列表,用 post_exa_answer

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
query
string
必填

自然语言搜索查询。

示例:

"latest evaluation frameworks for AI agents"

type
enum<string>
默认值:auto

搜索模式。auto 让 Exa 自行选择;deep 模式以更高延迟换取更高质量的检索。

可用选项:
auto,
fast,
instant,
deep-lite,
deep,
deep-reasoning
numResults
integer
默认值:10

返回的结果数量。

必填范围: 1 <= x <= 100
category
enum<string>

关于优先抓取哪类页面的可选提示。

可用选项:
company,
research paper,
news,
personal site,
financial report,
people
includeDomains
string[]

只返回来自这些域名的结果。

excludeDomains
string[]

排除来自这些域名的结果。

startPublishedDate
string<date-time>

仅返回在该 ISO 8601 日期当天或之后发布的结果。

endPublishedDate
string<date-time>

仅返回在该 ISO 8601 日期当天或之前发布的结果。

contents
object

随每条结果一并返回的内容选项。

outputSchema
object

用于从结果中合成结构化输出的 JSON Schema。

systemPrompt
string

用于引导结构化输出如何生成的指令。

响应

200 - application/json

搜索成功完成。

requestId
string

Exa 请求标识符。

results
object[]

排序后的搜索结果。

output
any | null

结构化输出,仅在提供了 outputSchema 时出现。

costDollars
any | null

上游 Exa 的成本明细。仅供参考;客户计费为固定 $0.08。