Skip to main content
POST
执行神经语义网页搜索。
用自然语言 query 搜索公开网页,返回最相关的结果,按语义相关性而非关键词排序。可用 type(从 fastdeep-reasoning)调节检索方式,用 numResults(1–100,默认 10)限制结果数量,并用 categoryincludeDomains/excludeDomains 或发布日期区间收窄范围。 设置 contents 可在每条结果中内联返回页面 texthighlights 或 AI summary;提供 outputSchema(可搭配 systemPrompt)可让 Exa 合成结构化的 output。每次成功请求固定计费 $0.08;上游 4xx 响应不计费。如果你已经知道确切要看哪些页面,post_exa-contents 可以直接获取它们的全文。

授权

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。