En bref. You.com Research API associe la recherche web à des réponses référencées et à des réglages des sources, de l’effort de recherche, de la sortie structurée et de l’exécution en arrière-plan.

Définition : You.com Research API est une interface de programmation qui effectue des recherches sur le web, lit les sources et synthétise une réponse accompagnée de références. Au 17 octobre 2026, You.com documente des réponses en Markdown avec des références intégrées au texte et, en option, une réponse JSON structurée.

Points clés

La référence de Research API de You.com spécifie POST https://api.you.com/v1/research, avec une authentification par l’en-tête X-API-Key.
Le guide de démarrage de Research API énumère les valeurs lite, standard, deep, exhaustive et frontier du paramètre research_effort ; standard est la valeur par défaut.
Le guide de contrôle des sources documente des listes de domaines limitées à 500 entrées, dont une liste d’autorisation (allowlist) et une liste d’exclusion.
Le guide des sorties structurées indique que les sources restent dans output.sources lorsque la réponse utilise un schéma JSON.

Que contient une réponse accompagnée de sources ?

La présentation de Research API décrit un processus qui effectue plusieurs recherches et recoupe les informations recueillies. Par défaut, la réponse est un texte en Markdown dans output.content. Une référence intégrée au texte, telle que [[1, 2]], renvoie à des entrées du tableau sources qui accompagne la réponse.

La référence de l’API spécifie un champ url pour chaque enregistrement de source, avec des champs facultatifs title et snippets. Les extraits (snippets) contiennent les passages pertinents utilisés pour produire la réponse. Lors d’un audit de site web, ces enregistrements donnent accès aux pages sources et aux extraits à examiner en regard de la réponse.

Comment fonctionne la sélection des sources ?

Le guide de contrôle des sources définit source_control comme un champ de la requête. À l’intérieur de ce champ, include_domains limite les résultats aux domaines indiqués. exclude_domains retire les domaines indiqués des résultats et empêche l’agent de recherche de consulter leurs pages pendant la navigation.

L’annonce de You.com sur les paramètres de recherche précise que ces listes sont mutuellement exclusives au sein d’une même requête. Elle documente aussi des valeurs de freshness telles que day, week, month et year, tandis que country cible géographiquement les résultats à l’aide de codes pays tels que GB.

Cet exemple de corps de requête suit l’exemple de filtrage par domaine du guide. Le texte de la question est à remplacer :

{
  "input": "<question de recherche>",
  "research_effort": "deep",
  "source_control": {
    "include_domains": ["arxiv.org"]
  }
}

Comment les sorties structurées gèrent-elles les références ?

Le guide des sorties structurées documente output_schema, une définition JSON Schema dont la racine doit être un objet. Ce paramètre transforme la réponse contenue dans output.content en objet ; output.content_type prend la valeur object.

La liste des sources reste en dehors de cet objet, dans output.sources. L’API n’ajoute automatiquement aucun champ de référence à l’intérieur du schéma demandé. Une application qui affiche des résultats structurés doit donc gérer la liste des sources en parallèle de ces résultats.

Comment régler la profondeur de recherche et l’exécution en arrière-plan ?

Le guide de démarrage présente lite pour les recherches rapides et deep ou exhaustive pour les tâches où l’exhaustivité prime sur la rapidité. Il réserve frontier aux recherches plus longues qui nécessitent des requêtes en arrière-plan.

Le guide des requêtes en arrière-plan documente une exécution synchrone par défaut. Le réglage background: true renvoie immédiatement un identifiant de tâche. L’application vérifie la progression avec GET /v1/research/{task_id} et récupère le résultat final séparément de l’envoi de la requête.

Termes associés

Questions fréquentes

Puis-je limiter la recherche à certains sites web ?

Oui. Le guide de contrôle des sources documente include_domains à cet effet, avec un maximum de 500 domaines. Une liste d’exclusion bloque aussi la consultation des domaines exclus.

Où puis-je examiner les éléments à l’appui de la réponse ?

Utilisez output.sources. La référence de l’API spécifie les URL des sources ainsi que des titres et des extraits facultatifs, ce qui vous permet d’ouvrir les pages référencées et de comparer leur contenu à la réponse.

Sources

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