BytePlus
Web search and page content retrieval.
AI-oriented real-time web search.
Run a real-time web search built for AI agents and return a ranked list of titled results with links and snippets. Query is required; narrow the result set with Count (≤ 20), Filter (restrict to Sites or exclude BlockHosts), Language, and TimeRange. The response wraps ResponseMetadata.RequestId and a Result list of web results. Use it for RAG retrieval augmentation, competitive/PR monitoring, fact-checking, and content sourcing; pair each result URL with post_byteplus_fetch to pull full page content.
- Тип: stringQueryмакс. длина:400обязательно
The search query. Required. Max 400 characters; the upstream engine also effectively caps around 50 words.
- Тип: integerCountмакс.:20
Number of results to return. Optional; default 10, maximum 20.
- Тип: objectFilter
Optional result filter. Both fields are pipe-separated strings of full domains (max 5 each).
- BlockТип: string
Hosts Exclude results from these full domains. Pipe-separated, max 5, e.g. "reddit.com|quora.com".
- SitesТип: string
Restrict results to these full domains. Pipe-separated, max 5, e.g. "bytedance.com|byteplus.com". (Sending an array returns 10400 Invalid Parameter.)
- Тип: stringLanguage
Optional language hint in the upstream format, e.g. EN, ZH-HANS, ZH-HANT.
- Time
Range Optional recency window. One of the named windows OneDay / OneWeek / OneMonth / OneYear, or a custom range "YYYY-MM-DD..YYYY-MM-DD". Omit for no time filter. NOTE: values like "week"/"month" are silently ignored upstream.
- Тип: string enum
Optional recency window. One of the named windows OneDay / OneWeek / OneMonth / OneYear, or a custom range "YYYY-MM-DD..YYYY-MM-DD". Omit for no time filter. NOTE: values like "week"/"month" are silently ignored upstream.
значения- One
Day - One
Week - One
Month - One
Year
- Тип: object200
Search completed successfully.
Resultholds the ranked web results.- Тип: objectResponse
Metadata Upstream request metadata.
- ActionТип: string
- RegionТип: string
- RequestТип: string
Id Unique identifier for this request.
- ServiceТип: string
- VersionТип: string
- Тип: objectResult
Search result payload.
- ChoicesТип: array object[] | null может быть null
Reserved; null unless applicable.
Пустой объект - LogТип: string
Id Upstream log id (equals ResponseMetadata.RequestId).
- ResultТип: integer
Count Number of web results returned.
- SearchТип: object
Context Echo of the resolved query context.
- OriginТип: string
Query - SearchТип: string
Type
- TimeТип: integer
Cost Upstream processing time in milliseconds.
- UsageТип: object может быть null
Reserved; null unless applicable.
- WebТип: array object[]
Results Ranked list of web results.
- IdТип: string
Opaque result id.
- LogoТип: string
Url Signed site logo URL (time-limited).
- PublishТип: string
Time Publish time in ISO 8601 (may be empty).
- PublishТип: integer
Time Unix Publish time as Unix seconds (0 if unknown).
- SiteТип: string
Name Source site name (may be empty).
- SnippetТип: string
Short text snippet from the page.
- SortТип: integer
Id 1-based rank of the result.
- SummaryТип: string
Longer summary of the page content.
- TitleТип: string
Result title.
- UrlТип: string
Result URL.
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
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
}
}