BytePlus
Web search and page content retrieval.
Echtzeit-Websuche für KI-Anwendungen.
Führt eine Echtzeit-Websuche aus, die für KI-Agenten entwickelt wurde, und gibt eine sortierte Liste betitelter Ergebnisse mit Links und Snippets zurück. Query ist erforderlich; schränken Sie die Treffermenge mit Count (≤ 20), Filter (Beschränkung auf Sites oder Ausschluss von BlockHosts), Language und TimeRange ein. Die Antwort umfasst ResponseMetadata.RequestId und eine Result-Liste mit Web-Ergebnissen. Verwenden Sie dies für RAG-Retrieval-Augmentierung, Wettbewerbs-/PR-Monitoring, Faktenprüfung und Content-Beschaffung; kombinieren Sie jede Ergebnis-URL mit post_byteplus_fetch, um den vollständigen Seiteninhalt abzurufen.
Preisreferenz
- Abrechnung: Feste Kostenbasis pro erfolgreicher Anfrage.
- Referenzschätzung pro Anfrage: USD 0.0048.
- Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.
Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.
- Typ: stringQuerymax. Länge:400erforderlich
Die Suchanfrage. Erforderlich. Max. 400 Zeichen; die Upstream-Engine begrenzt effektiv außerdem auf etwa 50 Wörter.
- Typ: integerCountmax.:20
Anzahl der zurückzugebenden Ergebnisse. Optional; Standard 10, maximal 20.
- Typ: objectFilter
Optionaler Ergebnisfilter. Beide Felder sind durch Pipes getrennte Zeichenketten vollständiger Domains (je max. 5).
- BlockTyp: string
Hosts Ergebnisse von diesen vollständigen Domains ausschließen. Durch Pipes getrennt, max. 5, z. B. "reddit.com|quora.com".
- SitesTyp: string
Ergebnisse auf diese vollständigen Domains beschränken. Durch Pipes getrennt, max. 5, z. B. "bytedance.com|byteplus.com". (Das Senden eines Arrays führt zu 10400 Invalid Parameter.)
- Typ: stringLanguage
Optionaler Sprachhinweis im Upstream-Format, z. B. EN, ZH-HANS, ZH-HANT.
- Time
Range Optionales Zeitfenster für aktuelle Ergebnisse. Entweder eines der benannten Fenster OneDay / OneWeek / OneMonth / OneYear oder ein benutzerdefinierter Bereich "YYYY-MM-DD..YYYY-MM-DD". Weglassen, um nicht nach Zeit zu filtern. HINWEIS: Werte wie "week"/"month" werden upstream stillschweigend ignoriert.
- Typ: string enum
Optionales Zeitfenster für aktuelle Ergebnisse. Entweder eines der benannten Fenster OneDay / OneWeek / OneMonth / OneYear oder ein benutzerdefinierter Bereich "YYYY-MM-DD..YYYY-MM-DD". Weglassen, um nicht nach Zeit zu filtern. HINWEIS: Werte wie "week"/"month" werden upstream stillschweigend ignoriert.
Werte- One
Day - One
Week - One
Month - One
Year
- Typ: object200
Suche erfolgreich abgeschlossen.
Resultenthält die sortierten Web-Ergebnisse.- Typ: objectResponse
Metadata Metadaten der Upstream-Anfrage.
- ActionTyp: string
- RegionTyp: string
- RequestTyp: string
Id Eindeutige Kennung dieser Anfrage.
- ServiceTyp: string
- VersionTyp: string
- Typ: objectResult
Payload des Suchergebnisses.
- ChoicesTyp: array object[] | null
Reserviert; null, sofern nicht zutreffend.
Leeres Objekt - LogTyp: string
Id Upstream-Log-ID (entspricht ResponseMetadata.RequestId).
- ResultTyp: integer
Count Anzahl der zurückgegebenen Web-Ergebnisse.
- SearchTyp: object
Context Echo des aufgelösten Abfragekontexts.
- OriginTyp: string
Query - SearchTyp: string
Type
- TimeTyp: integer
Cost Verarbeitungszeit upstream in Millisekunden.
- UsageTyp: object | null
Reserviert; null, sofern nicht zutreffend.
- WebTyp: array object[]
Results Sortierte Liste der Web-Ergebnisse.
- IdTyp: string
Opake Ergebnis-ID.
- LogoTyp: string
Url Signierte Logo-URL der Website (zeitlich begrenzt).
- PublishTyp: string
Time Veröffentlichungszeit im Format ISO 8601 (kann leer sein).
- PublishTyp: integer
Time Unix Veröffentlichungszeit als Unix-Sekunden (0, wenn unbekannt).
- SiteTyp: string
Name Name der Quell-Website (kann leer sein).
- SnippetTyp: string
Kurzer Textauszug aus der Seite.
- SortTyp: integer
Id Rang des Ergebnisses, 1-basiert.
- SummaryTyp: string
Längere Zusammenfassung des Seiteninhalts.
- TitleTyp: string
Titel des Ergebnisses.
- UrlTyp: string
URL des Ergebnisses.
application/json - 400
Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
- 401
Ein gültiger Felo-API-Schlüssel ist erforderlich.
- 402
Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
- 403
Das Konto ist für diesen Vorgang nicht berechtigt.
- 429
Ein Anfrage- oder Ausgabenlimit wurde erreicht.
- 502
Der Dienst konnte die Anfrage nicht abschließen.
- 503
Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
- 504
Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
- default
Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden
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
}
}