网页搜索

POST https://open.feiyutoken.com/v1/tools/search

请求参数

请求体是 JSON，字段如下：

参数	类型	必填	说明
query	string	是	搜索词，1～128 个 Unicode 字符，不能全为空白
count	integer	否	返回条数，1～50，默认 10
ori_question	string	否	触发搜索的用户原始问题，1～128 个字符，帮助搜索服务理解意图；传 null 视为未提供
localization	string	否	用于优先返回本地化搜索结果的 IP 地址，默认空字符串
need_content	boolean	否	是否在 content 里返回网页正文；默认 false，此时 content 恒为空字符串

请求体里的未知字段会被忽略。

搜索语法

query 支持 site:、-site:、-、-"..."、"..."、lang:、after:、before: 等操作符，可以组合使用。完整列表与组合示例见 网页搜索与抓取。

请求示例

curl https://open.feiyutoken.com/v1/tools/search \
  -H "Authorization: Bearer <你的飞鱼Token API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "大模型 API 网关",
    "count": 5,
    "need_content": true
  }'

响应

请求成功时返回 HTTP 200 与 results 数组；没有匹配结果时 results 为空数组， 仍然算成功。

{
  "results": [
    {
      "rerank_score": 2.4,
      "title": "示例文章标题",
      "url": "https://example.com/article",
      "snippet": "与查询相关的一段短摘要，通常 100～200 字符。",
      "summary": "更长的一段摘要，通常 600～800 字符，适合直接交给模型阅读。",
      "content": "网页正文……",
      "site_name": "Example",
      "site_icon": "https://example.com/favicon.ico",
      "date": "2026-06-01T00:00:00+00:00",
      "authority": 3
    }
  ]
}

results 中每一项的字段：

字段	类型	说明
rerank_score	number	排序分数，0～3 分，综合考虑相关性、权威性与时效性；大于等于 1.5 分为优质结果
title	string	结果标题
url	string	结果链接
snippet	string	短摘要，与 query 相关，通常 100～200 字符，适合前端展示
summary	string	长摘要，与 query 相关，通常 600～800 字符，适合给模型阅读
content	string	网页正文；need_content 为 false 或正文缺失时为空字符串
site_name	string 或 null	站点名称，缺失时为 null
site_icon	string 或 null	站点图标 URL，缺失时为 null
date	string 或 null	发布时间，UTC 的 RFC 3339 格式，未知时为 null
authority	integer	网页权威性，0～4，-1 表示未知；大于等于 3 为高权威结果

错误处理

错误响应使用 OpenAI 兼容格式，param 恒为 null：

{
  "error": {
    "message": "'count' must be between 1 and 50",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request_error"
  }
}

各状态码的含义与是否重试，见网页搜索与抓取 · 错误处理。

计费与限速

Search 按成功请求次数计费，每 1,000 次成功请求 5 元；只有返回 HTTP 200 且 results 非空的请求才计费。 Search 的账号级 QPS 限制为 100，超过限制返回 HTTP 429。详见计费与限速。