En bref. Perplexity Sonar renvoie des réponses fondées sur le Web avec des champs de sources, tandis que Perplexity oriente les intégrations nouvelles et existantes vers l’Agent API.

Définition : Au 17 octobre 2026, Perplexity Sonar est l’ancienne interface de programmation d’application (API) de Perplexity destinée aux réponses fondées sur la recherche Web. Son format de réponse associe le texte de la réponse aux URL des sources et aux métadonnées des résultats de recherche.

Points clés

La documentation de Sonar de Perplexity décrit une interface compatible avec le format Chat Completions d’OpenAI.
La référence de l’API définit citations comme les URL des sources utilisées pour produire la réponse et search_results comme les résultats utilisés pour fournir le contexte.
La présentation de la migration de Perplexity situe la fin de la prise en charge de Sonar Chat Completions au 27 septembre 2026. Les requêtes synchrones et en flux continu (streaming) continuent de fonctionner grâce à une conversion en requêtes Agent API, déployée progressivement selon le modèle.
La procédure de migration décrit les citations que Sonar insère par défaut dans le texte sous forme de marqueurs numérotés tels que [n].

Comment fonctionne une requête Sonar ?

Le guide de Sonar de Perplexity décrit des complétions de conversation fondées sur le Web : un modèle produit une réponse en utilisant la recherche Web comme contexte d’appui. La requête fournit un model et un tableau messages contenant la conversation. Le texte de la réponse renvoyée est accessible dans choices[0].message.content.

Le corps de requête suivant correspond à l’exemple Sonar de la présentation de la migration :

{
  "model": "sonar",
  "messages": [
    {"role": "user", "content": "What are the latest developments in AI agents?"}
  ]
}

La même documentation envoie ce JSON à https://api.perplexity.ai/v1/sonar avec une clé d’API de type Bearer et le type de contenu application/json. Elle recommande l’Agent API pour les nouveaux projets.

Que contiennent les champs de citation ?

Le schéma de réponse de Sonar autorise la valeur null pour citations comme pour search_results. Dans les autres cas, citations contient des URL sous forme de chaînes de caractères et search_results contient des objets représentant les résultats.

Chaque résultat exige les champs title et url. Les autres champs comprennent date pour la date de publication, last_updated pour la date de mise à jour et snippet pour un extrait de texte. Le champ source distingue web de attachment. Les deux dates peuvent avoir la valeur null.

Pour l’analyse d’un site Web, conserver les deux tableaux avec la réponse permet de disposer des URL des sources et des extraits de contexte pour les examiner.

Qu’est-ce qui change dans l’Agent API ?

La présentation de la migration de Perplexity remplace messages dans la requête Sonar par input, et choices dans la réponse par un tableau output typé. Le texte de la réponse figure dans un élément message ; les sources figurent dans un élément search_results. Les requêtes Sonar asynchrones ne sont plus prises en charge, et la documentation oriente les intégrations concernées vers le mode d’exécution en arrière-plan.

La procédure de migration explique la nouvelle correspondance entre les marqueurs de citation et les sources. Avec le préréglage fast, des marqueurs numérotés sont insérés dans le texte de la réponse. Les sources se trouvent dans le tableau results d’un élément de sortie search_results, et un marqueur [n] correspond au résultat dont l’id vaut n. Un analyseur doit donc lire les identifiants des résultats pour relier les énoncés de la réponse aux URL.

Termes associés

Questions fréquentes

Puis-je vérifier si mon site Web apparaît dans une réponse Sonar ?

Vous pouvez examiner les URL présentes dans citations et search_results, que la référence de l’API expose séparément.

Puis-je limiter la recherche à certains domaines ?

La procédure de migration présente le champ search_domain_filter de Sonar au premier niveau de la requête. Dans l’Agent API, vous placez ce filtre dans l’objet filters de l’outil web_search.

Sources

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