Exécuter une recherche web sémantique neuronale.
Exa
Semantic search, page content, cited answers and asynchronous research.
Exécuter une recherche web sémantique neuronale.
Recherche le web par le sens plutôt que par mot-clé. query est obligatoire ; affinez avec category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate, et définissez numResults. Renvoie requestId, resolvedSearchType, searchTime, costDollars et results[] avec id, title et url. id est l'URL, et c'est ce que prend post_exa_contents. ⚠️ Les résultats ne contiennent aucun texte de page sauf demande explicite : passez contents ou enchaînez avec post_exa_contents. Choisissez-le plutôt que searchWeb lorsque la requête est une description et non des mots-clés ; choisissez Tavily lorsque vous voulez le texte dans le même appel, et post_exa_answer lorsque vous voulez une réponse rédigée plutôt qu'une liste.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.017.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un 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: stringqueryobligatoire
La requête de recherche en langage naturel.
- Type: string enumcategory
Indication facultative sur le type de pages à privilégier.
valeurs- company
- research paper
- news
- personal site
- financial report
- people
- Type: objectcontents
Options de contenu à renvoyer avec chaque résultat.
- highlightsType: boolean
Renvoyer des extraits pertinents mis en évidence.
- summaryType: boolean
Renvoyer un résumé de la page généré par IA.
- textType: boolean
Renvoyer le texte intégral de la page.
- Type: string Format: date-timeend
Published Date Ne renvoyer que les résultats publiés à cette date ISO 8601 ou avant.
- Type: array string[]exclude
Domains Exclure les résultats de ces domaines.
- Type: array string[]include
Domains Ne renvoyer que les résultats de ces domaines.
- Type: integernum
Results min.:1max.:100Nombre de résultats à renvoyer.
- Type: objectoutput
Schema JSON Schema utilisé pour synthétiser une sortie structurée à partir des résultats.
- Type: string Format: date-timestart
Published Date Ne renvoyer que les résultats publiés à cette date ISO 8601 ou après.
- Type: boolean enumstreamconstante:falsevaleurs
- false
- Type: stringsystem
Prompt Instruction qui guide la génération de la sortie structurée.
- Type: string enumtype
Mode de recherche. auto laisse Exa choisir ; les modes deep échangent de la latence contre une récupération de meilleure qualité.
valeurs- auto
- fast
- instant
- deep
-lite - deep
- deep
-reasoning
- Type: object200
Recherche réussie.
- cost
Dollars Détail des coûts du fournisseur pour l'utilisation des ressources. À titre informatif uniquement ; ni le débit client Felo, ni un reçu de facturation Felo.
- output
Sortie structurée, présente uniquement lorsque outputSchema a été fourni.
- Type: stringrequest
Id Identifiant de requête Exa.
- Type: array object[]results
Résultats de recherche classés.
- authorType: string
- idType: string
- publishedType: string
Date - titleType: string
- urlType: string
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/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
}