En bref. Exa Search API renvoie des résultats web classés dont les options contents permettent de sélectionner le texte des pages, des extraits pertinents pour la requête ou des résumés produits par un modèle.

Définition : Au 17 octobre 2026, Exa Search API est une interface de recherche web qui accepte une requête en langage naturel et renvoie des résultats classés, accompagnés du contenu des pages en option. Ses options contents permettent de sélectionner le texte extrait, des extraits pertinents (highlights) ou des résumés produits par un modèle.

Points clés

Le guide de l’API Search d’Exa indique que query est le seul champ obligatoire de la requête et que auto est le mode de recherche par défaut.
La référence de Search définit les champs des résultats, notamment title, url, publishedDate, author et id.
Le guide des extraits pertinents d’Exa décrit les passages en rapport avec la requête renvoyés dans results[].highlights.
Le guide de l’API Contents décrit l’extraction à partir d’URL fournies, y compris pour les pages dont le rendu utilise JavaScript et les PDF.

Comment fonctionne une requête de recherche ?

Le guide de l’API Search d’Exa présente une requête HTTP POST authentifiée vers https://api.exa.ai/search. Cet exemple reprend la structure de cette requête et demande des extraits pertinents :

curl -s -X POST "https://api.exa.ai/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EXA_API_KEY" \
  -d '{
    "query": "Exa Search API documentation",
    "type": "auto",
    "contents": { "highlights": true }
  }'

EXA_API_KEY contient la clé d’authentification. La réponse contient un tableau results classé par pertinence. Le guide indique que la recherche renvoie jusqu’à 10 résultats par défaut ; numResults permet d’en demander jusqu’à 100. Le nombre renvoyé peut être inférieur si le nombre de pages pertinentes disponibles est plus faible.

Quels champs du contenu récupéré sont utiles ?

Le schéma de réponse de Search associe un titre et une URL à chaque résultat. Il décrit publishedDate comme une estimation de la date de création obtenue par analyse du HTML, author comme disponible lorsque l’auteur est renseigné, et id comme un identifiant temporaire de document utilisable avec /contents.

Les champs de contenu répondent à des usages différents :

text contient le texte extrait de la page. Le guide de l’API Contents d’Exa décrit cette sortie comme le corps de la page nettoyé, au format Markdown ; text.maxCharacters en limite la longueur.
highlights contient un tableau de passages extraits. Le guide des extraits pertinents indique que la sélection s’effectue en fonction de la requête à chaque appel. highlights.maxCharacters fixe, si nécessaire, une limite de longueur des extraits par page.
summary contient une synthèse produite par un modèle. Le guide de l’API Contents décrit un appel à un modèle de langage pour chaque page et une option summary.query pour orienter le résumé. L’option summary.schema permet de demander des champs structurés, renvoyés sous forme de chaîne JSON.

Pour l’examen d’un site web, url identifie la page renvoyée, tandis que text ou highlights donne accès au contenu transmis à l’application appelante.

Comment la récupération de contenu gère-t-elle les URL existantes et la fraîcheur ?

Le guide de l’API Contents décrit POST /contents pour les URL ou les identifiants de documents connus, fournis dans ids. Ses options text, highlights et summary se placent au premier niveau de la requête. Search place ces options dans contents.

Le même guide définit maxAgeHours : son omission autorise le contenu en cache et entraîne la récupération des pages lorsque cela est nécessaire ; une valeur positive fixe l’ancienneté acceptable du cache en heures. La valeur 0 demande du contenu frais, tandis que -1 utilise uniquement le contenu en cache. La réponse de /contents comprend statuses pour vérifier la réussite ou l’échec du traitement de chaque URL.

Termes associés

Questions fréquentes

Les extraits pertinents sont-ils des résumés produits par un modèle ?

Le guide de l’API Contents d’Exa décrit les extraits pertinents comme des passages copiés de la page. Si vous avez besoin d’une synthèse produite par un modèle, sélectionnez summary.

Puis-je contrôler les domaines qui apparaissent ?

La référence de Search décrit includeDomains et excludeDomains. Vous pouvez fournir des noms d’hôte, des préfixes de chemin ou des sous-domaines avec un caractère générique pour filtrer les résultats.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO