Felo API PlatformFelo API Platform

网页搜索

供应商：Felo · 使用平台余额

认证与接入计费与错误处理

搜索网页，获取可供应用进一步处理的来源列表。需要生成带来源的回答时，请使用联网问答。

示例使用总览中配置的 FELO_API_KEY。调用使用平台余额，不使用 Felo Pro 积分。响应示例仅展示结构，实际内容和可选字段会变化。

接口

POST /api/v1/data/web/search

请求参数

字段类型必填说明
querystring是搜索词，1–4,000 字符
countinteger否期望结果数量，1–50；默认 10
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"检索增强生成 RAG","count":3}'

返回结果

HTTP 200，结果直接位于 JSON 根层级：

{
  "resources": [
    {"title":"示例指南","link":"https://example.com/guide","snippet":"介绍检索增强生成的基本原理。"}
  ],
  "total": 1
}
字段说明
resources返回的网页，每项包含 title、link 和 snippet
total本次返回的资源数量，不是互联网中所有匹配网页的数量

count 是期望数量，不保证一定返回这么多结果。此接口没有游标分页参数。需要获取来源全文时，把 link 交给网页读取。

计费与失败处理

计费单位是一次请求（web.search），不是每个返回的网页。单价见当前价格表。余额或配额错误与成功但无结果是不同情况，处理规则见计费与错误处理。

需要帮助？