Ejecutar una búsqueda web semántica neuronal.
Exa
Semantic search, page content, cited answers and asynchronous research.
Ejecutar una búsqueda web semántica neuronal.
Busca en la web por significado en lugar de por palabra clave. query es obligatorio; restringe con category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate, y define numResults. Devuelve requestId, resolvedSearchType, searchTime, costDollars y results[] con id, title y url. id es la URL, y es lo que toma post_exa_contents. ⚠️ Los resultados no incluyen texto de la página salvo que lo pidas: pasa contents o continúa con post_exa_contents. Elígelo frente a searchWeb cuando la consulta sea una descripción y no palabras clave; elige Tavily cuando quieras el texto en la misma llamada, y post_exa_answer cuando quieras una respuesta escrita en lugar de una lista.
Referencia de precios
- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.017.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
Solo metadatos de referencia, no 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: stringqueryobligatorio
La consulta de búsqueda en lenguaje natural.
- Tipo: string enumcategory
Sugerencia opcional sobre el tipo de páginas que se deben priorizar.
valores- company
- research paper
- news
- personal site
- financial report
- people
- Tipo: objectcontents
Opciones de contenido que se devuelven junto con cada resultado.
- highlightsTipo: boolean
Devolver fragmentos relevantes resaltados.
- summaryTipo: boolean
Devolver un resumen de la página generado por IA.
- textTipo: boolean
Devolver el texto completo de la página.
- Tipo: string Formato: date-timeend
Published Date Devolver solo resultados publicados en esta fecha ISO 8601 o antes.
- Tipo: array string[]exclude
Domains Excluir resultados de estos dominios.
- Tipo: array string[]include
Domains Devolver solo resultados de estos dominios.
- Tipo: integernum
Results mín.:1máx.:100Número de resultados que se van a devolver.
- Tipo: objectoutput
Schema JSON Schema usado para sintetizar una salida estructurada a partir de los resultados.
- Tipo: string Formato: date-timestart
Published Date Devolver solo resultados publicados en esta fecha ISO 8601 o después.
- Tipo: boolean enumstreamconstante:falsevalores
- false
- Tipo: stringsystem
Prompt Instrucción que guía cómo se genera la salida estructurada.
- Tipo: string enumtype
Modo de búsqueda. auto deja que Exa elija; los modos deep intercambian latencia por una recuperación de mayor calidad.
valores- auto
- fast
- instant
- deep
-lite - deep
- deep
-reasoning
- Tipo: object200
Búsqueda completada correctamente.
- cost
Dollars Desglose de costos del proveedor por uso de recursos. Solo informativo; no es el cargo al cliente de Felo ni un recibo de facturación de Felo.
- output
Salida estructurada, presente solo cuando se proporcionó outputSchema.
- Tipo: stringrequest
Id Identificador de solicitud de Exa.
- Tipo: array object[]results
Resultados de búsqueda clasificados.
- authorTipo: string
- idTipo: string
- publishedTipo: string
Date - titleTipo: string
- urlTipo: string
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/exa/search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"query": "latest evaluation frameworks for AI agents",
"type": "auto",
"numResults": 10,
"category": "company",
"includeDomains": [
""
],
"excludeDomains": [
""
],
"startPublishedDate": "",
"endPublishedDate": "",
"contents": {
"text": true,
"highlights": true,
"summary": true
},
"outputSchema": {},
"systemPrompt": "",
"stream": false
}'
{
"requestId": "string",
"results": [
{
"title": "string",
"url": "string",
"publishedDate": "string",
"author": "string",
"id": "string"
}
],
"output": null,
"costDollars": null
}