BytePlus
Web search and page content retrieval.
Realtime webzoekopdracht voor AI.
Voert een realtime webzoekopdracht uit die voor AI-agenten is gebouwd en retourneert een gerangschikte lijst van getitelde resultaten met links en snippets. Query is vereist; beperk de resultatenset met Count (≤ 20), Filter (beperk tot Sites of sluit BlockHosts uit), Language en TimeRange. De respons omvat ResponseMetadata.RequestId en een Result-lijst met webresultaten. Gebruik het voor RAG-retrievalaugmentatie, concurrentie-/PR-monitoring, factchecking en contentbronnen; combineer elke resultaat-URL met post_byteplus_fetch om de volledige paginainhoud op te halen.
Prijsreferentie
- Metering: Vaste kostenbasis per geslaagd verzoek.
- Referentieschatting per verzoek: USD 0.0048.
- Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.
Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.
- Type: stringQuerymax. lengte:400verplicht
De zoekopdracht. Verplicht. Max. 400 tekens; de upstream-engine beperkt effectief ook tot ongeveer 50 woorden.
- Type: integerCountmax.:20
Aantal resultaten dat wordt geretourneerd. Optioneel; standaard 10, maximaal 20.
- Type: objectFilter
Optioneel resultaatfilter. Beide velden zijn pipe-gescheiden tekenreeksen van volledige domeinen (max. 5 elk).
- BlockType: string
Hosts Sluit resultaten van deze volledige domeinen uit. Pipe-gescheiden, max. 5, bijvoorbeeld "reddit.com|quora.com".
- SitesType: string
Beperk resultaten tot deze volledige domeinen. Pipe-gescheiden, max. 5, bijvoorbeeld "bytedance.com|byteplus.com". (Een array verzenden retourneert 10400 Invalid Parameter.)
- Type: stringLanguage
Optionele taalaanwijzing in de upstream-indeling, bijvoorbeeld EN, ZH-HANS, ZH-HANT.
- Time
Range Optioneel venster voor recente resultaten. Een van de benoemde vensters OneDay / OneWeek / OneMonth / OneYear, of een aangepast bereik "YYYY-MM-DD..YYYY-MM-DD". Weglaten betekent geen tijdfilter. LET OP: waarden zoals "week"/"month" worden upstream stilzwijgend genegeerd.
- Type: string enum
Optioneel venster voor recente resultaten. Een van de benoemde vensters OneDay / OneWeek / OneMonth / OneYear, of een aangepast bereik "YYYY-MM-DD..YYYY-MM-DD". Weglaten betekent geen tijdfilter. LET OP: waarden zoals "week"/"month" worden upstream stilzwijgend genegeerd.
waarden- One
Day - One
Week - One
Month - One
Year
- Type: object200
Zoekopdracht is geslaagd.
Resultbevat de gerangschikte webresultaten.- Type: objectResponse
Metadata Metadata van het upstream-verzoek.
- ActionType: string
- RegionType: string
- RequestType: string
Id Unieke identificatie voor dit verzoek.
- ServiceType: string
- VersionType: string
- Type: objectResult
Payload van het zoekresultaat.
- ChoicesType: array object[] | null
Gereserveerd; null tenzij van toepassing.
Leeg object - LogType: string
Id Upstream-log-id (gelijk aan ResponseMetadata.RequestId).
- ResultType: integer
Count Aantal geretourneerde webresultaten.
- SearchType: object
Context Echo van de opgeloste querycontext.
- OriginType: string
Query - SearchType: string
Type
- TimeType: integer
Cost Verwerkingstijd upstream in milliseconden.
- UsageType: object | null
Gereserveerd; null tenzij van toepassing.
- WebType: array object[]
Results Gerangschikte lijst met webresultaten.
- IdType: string
Ondoorzichtige resultaat-id.
- LogoType: string
Url Ondertekende logo-URL van de site (tijdelijk geldig).
- PublishType: string
Time Publicatietijd in ISO 8601 (kan leeg zijn).
- PublishType: integer
Time Unix Publicatietijd als Unix-seconden (0 als onbekend).
- SiteType: string
Name Naam van de bronsite (kan leeg zijn).
- SnippetType: string
Kort tekstfragment uit de pagina.
- SortType: integer
Id Rang van het resultaat, 1-gebaseerd.
- SummaryType: string
Langere samenvatting van de paginainhoud.
- TitleType: string
Titel van het resultaat.
- UrlType: string
URL van het resultaat.
application/json - 400
Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
- 401
Een geldige Felo-API-sleutel is vereist.
- 402
Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
- 403
Het account mag deze bewerking niet uitvoeren.
- 429
Een verzoek- of bestedingslimiet is bereikt.
- 502
De dienst kon het verzoek niet voltooien.
- 503
De API of factureringsdienst is tijdelijk niet beschikbaar.
- 504
Er is een time-out opgetreden bij het verwerken van het verzoek.
- default
Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken
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
}
}