curl --request POST \
--url https://api.aisa.one/apis/v1/byteplus/web-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--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
}
}Search API
BytePlus Web Search
AI-oriented real-time web search that returns titled results with links and snippets.
POST
https://api.aisa.one/apis/v1
/
byteplus
/
web-search
curl --request POST \
--url https://api.aisa.one/apis/v1/byteplus/web-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--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
}
}Run a real-time web search built for AI agents and get back a ranked list of titled results with links and snippets.
Query is required; narrow the result set with Count (up to 20), Filter (Sites to restrict, BlockHosts to exclude), Language, and TimeRange. The response wraps ResponseMetadata.RequestId and a Result object whose WebResults array holds each hit (Title, Url, Snippet, Summary, SiteName, PublishTime/PublishTimeUnix), alongside ResultCount, SearchContext, and TimeCost. Billed a flat $0.00528 per successful call; failed requests are not charged. Use it for RAG retrieval augmentation, competitive/PR monitoring, fact-checking, and content sourcing. ⚠️ Results carry links and snippets, not full page text — pair each result URL with post_byteplus_fetch to pull clean, structured page content.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
The search query. Required. Max 400 characters; the upstream engine also effectively caps around 50 words.
Maximum string length:
400Example:
"OpenAI news"
Number of results to return. Optional; default 10, maximum 20.
Required range:
x <= 20Example:
10
Optional result filter. Both fields are pipe-separated strings of full domains (max 5 each).
Show child attributes
Show child attributes
Optional language hint in the upstream format, e.g. EN, ZH-HANS, ZH-HANT.
Example:
"EN"
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.
Available options:
OneDay, OneWeek, OneMonth, OneYear Example:
"OneWeek"