Ricerca web in tempo reale orientata all'AI.
BytePlus
Web search and page content retrieval.
Ricerca web in tempo reale orientata all'AI.
Esegue una ricerca web in tempo reale pensata per agenti AI e restituisce un elenco ordinato di risultati con titolo, link e snippet. Query è obbligatorio; restringi l'insieme dei risultati con Count (≤ 20), Filter (limita a Sites o escludi BlockHosts), Language e TimeRange. La risposta include ResponseMetadata.RequestId e un elenco Result di risultati web. Usalo per l'augmentation del retrieval RAG, il monitoraggio competitivo/PR, il fact-checking e il reperimento di contenuti; abbina ogni URL di risultato a post_byteplus_fetch per recuperare il contenuto completo della pagina.
Riferimento prezzi
- Misurazione: base di costo fissa per richiesta riuscita.
- Stima di riferimento per richiesta: USD 0.0048.
- Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.
Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: stringQuerylunghezza massima:400obbligatorio
La query di ricerca. Obbligatoria. Max 400 caratteri; il motore upstream limita effettivamente anche a circa 50 parole.
- Tipo: integerCountmax:20
Numero di risultati da restituire. Facoltativo; valore predefinito 10, massimo 20.
- Tipo: objectFilter
Filtro dei risultati facoltativo. Entrambi i campi sono stringhe di domini completi separate da pipe (max 5 ciascuno).
- BlockTipo: string
Hosts Escludi i risultati da questi domini completi. Separati da pipe, max 5, ad esempio "reddit.com|quora.com".
- SitesTipo: string
Limita i risultati a questi domini completi. Separati da pipe, max 5, ad esempio "bytedance.com|byteplus.com". (L'invio di un array restituisce 10400 Invalid Parameter.)
- Tipo: stringLanguage
Suggerimento di lingua facoltativo nel formato upstream, ad esempio EN, ZH-HANS, ZH-HANT.
- Time
Range Finestra di aggiornamento facoltativa. Una delle finestre denominate OneDay / OneWeek / OneMonth / OneYear, oppure un intervallo personalizzato "YYYY-MM-DD..YYYY-MM-DD". Omettere per non applicare filtri temporali. NOTA: i valori come "week"/"month" vengono ignorati silenziosamente upstream.
- Tipo: string enum
Finestra di aggiornamento facoltativa. Una delle finestre denominate OneDay / OneWeek / OneMonth / OneYear, oppure un intervallo personalizzato "YYYY-MM-DD..YYYY-MM-DD". Omettere per non applicare filtri temporali. NOTA: i valori come "week"/"month" vengono ignorati silenziosamente upstream.
valori- One
Day - One
Week - One
Month - One
Year
- Tipo: object200
Ricerca completata con successo.
Resultcontiene i risultati web ordinati.- Tipo: objectResponse
Metadata Metadati della richiesta upstream.
- ActionTipo: string
- RegionTipo: string
- RequestTipo: string
Id Identificatore univoco di questa richiesta.
- ServiceTipo: string
- VersionTipo: string
- Tipo: objectResult
Payload dei risultati della ricerca.
- ChoicesTipo: array object[] | null
Riservato; null se non applicabile.
Oggetto vuoto - LogTipo: string
Id ID log upstream (uguale a ResponseMetadata.RequestId).
- ResultTipo: integer
Count Numero di risultati web restituiti.
- SearchTipo: object
Context Echo del contesto di query risolto.
- OriginTipo: string
Query - SearchTipo: string
Type
- TimeTipo: integer
Cost Tempo di elaborazione upstream in millisecondi.
- UsageTipo: object | null
Riservato; null se non applicabile.
- WebTipo: array object[]
Results Elenco ordinato dei risultati web.
- IdTipo: string
ID opaco del risultato.
- LogoTipo: string
Url URL firmato del logo del sito (a tempo limitato).
- PublishTipo: string
Time Ora di pubblicazione in ISO 8601 (può essere vuota).
- PublishTipo: integer
Time Unix Ora di pubblicazione in secondi Unix (0 se sconosciuta).
- SiteTipo: string
Name Nome del sito di origine (può essere vuoto).
- SnippetTipo: string
Breve estratto di testo dalla pagina.
- SortTipo: integer
Id Posizione del risultato, con base 1.
- SummaryTipo: string
Riepilogo più lungo del contenuto della pagina.
- TitleTipo: string
Titolo del risultato.
- UrlTipo: string
URL del risultato.
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
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
}
}