En bref. Tavily Search API fournit des résultats web classés et, en option, le texte des pages, tandis qu’Extract récupère le contenu d’URL précises.

Définition : Tavily Search API est une interface de recherche web qui fournit aux assistants IA des résultats classés, les URL des sources et le contenu des pages. Au 17 octobre 2026, Tavily documente la génération facultative de réponses et une API Extract distincte pour récupérer le contenu d’URL précises.

Points clés

La référence de Search de Tavily décrit un tableau results classé par pertinence, avec les titres des sources, leurs URL et leur contenu.
Le guide des bonnes pratiques de Search de Tavily recommande de rechercher des URL pertinentes, puis d’utiliser Extract pour extraire le contenu complet.
La référence d’Extract autorise jusqu’à 20 URL par requête et signale les échecs individuels dans failed_results.

Que renvoie une requête de recherche ?

Le point de terminaison (endpoint) Search accepte une query dans une requête POST adressée à https://api.tavily.com/search, authentifiée par une clé d’API Tavily. Cette requête abrégée reprend les paramètres documentés :

curl --request POST \
  --url https://api.tavily.com/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "who is Leo Messi?",
    "search_depth": "basic",
    "include_raw_content": "markdown"
  }'

Un résultat comprend title, url, content et un score de pertinence score. Un fragment (chunk) est un court passage repris directement d’une page source. Les niveaux de profondeur de recherche basic, fast et advanced renvoient des fragments pertinents dans content ; chunks_per_source détermine leur nombre maximal par source. L’option ultra-fast renvoie un résumé de la page.

Le réglage include_raw_content sur "markdown" ajoute le contenu nettoyé et analysé de la page ; "text" demande du texte brut. Le paramètre distinct include_answer demande une réponse à la requête produite par un modèle de langage. Sa valeur par défaut est false : la génération d’une réponse nécessite donc un réglage explicite.

La présentation générale de Tavily décrit la transmission des résultats de recherche à un modèle de langage pour lui servir de contexte.

Comment Extract traite-t-il les URL connues ?

Le point de terminaison Extract de Tavily accepte une valeur urls à l’adresse https://api.tavily.com/extract. Il renvoie le contenu extrait dans raw_content, au format Markdown par défaut ; le texte brut est disponible avec format: "text".

L’ajout d’une query reclasse les fragments extraits selon leur pertinence pour cette requête. Avec cette option, chunks_per_source détermine le nombre de passages présents dans raw_content. Ce champ peut donc contenir une sélection de passages. Le niveau de profondeur d’extraction advanced récupère des données supplémentaires, dont les tableaux et les contenus intégrés, et peut augmenter la latence.

La réponse répartit les URL entre results pour les réussites et failed_results pour les échecs. Une réponse HTTP 200 peut contenir un tableau results vide lorsque l’extraction échoue pour toutes les URL valides. L’examen des deux tableaux permet d’identifier les pages qui fournissent effectivement du contenu.

Que peut vérifier l’équipe responsable d’un site web ?

Le guide des bonnes pratiques de Search de Tavily décrit des filtres de domaines qui influent sur les sources récupérées par une application. Avec include_domains_mode: "restrict", les résultats se limitent aux domaines de la liste include_domains ; "prefer" autorise aussi d’autres domaines. Le paramètre exclude_domains exclut les domaines indiqués.

Ces réglages sont à examiner lorsqu’une page est absente d’un ensemble de résultats : la requête elle-même peut restreindre les sources admissibles. Le même guide définit score comme la pertinence du contenu par rapport à la requête ; le seuil de filtrage approprié dépend du cas d’usage de l’application. L’examen des champs renvoyés url, content et raw_content montre quelle source et quels passages l’application reçoit.

Termes associés

Questions fréquentes

Pouvez-vous demander le texte des pages avec les résultats de recherche ?

Oui. La référence de Search documente include_raw_content: "markdown" pour le contenu nettoyé des pages et "text" pour le texte brut. L’option vaut false par défaut.

Pouvez-vous extraire le contenu d’une page sans effectuer de recherche au préalable ?

Oui. La référence d’Extract accepte directement une URL dans urls. Une requête de recherche est facultative et sert à reclasser les passages extraits.

Comment pouvez-vous interpréter le score d’un résultat ?

Le guide des bonnes pratiques de Search définit score comme la pertinence du contenu par rapport à la requête. Il conseille de choisir un seuil de filtrage en fonction du cas d’usage de l’application.

Sources

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