请求参数
querystring必填搜索关键词,1–128 个 Unicode 字符,不能全为空白。数据库支持站点、排除词、短语、语言和日期过滤;实时搜索的语法支持取决于搜索引擎。
countinteger可选返回条数,范围 1–50;实际结果可能少于请求条数。
默认值:
10need_contentboolean可选尽力读取网页 Markdown;正文读取失败时,该条结果的 content 可以为空字符串。
默认值:
falseori_questionstring可选兼容字段,接受但不参与检索;当前接口未单独限制其长度。
localizationstring可选本地化 IP 地址。当前服务接受此字段,但不进行地理位置查询。
platformsstring[]可选搜索引擎数组,可选 bing、baidu、google、soso,最多 4 项;支持上游别名并去重。
默认值:
["bing"]search_modestring可选auto、省略或 null:使用服务配置;database:只查库;realtime:实时搜索。实时搜索可能后台入库。默认单引擎预算 45 秒,聚合预算上限 120 秒,正文读取另有预算;这些不是端到端时效承诺。
可选值:
auto、database、realtime。默认值:
autoscopestring可选原版支持 web、archive。开放平台提供 web;archive 对应未隔离租户的归档检索,当前不开放。
可选值:
web。默认值:
web
返回字段
resultsarray结果列表;没有匹配内容时允许为空数组。
results[].titlestring页面标题。
results[].urlstring来源页面的完整地址。
results[].summarystring供快速筛选的摘要。
results[].contentstring开启
need_content时读取此字段。results[].rerank_scorenumber数据库分支的词法相关性分数;实时分支为 0.0。
results[].snippetstring搜索结果的原始摘要。
results[].site_namestring | null来源站点名称。
results[].site_iconstring | null来源站点图标。
results[].datestring | null数据库分支为入库日期,不是发布日期;实时分支为 null。
results[].authorityinteger权威性标识,未知时为 -1。
usage.multipliernumber本次消耗倍率,保留两位精度。
请求说明
同步接口。 请求完成后返回 HTTP 200 OK,直接读取响应的 results 中的搜索结果。本接口无需获取任务 ID,也无需轮询任务状态。
| 必填请求头 | 取值 |
|---|---|
Authorization | Bearer YOUR_API_KEY,使用控制台创建的 API Key。 |
Content-Type | application/json |
摘要与正文
先用标题和摘要筛选来源。需要阅读原文时开启 need_content 或调用网页抓取。搜索返回资料,不自动生成回答。
空结果和失败
HTTP 200 且 results: [] 表示搜索完成但没有结果;参数不合法、权限不足或服务故障应返回错误响应,不能合并成空列表。结果顺序与覆盖范围可能随时间变化。
搜索模式与等待时间
database 只检索已入库文章。realtime 同步调用搜索引擎,可在后台入库,不创建供调用方轮询的搜索任务。auto 根据服务配置选择分支;无命中时可能返回空数组并后台补采,也可能回退实时搜索。
默认单平台预算 45 秒,聚合上限 120 秒,need_content=true 时还有额外的有界正文读取。实际等待时间受部署配置和网络影响。
计费
¥0.001×倍率/次
所有搜索模式使用同一基础价,按基础价 × 响应的 usage.multiplier 结算。倍率为 0 或请求失败时不收费。