网页搜索

用关键词查找网页,返回标题、摘要、来源和可选正文。

POSThttps://api.zleap.com/v1/tools/search同步接口

请求参数

querystring必填

搜索关键词,1–128 个 Unicode 字符,不能全为空白。数据库支持站点、排除词、短语、语言和日期过滤;实时搜索的语法支持取决于搜索引擎。

countinteger可选

返回条数,范围 1–50;实际结果可能少于请求条数。

默认值:10

need_contentboolean可选

尽力读取网页 Markdown;正文读取失败时,该条结果的 content 可以为空字符串。

默认值:false

ori_questionstring可选

兼容字段,接受但不参与检索;当前接口未单独限制其长度。

localizationstring可选

本地化 IP 地址。当前服务接受此字段,但不进行地理位置查询。

platformsstring[]可选

搜索引擎数组,可选 bing、baidu、google、soso,最多 4 项;支持上游别名并去重。

默认值:["bing"]

search_modestring可选

auto、省略或 null:使用服务配置;database:只查库;realtime:实时搜索。实时搜索可能后台入库。默认单引擎预算 45 秒,聚合预算上限 120 秒,正文读取另有预算;这些不是端到端时效承诺。

可选值:auto、database、realtime。

默认值:auto

scopestring可选

原版支持 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,也无需轮询任务状态。

必填请求头取值
AuthorizationBearer YOUR_API_KEY,使用控制台创建的 API Key。
Content-Typeapplication/json

摘要与正文

先用标题和摘要筛选来源。需要阅读原文时开启 need_content 或调用网页抓取。搜索返回资料,不自动生成回答。

空结果和失败

HTTP 200 且 results: [] 表示搜索完成但没有结果;参数不合法、权限不足或服务故障应返回错误响应,不能合并成空列表。结果顺序与覆盖范围可能随时间变化。

搜索模式与等待时间

database 只检索已入库文章。realtime 同步调用搜索引擎,可在后台入库,不创建供调用方轮询的搜索任务。auto 根据服务配置选择分支;无命中时可能返回空数组并后台补采,也可能回退实时搜索。

默认单平台预算 45 秒,聚合上限 120 秒,need_content=true 时还有额外的有界正文读取。实际等待时间受部署配置和网络影响。

计费

¥0.001×倍率/次

所有搜索模式使用同一基础价,按基础价 × 响应的 usage.multiplier 结算。倍率为 0 或请求失败时不收费。