Recherche web en temps réel orientée IA.
BytePlus
Web search and page content retrieval.
Recherche web en temps réel orientée IA.
Exécute une recherche web en temps réel conçue pour les agents IA et renvoie une liste classée de résultats avec titre, liens et extraits. Query est requis ; restreignez les résultats avec Count (≤ 20), Filter (limité à Sites ou excluant BlockHosts), Language et TimeRange. La réponse encapsule ResponseMetadata.RequestId et une liste Result de résultats web. Utilisez-la pour l'augmentation de récupération RAG, la veille concurrentielle et presse, la vérification des faits et le sourcing de contenu ; associez l'URL de chaque résultat à post_byteplus_fetch pour récupérer le contenu complet de la page.
Pricing reference
- Comptage : base de coût fixe par requête réussie.
- Estimation de référence par requête : USD 0.0048.
- Multiplicateur de référence du client : 1.0. Ne pas l'appliquer une nouvelle fois à un montant client déjà réglé.
Métadonnées de référence uniquement : ni devis de compte, ni prix garanti, ni plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: stringQuerylongueur max.:400obligatoire
La requête de recherche. Obligatoire. 400 caractères maximum ; le moteur amont plafonne aussi efficacement à environ 50 mots.
- Type: integerCountmax.:20
Nombre de résultats à renvoyer. Facultatif ; 10 par défaut, 20 maximum.
- Type: objectFilter
Filtre de résultats facultatif. Les deux champs sont des chaînes de domaines complets séparées par des barres verticales (5 maximum chacun).
- BlockType: string
Hosts Excluez les résultats de ces domaines complets. Séparés par des barres verticales, 5 maximum, par exemple "reddit.com|quora.com".
- SitesType: string
Limitez les résultats à ces domaines complets. Séparés par des barres verticales, 5 maximum, par exemple "bytedance.com|byteplus.com". (L'envoi d'un tableau renvoie 10400 Invalid Parameter.)
- Type: stringLanguage
Indication de langue facultative au format du fournisseur amont, par exemple EN, ZH-HANS, ZH-HANT.
- Time
Range Fenêtre de récence facultative. L'une des fenêtres nommées OneDay / OneWeek / OneMonth / OneYear, ou une plage personnalisée "YYYY-MM-DD..YYYY-MM-DD". Omettez pour ne pas filtrer par date. REMARQUE : les valeurs comme "week"/"month" sont ignorées silencieusement en amont.
- Type: string enum
Fenêtre de récence facultative. L'une des fenêtres nommées OneDay / OneWeek / OneMonth / OneYear, ou une plage personnalisée "YYYY-MM-DD..YYYY-MM-DD". Omettez pour ne pas filtrer par date. REMARQUE : les valeurs comme "week"/"month" sont ignorées silencieusement en amont.
valeurs- One
Day - One
Week - One
Month - One
Year
- Type: object200
Recherche réussie.
Resultcontient les résultats web classés.- Type: objectResponse
Metadata Métadonnées de la requête amont.
- ActionType: string
- RegionType: string
- RequestType: string
Id Identifiant unique de cette requête.
- ServiceType: string
- VersionType: string
- Type: objectResult
Charge utile du résultat de recherche.
- ChoicesType: array object[] | null
Réservé ; null sauf si applicable.
Objet vide - LogType: string
Id ID de journal amont (égal à ResponseMetadata.RequestId).
- ResultType: integer
Count Nombre de résultats web renvoyés.
- SearchType: object
Context Écho du contexte de requête résolu.
- OriginType: string
Query - SearchType: string
Type
- TimeType: integer
Cost Temps de traitement amont en millisecondes.
- UsageType: object | null
Réservé ; null sauf si applicable.
- WebType: array object[]
Results Liste classée des résultats web.
- IdType: string
ID opaque du résultat.
- LogoType: string
Url URL signée du logo du site (à durée limitée).
- PublishType: string
Time Heure de publication au format ISO 8601 (peut être vide).
- PublishType: integer
Time Unix Heure de publication en secondes Unix (0 si inconnue).
- SiteType: string
Name Nom du site source (peut être vide).
- SnippetType: string
Court extrait de texte de la page.
- SortType: integer
Id Rang du résultat, à partir de 1.
- SummaryType: string
Résumé plus long du contenu de la page.
- TitleType: string
Titre du résultat.
- UrlType: string
URL du résultat.
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
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
}
}