Skip to main content
POST
搜索网络
搜索开放网页,返回一份很精简的结果列表。⚠️ 虽然是 POST,参数却放在 query string 里 —— query(必填)、max_num_results(默认 10,最大 100),以及限定年份区间的 as_ylo/as_yhi不接受 JSON 请求体。返回一个检索 idresults[],每条只有 titlelinksnippet。实测约 4 秒,响应体约 600 字节。它的长处正是返回得少,适合只需要知道「有什么」的 agent。它不给页面正文 —— 需要正文的话,post_tavily_search 在同一次调用里就能返回。记住那个 idpost_scholar_search_explain 需要它。

授权

Authorization
string
header
必填

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

查询参数

query
string
必填

学术资料搜索查询

示例:

"machine learning"

max_num_results
integer
默认值:10

返回的搜索结果最大数量,最多 100 条

必填范围: 1 <= x <= 100
as_ylo
integer | null

出版年份下限

必填范围: 1900 <= x <= 2030
as_yhi
integer | null

出版年份上限

必填范围: 1900 <= x <= 2030

响应

搜索成功响应

id
string
必填

搜索请求的唯一标识符

results
object[]
必填

网页搜索结果列表