Búsqueda web en tiempo real orientada a IA.
BytePlus
Web search and page content retrieval.
Búsqueda web en tiempo real orientada a IA.
Ejecuta una búsqueda web en tiempo real diseñada para agentes de IA y devuelve una lista clasificada de resultados con título, enlaces y fragmentos. Query es obligatorio; acota los resultados con Count (≤ 20), Filter (restringido a Sites o excluyendo BlockHosts), Language y TimeRange. La respuesta envuelve ResponseMetadata.RequestId y una lista Result de resultados web. Úsalo para aumentar la recuperación en RAG, monitorizar competencia y PR, verificar hechos y obtener contenido; combina la URL de cada resultado con post_byteplus_fetch para extraer el contenido completo de la página.
Pricing reference
- Medición: base de costo fija por solicitud exitosa.
- Estimación de referencia por solicitud: USD 0.0048.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe ya liquidado del cliente.
Solo metadatos de referencia; no son una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: stringQuerylongitud máx.:400obligatorio
La consulta de búsqueda. Obligatoria. Máx. 400 caracteres; el motor upstream también limita de forma efectiva a unas 50 palabras.
- Tipo: integerCountmáx.:20
Número de resultados que se devolverán. Opcional; predeterminado 10, máximo 20.
- Tipo: objectFilter
Filtro de resultados opcional. Ambos campos son cadenas de dominios completos separadas por barras verticales (máx. 5 cada uno).
- BlockTipo: string
Hosts Excluye los resultados de estos dominios completos. Separados por barras verticales, máx. 5, por ejemplo "reddit.com|quora.com".
- SitesTipo: string
Restringe los resultados a estos dominios completos. Separados por barras verticales, máx. 5, por ejemplo "bytedance.com|byteplus.com". (Enviar un array devuelve 10400 Invalid Parameter.)
- Tipo: stringLanguage
Sugerencia de idioma opcional en el formato del upstream, por ejemplo EN, ZH-HANS, ZH-HANT.
- Time
Range Ventana de recencia opcional. Una de las ventanas con nombre OneDay / OneWeek / OneMonth / OneYear, o un intervalo personalizado "YYYY-MM-DD..YYYY-MM-DD". Omítelo para no aplicar filtro temporal. NOTA: los valores como "week"/"month" se ignoran silenciosamente en el upstream.
- Tipo: string enum
Ventana de recencia opcional. Una de las ventanas con nombre OneDay / OneWeek / OneMonth / OneYear, o un intervalo personalizado "YYYY-MM-DD..YYYY-MM-DD". Omítelo para no aplicar filtro temporal. NOTA: los valores como "week"/"month" se ignoran silenciosamente en el upstream.
valores- One
Day - One
Week - One
Month - One
Year
- Tipo: object200
Búsqueda completada correctamente.
Resultcontiene los resultados web clasificados.- Tipo: objectResponse
Metadata Metadatos de la solicitud upstream.
- ActionTipo: string
- RegionTipo: string
- RequestTipo: string
Id Identificador único de esta solicitud.
- ServiceTipo: string
- VersionTipo: string
- Tipo: objectResult
Payload del resultado de búsqueda.
- ChoicesTipo: array object[] | null
Reservado; null salvo que corresponda.
Objeto vacío - LogTipo: string
Id ID de registro del upstream (equivale a ResponseMetadata.RequestId).
- ResultTipo: integer
Count Número de resultados web devueltos.
- SearchTipo: object
Context Eco del contexto de consulta resuelto.
- OriginTipo: string
Query - SearchTipo: string
Type
- TimeTipo: integer
Cost Tiempo de procesamiento del upstream en milisegundos.
- UsageTipo: object | null
Reservado; null salvo que corresponda.
- WebTipo: array object[]
Results Lista clasificada de resultados web.
- IdTipo: string
ID opaco del resultado.
- LogoTipo: string
Url URL firmada del logotipo del sitio (con validez limitada).
- PublishTipo: string
Time Hora de publicación en ISO 8601 (puede estar vacía).
- PublishTipo: integer
Time Unix Hora de publicación como segundos Unix (0 si se desconoce).
- SiteTipo: string
Name Nombre del sitio de origen (puede estar vacío).
- SnippetTipo: string
Fragmento de texto corto de la página.
- SortTipo: integer
Id Posición del resultado, empezando por 1.
- SummaryTipo: string
Resumen más largo del contenido de la página.
- TitleTipo: string
Título del resultado.
- UrlTipo: string
URL del resultado.
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
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
}
}