En bref. L’API Research de You.com renvoie par défaut des citations intégrées au texte avec les URL des sources et conserve les sources séparément de la sortie JSON personnalisée.

Définition : Oui. Au 17 octobre 2026, l’API Research de You.com, une interface logicielle qui fournit des réponses issues de recherches, documente une réponse par défaut en Markdown avec des citations numérotées intégrées au texte et un tableau de sources séparé. Chaque citation relie le texte de la réponse à une entrée de ce tableau, qui contient les URL des sources.

Points clés

La présentation de l’API Research de You.com montre des marqueurs de citation tels que [[1, 2]], qui renvoient aux éléments du tableau sources.
La référence de l’API impose une URL pour chaque source ; les titres et les extraits des sources sont des champs facultatifs.
Le guide des sorties structurées indique que les sources restent dans output.sources lorsque la réponse utilise un schéma JSON personnalisé.
Le guide de démarrage de l’API Research affiche la réponse, puis énumère les titres et les URL des sources en commençant à un.

Que contient la réponse par défaut ?

La référence de l’API de You.com décrit un objet output contenant content, content_type et sources. Par défaut, content est une chaîne de caractères en Markdown, c’est-à-dire du texte avec une mise en forme pour des éléments tels que les titres et les listes. La valeur de content_type est text. Les citations numérotées dans la réponse renvoient à la liste de sources qui l’accompagne.

Chaque élément de sources possède un champ url obligatoire. Le champ facultatif title donne le titre de la page, et le champ facultatif snippets contient les extraits pertinents utilisés pour produire la réponse. Une application qui exploite la réponse doit donc prendre en charge les sources sans titre ou sans extrait.

La même référence définit une liste warnings distincte pour les problèmes tels que les difficultés d’accès aux sources ou les résultats partiels. Avec background: true, la réponse initiale contient une référence à une tâche ; la réponse finale se récupère par interrogation périodique (polling) ou par diffusion en continu (streaming) de la tâche.

Comment une application peut-elle afficher les liens vers les sources ?

Le guide de démarrage de l’API Research présente le code Python suivant après un appel de recherche dont la réponse est stockée dans res :

print(res.output.content)

for i, source in enumerate(res.output.sources, 1):
    print(f"[{i}] {source.title or 'Untitled'}: {source.url}")

La boucle attribue le numéro un à la première source et utilise la valeur de remplacement Untitled lorsqu’un titre est absent. Elle fournit ainsi un exemple concret pour afficher la réponse avec les liens numérotés vers les sources. Pour le propriétaire d’un site qui examine une réponse, l’URL de la source identifie la page référencée.

Que change une sortie JSON structurée ?

Un schéma JSON décrit les champs et les types attendus dans un objet JSON. Le guide des sorties structurées de You.com documente le paramètre de requête output_schema pour ce format. La réponse devient un objet dans output.content, et output.content_type prend la valeur object.

Le tableau de sources reste en dehors de cet objet, dans output.sources. L’API n’insère pas automatiquement de champs de citation dans l’objet personnalisé. Les applications qui utilisent ce mode doivent conserver la liste de sources séparée lors du traitement de la réponse.

Le guide exige aussi un objet à la racine du schéma, additionalProperties: false pour chaque objet et la présence de chaque propriété déclarée dans required. Ces règles comptent pour définir des champs prévisibles destinés à une application en aval.

Comment vérifier les affirmations associées aux citations ?

La présentation de You.com recommande de suivre les URL des citations pour confirmer les affirmations avant de présenter aux utilisateurs finaux des réponses juridiques, financières ou médicales. La vérification consiste à relier la référence numérotée d’une réponse à l’URL de sa source, puis à lire cette page pour vérifier qu’elle étaye l’affirmation. Un extrait renvoyé fournit un passage à examiner ; la page liée fournit le contexte de la source.

Termes associés

Questions fréquentes

Puis-je demander une sortie structurée avec le niveau d’effort lite ?

D’après le guide des sorties structurées de You.com, output_schema est pris en charge avec standard, deep, exhaustive et frontier. Son envoi avec research_effort: "lite" renvoie 422.

Une requête en arrière-plan contient-elle immédiatement la réponse avec ses citations ?

La référence de l’API décrit la réponse initiale en arrière-plan comme une référence à une tâche. Vous récupérez le résultat final par interrogation périodique ou par diffusion en continu de la tâche.

Sources

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

L’API Research de You.com renvoie-t-elle des citations ?