Aller au contenu

Moteurs IA

Grounding et citations : comment les moteurs IA exposent leurs sources

Quatre formes pour six moteurs : OpenAI, Google, xAI et Microsoft renvoient des offsets url_citation, Claude 150 caractères de cited_text, Perplexity des id.

Quatre cubes en contour pendent à des fils courbes, le dernier étant entouré de bleu

Consultant SEO, et plus récemment GEO, chez MentionBox

Tous les moteurs qui renvoient des sources par une API officielle emploient l'une de quatre formes, et quatre des six convergent sur le même nom d'objet. La Responses API d'OpenAI, l'Interactions API de Gemini, la Responses API de xAI et l'outil de recherche web de Microsoft Foundry accrochent au texte de la réponse une annotation de type url_citation, avec une url, un title et des offsets start_index et end_index. Anthropic pose plutôt un tableau citations sur chaque bloc de texte, avec jusqu'à 150 caractères de cited_text par source. Perplexity rend un id entier par page lue et des marqueurs [web:ID] dans le texte. Deux surfaces Microsoft ne rendent rien de tel : l'outil Grounding with Bing Search classique, dont la documentation indique qu'il « does NOT return the tool output to developers and end users », et Google AI Overviews et AI Mode, pour lesquels aucune API n'existe.

Cette page s'adresse au développeur qui doit ranger dans la même table les réponses de plusieurs moteurs, et à celui qui veut savoir quel champ porte l'URL de l'éditeur avant d'écrire son schéma. Elle passe champ par champ sur ce que renvoie chaque API, montre où le jeu lu et le jeu cité divergent, liste ce que chaque éditeur oblige à afficher, puis les trois pièges de normalisation qui coûtent une migration plus tard.

Les trois choses qu'une charge de sources peut porter

Une charge de sources répond à trois questions au plus, et aucun moteur ne répond aux trois complètement.

  • Quelles requêtes ont été exécutées. Les recherches reformulées derrière un prompt. Gemini les renvoie dans google_search_call.queries, Perplexity dans le tableau queries de son objet search_results, OpenAI dans web_search_call.action.queries, et Claude une par une dans l'input.query de chaque bloc server_tool_use. xAI et Microsoft Foundry n'en renvoient aucune. Notre décryptage du fan-out dans la recherche IA montre jusqu'où va cette expansion.
  • Quelles pages ont été lues. Le jeu candidat, avant le choix du modèle. OpenAI ne l'expose que sur demande, Anthropic et Perplexity l'exposent par défaut, les trois autres pas du tout.
  • Quelle phrase repose sur quelle page. L'ancrage. Quatre moteurs donnent des offsets de caractères, Anthropic donne un passage cité, Perplexity donne un id, et l'outil classique de Microsoft ne donne rien.

Ces trois questions font toute la différence entre une liste de liens et un jeu de données auditable.

Moteur par moteur, champ par champ

OpenAI, Responses API

Un appel avec recherche produit deux types d'éléments de sortie. Un élément web_search_call enregistre ce que l'outil a fait, avec un id, un status et une action dont le type vaut search, open_page ou find_in_page ; l'action search porte les queries. Un élément message porte le texte, avec des annotations url_citation qui tiennent le type, l'url, le title, le start_index et l'end_index.

Le jeu lu est en option. Ajouter web_search_call.action.sources au paramètre include de la requête le renvoie, et la documentation de l'outil trace la frontière explicitement : « unlike inline citations, which show only the most relevant references, sources returns the complete list of URLs the model consulted when forming its response », en ajoutant que « the number of sources is often greater than the number of citations ». La même page pose une règle d'affichage, celle que la plupart des intégrations oublient : « when your interface displays web results or information from them, you must show inline citations as prominent, clickable links ». La recherche se facture 10 $ pour 1 000 appels, plus les tokens du contenu.

Google, API Gemini

Deux formes circulent, et elles ne nomment rien pareil. L'Interactions API actuelle renvoie un tableau d'étapes : un google_search_call avec les queries exécutées, un google_search_result qui porte un champ search_suggestions que le guide du grounding décrit comme « an HTML snippet for rendering search suggestions in your UI », et un model_output dont les blocs de texte portent des annotations de type url_citation avec une url, un title donné sous forme de nom de domaine, un start_index et un end_index.

La forme generateContent héritée range tout dans un objet groundingMetadata : webSearchQueries, un searchEntryPoint.renderedContent pour le même HTML, un tableau groundingChunks de paires web.uri et web.title, et un tableau groundingSupports qui relie un segment de texte avec startIndex, endIndex et text à des groundingChunkIndices. Ce dernier tableau est l'ancrage le plus fin que publie un moteur, puisqu'il rattache un passage à plusieurs blocs à la fois.

Deux manques vont avec. L'uri d'un bloc est une redirection Google sur vertexaisearch.cloud.google.com et non l'adresse de l'éditeur, le title étant réduit au domaine nu, et une demande d'évolution réclamant les vraies URL sources traîne sur le forum développeurs de Google depuis 2026 sans réponse publiée. Et le jeu lu n'est pas exposé : l'étape de résultat porte l'extrait des Search Suggestions, pas une liste de résultats. Le grounding se facture par requête que le modèle décide de lancer, 14 $ pour 1 000 requêtes de recherche sur Gemini 3 et au-delà après 5 000 gratuites par mois, sous un plafond par défaut de 1 500 requêtes par jour. Notre décryptage du grounding avec Google Search couvre ce que les conditions permettent d'en garder.

Anthropic, API Claude

L'API Claude est la seule des six à renvoyer la page lue, le passage cité et la requête de recherche dans le même tableau de contenu, dans l'ordre de lecture. La documentation de la recherche web d'Anthropic publie la réponse entière : un bloc server_tool_use avec la query, un bloc web_search_tool_result dont le content est une liste d'entrées web_search_result avec une url, un title, un page_age décrit comme « when the site was last updated » et un blob encrypted_content, puis un bloc de texte avec un tableau citations.

Chaque citation est un web_search_result_location avec une url, un title, un encrypted_index et un cited_text, que la documentation plafonne à « up to 150 characters of the cited content ». Deux détails sont propres à cette API. La documentation indique que « the web search citation fields cited_text, title, and url do not count toward input or output token usage » : la couche de citation est donc gratuite une fois la recherche payée. Et encrypted_content doit être renvoyé tel quel aux tours suivants, sous peine d'erreur 400, ce qui alourdit un journal multi-tours face à un journal d'une seule réponse. Les recherches coûtent 10 $ pour 1 000, et la version d'outil web_search_20260318 ajoute un paramètre response_inclusion dont la valeur "excluded" retire de la réponse les blocs de résultats bruts, pour les chaînes d'agents qui n'ont besoin que de la réponse.

Perplexity, Agent API

Perplexity fait exception sur l'ancrage. Le tableau output contient un élément de type search_results avec un tableau queries et un tableau results, chaque entrée portant un id, une url, un title, un snippet, un source, une date et un last_updated, et le texte de la réponse y renvoie par des marqueurs [web:ID] plutôt que par des offsets de caractères. Sa documentation conseille de traiter les champs id et url comme la référence pour les citations, au lieu d'extraire les numéros de la prose.

Deux champs n'existent nulle part ailleurs : date et last_updated donnent la date de publication et la fraîcheur de chaque page citée sans second appel. Le troisième point d'entrée Perplexity, la route Orchestrator en chat completions, bascule sur des annotations avec des objets url_citation qui portent url, title, start_index et end_index : un même éditeur livre donc les deux formes selon l'adresse appelée. L'outil web_search se facture 2,50 $ pour 1 000 invocations, ou 1,00 $ avec la Fast Search, fetch_url 0,50 $ pour 1 000, et la Search API autonome 5,00 $ pour 1 000 requêtes, ou 1,00 $ avec la Fast Search. Notre décryptage de la migration Sonar et de l'Agent API couvre le reste du déménagement.

xAI, Grok

Grok renvoie un journal de visites et un ancrage optionnel. response.citations revient par défaut sous forme de liste plate de toutes les URL atteintes par l'agent, y compris les pages ouvertes puis écartées : elle est donc plus large qu'un jeu cité. Les citations en ligne sont l'ancrage, sous forme d'annotations url_citation avec une url, un title, un start_index et un end_index, actives par défaut sur la Responses API et inactives par défaut dans le SDK Python de xAI, où include=["inline_citations"] les allume. La page des citations prévient que « enabling inline citations does not guarantee that the model will cite sources on every answer » et que « the model decides when and where to include citations based on the context and nature of the query ». L'outil web_search coûte 5 $ pour 1 000 appels ; notre article sur les outils de recherche de Grok couvre le reste de la facturation.

Microsoft, Foundry Agent Service

Microsoft fait tourner deux générations au comportement opposé, et la plus ancienne explique pourquoi tant de développeurs croient que Copilot n'expose rien. L'outil Grounding with Bing Search classique indique que « developers and end users don't have access to raw content returned from Grounding with Bing Search » et que l'outil « does NOT return the tool output to developers and end users ». Deux références reviennent malgré tout : les URL des sites par le paramètre annotations, et l'URL de la requête Bing par le détail de l'étape d'exécution. Microsoft exige les deux, qui « must be retained and displayed in the exact form provided by Microsoft ». La facturation est de 14 $ pour 1 000 transactions, plafonnée à 150 par seconde et 1 million par jour.

L'outil de recherche web actuel ressemble au reste du marché : un bloc de contenu output_text avec des annotations de type url_citation, et l'exemple de la documentation montre une url, un start_index et un end_index. Une ligne de cette page mérite une note dans votre schéma, parce qu'elle change l'objet mesuré sans changer un seul paramètre : « when you add web search directly to a prompt agent or a Responses API request, it uses Web IQ », tandis que « when you add web search to a toolbox, it still uses Grounding with Bing Search, not Web IQ ». Le même nom d'outil lit donc deux index différents.

Côte à côte

MoteurOù vit le jeu citéAncrage à la réponseJeu luRequêtesPrix de la recherche
OpenAI, Responses APIannotations url_citation sur le messagestart_index, end_indexsur demande, via include: ["web_search_call.action.sources"]web_search_call.action.queries10 $ pour 1 000 appels
Google, Gemini Interactionsannotations url_citation sur model_outputstart_index, end_indexnon renvoyégoogle_search_call.queries14 $ pour 1 000 requêtes, 5 000 gratuites par mois
Google, generateContentgroundingChunks[].web.urigroundingSupports[], du segment aux indices de blocsmême tableau que le jeu citéwebSearchQueriesidem
Anthropic, API Claudecitations[] sur chaque bloc de textecited_text, jusqu'à 150 caractèresblocs web_search_tool_resultune query par server_tool_use10 $ pour 1 000 recherches
Perplexity, Agent APIsearch_results.results[]marqueurs [web:ID], appariés sur l'idmême tableau que le jeu citésearch_results.queries2,50 $ pour 1 000, 1,00 $ avec la Fast Search
xAI, Responses APIresponse.citationsannotations url_citation, quand le modèle les ajoutecitations sert aussi de journal de visitesnon renvoyé5 $ pour 1 000 appels
Microsoft Foundry, recherche webannotations url_citation sur output_textstart_index, end_indexnon renvoyénon renvoyé14 $ pour 1 000 transactions de grounding Bing

Noms de champs tirés de la documentation de chaque éditeur et tarifs lus sur la page de prix de chaque éditeur le 20 novembre 2026.

Normaliser six formes en une seule table

Six charges se replient en sept colonnes, et la correspondance est mécanique dès qu'on accepte que deux d'entre elles soient souvent vides.

ColonneOù la lire
answer_textoutput_text chez OpenAI, Perplexity, xAI et Foundry ; les blocs de texte concaténés chez Claude ; le texte de model_output chez Gemini
searchedprésence d'un web_search_call, d'un google_search_call, d'un server_tool_use, d'un élément search_results, ou d'un citations non vide
queries[]action.queries, google_search_call.queries, search_results.queries, ou une par server_tool_use
retrieved[]action.sources, web_search_tool_result.content[], search_results.results[], groundingChunks[]
cited[]le tableau d'annotations, le tableau citations, ou les id visés par les marqueurs [web:ID]
anchorstart_index et end_index, ou cited_text, ou l'id du résultat, ou null
publisher_urlle champ url, sauf sur le generateContent de Gemini, où la redirection doit être résolue

Chez OpenAI, toute l'extraction tient dans un appel, et les deux tableaux visés sont frères plutôt qu'imbriqués :

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "input": "best AI visibility API for an agency",
    "tools": [{"type": "web_search"}],
    "tool_choice": "required",
    "include": ["web_search_call.action.sources"]
  }' | jq '{
    queries: [.output[] | select(.type == "web_search_call") | .action.queries?] | flatten,
    retrieved: [.output[] | select(.type == "web_search_call") | .action.sources?] | flatten,
    cited: [.output[] | select(.type == "message") | .content[].annotations[]?
            | select(.type == "url_citation") | .url]
  }'

Trois pièges se cachent dans cette correspondance, et chacun se traite moins cher à l'entrée que dans une migration.

  1. Des id locaux à la réponse. L'id d'un résultat Perplexity est un index entier valable pour une seule réponse, réutilisé à l'appel suivant. Indexez vos lignes sur l'URL et ne gardez l'id que pour résoudre les marqueurs de cette même réponse.
  2. Des redirections rangées comme des URL. Une adresse vertexaisearch.cloud.google.com et une adresse d'éditeur ne sont pas la même clé. Rangez le domaine lu dans web.title et la redirection dans deux colonnes, et ne résolvez que lorsque la page est nécessaire, dans les limites des conditions.
  3. Des lignes vides qui ressemblent à des échecs. Une réponse sans étape de recherche est une observation valable, pas un enregistrement perdu. Sans booléen searched, un mois de journaux mélange deux populations, et aucune analyse ultérieure ne les sépare.

Les obligations d'affichage, éditeur par éditeur

Les champs de citation viennent avec des obligations, et elles diffèrent assez pour qu'une seule interface ne puisse pas satisfaire les six par hasard.

  • OpenAI. Des citations en ligne affichées comme des liens cliquables bien visibles dès que l'interface montre des résultats web ou des informations qui en viennent.
  • Google. L'HTML des Search Suggestions affiché avec les résultats grounded, cinq au maximum, non modifié et sans rien d'intercalé ; les conditions de l'API Gemini limitent par ailleurs la conservation du texte grounded à deux ans, pour trois usages nommés, et interdisent la mise en cache, l'analyse et la collecte des liens.
  • Anthropic. Des citations vers la source d'origine quand les sorties de l'API sont affichées directement à des utilisateurs finaux, avec sa propre note : une sortie modifiée ou recombinée relève de votre service juridique.
  • Microsoft. À la fois les URL des sites et l'URL de la requête Bing, conservées et affichées dans la forme exacte fournie par Microsoft, selon les règles d'usage et d'affichage de Grounding with Bing.
  • Perplexity et xAI. Aucune règle d'affichage publiée sur les pages de citations elles-mêmes, ce qui ne vaut pas permission de stocker en volume : la conservation se joue dans les conditions de confidentialité de chaque éditeur.

À notre avis, c'est cette liste, et non les noms de champs, qui décide si une API donnée peut tenir derrière le produit que vous construisez. Un outil de reporting qui compte des domaines et montre à un client un tableau de qui se fait citer relève d'une activité différente d'une application qui répond à la question d'un lecteur avec des liens, et les conditions de Gemini séparent les deux noir sur blanc.

Les absences communes aux six moteurs

Les six renvoient une réponse avec ses sources. Aucune ne renvoie de position, de part de voix, de comptage sur des exécutions répétées, ni les noms des concurrents apparus à côté du vôtre, et aucune ne renvoie ce qu'une personne voit dans le produit grand public : Google ne publie aucune API pour les AI Overviews ni pour l'AI Mode, et la note Microsoft citée plus haut dit que l'outil Bing classique retient sa sortie brute par construction. Les formules de la couche calculée sont dans notre guide des mesures GEO, et les règles de comptage par page dans notre guide sur le suivi des citations IA de vos pages.

Comme exemple concret de cette couche quand un éditeur la livre au lieu de vous la laisser, API for GEO renvoie par prompt un tableau sources[] avec l'url, le domain, une category et un indicateur mentionsBrand, à côté des mentions de marque, de la position, de la part de voix, du sentiment et des questions de fan-out, à 13 $ pour 1 000 réponses et jusqu'à 7 $ à son plus gros palier, les lectures sur les exécutions stockées n'étant pas facturées, relevé le 23 octobre 2026. MentionBox, qui édite ce site, a un lien commercial avec API for GEO.

Les noms de champs continueront de bouger. Google fait déjà tourner deux formes à la fois, Perplexity en livre deux, Microsoft a inversé le comportement de son outil d'une génération à l'autre, et Anthropic a ajouté dans sa dernière version d'outil un paramètre qui retire complètement les blocs de résultats de la réponse. Les trois questions ci-dessus tiennent, elles, depuis la sortie du premier de ces outils : quelles requêtes ont tourné, quelles pages sont revenues, et quelle phrase repose sur quelle page. Une table bâtie sur ces trois-là survit au renommage des champs d'un éditeur.

Questions fréquentes

Comment récupérer la liste des sources utilisées par un moteur IA via son API ?

En lisant l'objet de citation que le moteur accroche à la réponse, dont le nom change d'un éditeur à l'autre. Sur la Responses API d'OpenAI, chez xAI, chez Google et sur Microsoft Foundry, c'est une annotation de type `url_citation` sur le contenu texte, avec une `url`, un `title` et des offsets `start_index` et `end_index`. Sur l'API Claude, c'est un tableau `citations` sur chaque bloc de texte, qui porte `url`, `title`, `encrypted_index` et jusqu'à 150 caractères de `cited_text`. Sur l'Agent API de Perplexity, c'est un élément d'`output` de type `search_results`, dont les entrées `results` portent un `id`, une `url`, un `title`, un `snippet`, un `source`, une `date` et un `last_updated`.

Quelle différence entre grounding, citations et annotations ?

Le grounding est l'étape, les citations sont le résultat, les annotations sont le transport. Google appelle l'ensemble de la fonction « grounding with Google Search » et la facture 14 $ pour 1 000 requêtes de recherche sur Gemini 3 et au-delà, après 5 000 gratuites par mois ; les citations sont les pages auxquelles la réponse est rattachée ; et les annotations sont les objets qui relient une plage de caractères du texte à l'une de ces pages. Anthropic et Perplexity emploient le mot « citation » pour l'objet comme pour le résultat, et la documentation d'Anthropic indique que les citations « are always enabled for web search ».

Quels moteurs renvoient la vraie URL de l'éditeur d'une page citée ?

Cinq sur six, Google faisant exception dans la forme que lisent la plupart des intégrations. Claude renvoie l'`url` de la page, Perplexity une `url` d'éditeur par résultat, OpenAI et xAI une `url` par annotation, et l'outil de recherche web de Microsoft Foundry une `url` sur chaque `url_citation`. Dans la forme generateContent héritée de Gemini, chaque bloc de grounding porte un `web.uri` sur `vertexaisearch.cloud.google.com` et un `web.title` réduit au domaine : l'adresse de l'éditeur s'atteint en suivant la redirection. Une demande d'évolution réclamant les vraies URL sources est ouverte sur le forum développeurs de Google depuis 2026, sans réponse publiée.

Toute réponse issue d'une recherche revient-elle avec des citations ?

Non, et deux éditeurs l'écrivent. La page des citations de xAI indique que « enabling inline citations does not guarantee that the model will cite sources on every answer » et que « the model decides when and where to include citations based on the context and nature of the query ». La documentation d'OpenAI note que « the number of sources is often greater than the number of citations » : une page peut donc être lue, ouverte et jamais citée. Stockez un booléen indiquant si une recherche a eu lieu, puisqu'une réponse sans étape de recherche sort des poids du modèle et non du web.

Ai-je le droit de stocker et d'afficher les citations renvoyées par une API ?

Chaque éditeur pose sa règle, et trois d'entre eux sont explicites. La documentation d'OpenAI indique que, dès qu'une interface affiche des résultats web, « you must show inline citations as prominent, clickable links ». Anthropic note que « when displaying API outputs directly to end users, citations must be included to the original source ». Microsoft impose d'afficher à la fois les URL des sites et l'URL de la requête Bing, « retained and displayed in the exact form provided by Microsoft ». Les conditions de l'API Gemini sont les plus strictes du lot : le texte grounded peut être conservé deux ans au plus, pour trois usages nommés seulement, et la mise en cache, l'analyse et la collecte des liens sont interdites.

Combien coûte une réponse avec ses citations sur chaque API ?

La recherche se facture à part des tokens. OpenAI demande 10 $ pour 1 000 appels de recherche web, Anthropic 10 $ pour 1 000 recherches, Google 14 $ pour 1 000 requêtes de recherche sur Gemini 3 et au-delà après 5 000 gratuites par mois, xAI 5 $ pour 1 000 appels, Perplexity 2,50 $ pour 1 000 invocations de `web_search` ou 1,00 $ avec la Fast Search, et Microsoft 14 $ pour 1 000 transactions Grounding with Bing Search. Tarifs lus sur la page de prix de chaque éditeur le 20 novembre 2026. Les pages que la recherche fournit au modèle se facturent en plus, en tokens d'entrée, au tarif du modèle.