BytePlus
Web search and page content retrieval.
面向 AI 的实时网络搜索。
运行专为 AI 智能体构建的实时网络搜索，返回带标题、链接和摘要的排序结果列表。Query 为必填项；可用 Count（≤ 20）、Filter（限定 Sites 或排除 BlockHosts）、Language 和 TimeRange 收窄结果集。响应封装了 ResponseMetadata.RequestId 和网络结果列表 Result。适用于 RAG 检索增强、竞品/公关监测、事实核查和内容取材；将每个结果 URL 与 post_byteplus_fetch 配合，即可拉取完整页面内容。
计费参考
- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：0.0048 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: stringQuery最大长度:400必填
搜索查询。必填。最多 400 个字符；上游引擎实际上还会限制在约 50 个词。
- 类型: integerCount最大值:20
要返回的结果数量。可选；默认 10，最大 20。
- 类型: objectFilter
可选的结果筛选。两个字段都是以竖线分隔的完整域名字符串（各最多 5 个）。
- Block类型: string
Hosts 排除来自这些完整域名的结果。以竖线分隔，最多 5 个，例如“reddit.com|quora.com”。
- Sites类型: string
将结果限定为这些完整域名。以竖线分隔，最多 5 个，例如“bytedance.com|byteplus.com”。（发送数组会返回 10400 Invalid Parameter。）
- 类型: stringLanguage
可选的语言提示，采用上游格式，例如 EN、ZH-HANS、ZH-HANT。
- Time
Range 可选的时间窗口。可取命名窗口 OneDay / OneWeek / OneMonth / OneYear 之一，或自定义范围“YYYY-MM-DD..YYYY-MM-DD”。省略则不做时间筛选。注意：像“week”/“month”这样的值会被上游静默忽略。
- 类型: string 枚举
可选的时间窗口。可取命名窗口 OneDay / OneWeek / OneMonth / OneYear 之一，或自定义范围“YYYY-MM-DD..YYYY-MM-DD”。省略则不做时间筛选。注意：像“week”/“month”这样的值会被上游静默忽略。
值- One
Day - One
Week - One
Month - One
Year
- 类型: object200
搜索成功完成。
Result包含排序后的网络结果。- 类型: objectResponse
Metadata 上游请求元数据。
- Action类型: string
- Region类型: string
- Request类型: string
Id 此请求的唯一标识符。
- Service类型: string
- Version类型: string
- 类型: objectResult
搜索结果负载。
- Choices类型: array object[] | null
保留字段；不适用时为 null。
空对象 - Log类型: string
Id 上游日志 id（等于 ResponseMetadata.RequestId）。
- Result类型: integer
Count 返回的网络结果数量。
- Search类型: object
Context 已解析查询上下文的回显。
- Origin类型: string
Query - Search类型: string
Type
- Time类型: integer
Cost 上游处理时间，单位毫秒。
- Usage类型: object | null
保留字段；不适用时为 null。
- Web类型: array object[]
Results 排序后的网络结果列表。
- Id类型: string
不透明的结果 id。
- Logo类型: string
Url 带签名的站点 Logo URL（有时效）。
- Publish类型: string
Time ISO 8601 格式的发布时间（可能为空）。
- Publish类型: integer
Time Unix 发布时间，Unix 秒（未知时为 0）。
- Site类型: string
Name 来源站点名称（可能为空）。
- Snippet类型: string
来自页面的简短文本片段。
- Sort类型: integer
Id 结果的排名（从 1 开始）。
- Summary类型: string
页面内容的较长摘要。
- Title类型: string
结果标题。
- Url类型: string
结果 URL。
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/byteplus/web-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"Query": "OpenAI news"
}'
{
"ResponseMetadata": {
"RequestId": "20260904155503A787EC832774768DC56F",
"Action": "",
"Version": "",
"Service": "",
"Region": ""
},
"Result": {
"ResultCount": 3,
"WebResults": [
{
"Id": "19b903d59c017bbb04c7832574500d49",
"SortId": 1,
"Title": "OpenAI News | OpenAI",
"SiteName": "OpenAI",
"Url": "https://openai.com/news/",
"Snippet": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"Summary": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"PublishTime": "2026-09-03T07:50:20+08:00",
"PublishTimeUnix": 1788393020,
"LogoUrl": "https://p16-bpsearch-sign.ibyteimg.com/...<signed>"
}
],
"SearchContext": {
"OriginQuery": "OpenAI latest news",
"SearchType": "web"
},
"TimeCost": 935,
"LogId": "20260904155503A787EC832774768DC56F",
"Choices": null,
"Usage": null
}
}