Moteurs IA
API Sonar de Perplexity : les citations passent à l'Agent API
Sonar Chat Completions s'est arrêté le 27 septembre 2026 : les citations arrivent dans un élément search_results, avec la recherche web à 1 $ les 1 000 appels.

Par Mathias C.Consultant SEO, et plus récemment GEO, chez MentionBox
Si vous cherchez les champs de citation de l'API Sonar de Perplexity, l'endpoint qui les portait a déménagé. Le guide de migration de Perplexity indique que le support de Sonar Chat Completions s'est arrêté le 27 septembre 2026, et que les requêtes synchrones et en flux ne continuent de fonctionner que parce qu'elles sont « being reformulated as Agent API requests, rolling out gradually by model » (reformulées en requêtes Agent API, modèle par modèle). Les citations arrivent désormais dans un élément du tableau output de l'Agent API, de type: "search_results", avec un tableau queries qui porte les recherches lancées et un tableau results dont chaque entrée contient un id, une url, un title, un snippet, une source, une date et un last_updated. La recherche, elle, est devenue une ligne de facture : l'outil web_search est facturé 0,0025 $ par appel, ou 0,001 $ avec Fast Search, en plus des jetons.
Cette page s'adresse au développeur dont l'intégration Sonar lit encore citations et search_results dans une chat completion, et à quiconque pensait qu'une clé officielle Perplexity montrerait ce que voit un utilisateur de Perplexity. Au programme : ce qui s'est arrêté et ce qui tient encore, la forme exacte d'une réponse citée, les trois endpoints de Perplexity qui renvoient des sources, le calcul du coût d'une réponse, les filtres qui décident de la liste des sources, et le point où la voie officielle cesse d'être le bon instrument pour suivre une marque.
Sonar : l'endpoint s'arrête, le modèle reste
Trois choses portent le nom Sonar, et une seule a disparu.
- Sonar Chat Completions, l'endpoint. Le guide de migration place sa fin de vie au 27 septembre 2026 et donne son ancienne adresse,
POST https://api.perplexity.ai/v1/sonar. Le journal des versions de Perplexity date le basculement de juillet 2026, sous l'entrée « Sonar Chat Completions is now Agent API ». - Sonar en asynchrone. Les requêtes Sonar asynchrones se sont arrêtées net. Le remplacement est
background: truesur l'Agent API, avec la réponse récupérée par son identifiant. perplexity/sonar, le modèle. Toujours sélectionnable, listé sur la page des modèles de l'Agent API à 0,25 $ le million de jetons d'entrée et 2,50 $ le million en sortie, ce qui en fait le modèle maison le moins cher de ce catalogue.
L'Agent API vit à l'adresse POST https://api.perplexity.ai/v1/agent, et sa page de compatibilité OpenAI précise que POST /v1/responses est accepté comme alias : client.responses.create() du SDK OpenAI l'atteint au seul prix d'un changement d'URL de base. Le renommage des champs est mécanique, et le guide pratique en imprime la table complète. Voici les parties qu'une intégration qui lit des citations va toucher.
| Sonar | Agent API |
|---|---|
model: "sonar" | effort: "fast", ou un identifiant de modèle comme perplexity/sonar |
messages | input, une chaîne simple ou un tableau d'éléments typés |
| le message système | instructions, champ de premier niveau |
search_domain_filter | tools: [{"type": "web_search", "filters": {"search_domain_filter": [...]}}] |
search_recency_filter | le même objet filters sur l'outil web_search |
web_search_options.user_location | user_location sur l'outil web_search, en dehors de filters |
num_search_results | max_results sur l'outil web_search |
max_tokens | max_output_tokens |
choices[0].message.content | output_text |
| les sources des citations | l'élément output de type: "search_results" |
return_images, num_images | un outil image_search distinct, avec son propre max_results |
Correspondances tirées du guide « How to migrate from Sonar » de Perplexity et de la référence de son Agent API, lus le 3 novembre 2026.
Deux fonctions de Sonar n'ont pas survécu au déménagement : search_language_filter a été supprimé, et les résultats vidéo (return_videos, num_videos) ne sont pas pris en charge. Un response_format.type: "regex" doit être repensé autour d'un schéma JSON.
Où se trouvent les citations maintenant
Un appel avec recherche déclare l'outil et rien de plus, comme ses équivalents chez OpenAI et Google :
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "perplexity/sonar",
"input": "best AI visibility API for an agency",
"tools": [{"type": "web_search", "max_results": 15}]
}'
La réponse est un tableau output typé, et non un tableau choices : les sources ont leur propre élément. La forme, d'après le démarrage rapide de l'Agent API, avec notre question à la place de son exemple :
{
"output": [
{
"type": "search_results",
"queries": ["best AI visibility API for agencies"],
"results": [
{
"id": 1,
"title": "Titre de la page",
"url": "https://example.com/page",
"snippet": "Extrait du résultat",
"date": "2026-01-15",
"source": "web",
"last_updated": "2026-02-23T20:10:25"
}
]
},
{
"type": "message",
"role": "assistant",
"status": "completed",
"content": [{ "type": "output_text", "text": "Texte de la réponse avec des marqueurs [web:1]", "annotations": [] }]
}
]
}
| Ce que vous obtenez | Où le lire | À quoi ça sert |
|---|---|---|
| Les recherches lancées | queries sur l'élément search_results | lire le fan-out derrière une question, et compter ce que l'outil facture |
| Les pages récupérées | results avec id, url, title, snippet, source, date, last_updated | la liste des sources, en URL d'éditeur et non en redirections |
| Le lien entre réponse et source | les marqueurs [web:ID] dans output_text | rattacher une phrase à une entrée par son identifiant |
| La trace des outils | des éléments output comme fetch_url_results, image_search_results, sandbox_results | voir ce que le run a touché d'autre |
| La facture | usage, avec input_tokens, output_tokens, tool_calls_details et un objet cost | le coût d'un run, réparti entre jetons et outils |
Noms de champs tirés du démarrage rapide de l'Agent API, de la page de l'outil de recherche web et de la référence Create Agent Response, lues le 3 novembre 2026.
Deux détails méritent de figurer dans votre schéma. L'id de chaque résultat est un index entier qui sert aux marqueurs de citation : il est local à une réponse et ne veut rien dire d'un run à l'autre, donc stockez l'URL comme clé. Et date et last_updated apparaissent tous les deux, ce qui vous donne la date de publication et la fraîcheur de chaque page citée sans second appel, là où les outils de Google et d'OpenAI ne les renvoient pas. La page de Perplexity sur le contrôle de la sortie ajoute un avertissement pour les sorties structurées : demander au modèle de placer des liens dans une réponse JSON « may not always work reliably and can result in hallucinations or broken links », donc lisez les liens dans search_results.
Les trois endpoints de Perplexity qui renvoient des sources
Une intégration qui lit des citations a un vrai choix à faire ici, parce que les trois endpoints ne facturent pas pareil et ne renvoient pas le même objet.
| Endpoint | Ce qu'il renvoie | Les sources sous forme de | Prix |
|---|---|---|---|
POST /v1/agent | une réponse générée et toute la trace des outils | élément search_results avec queries et results | les jetons au tarif du modèle, plus 0,0025 $ par appel de recherche web, ou 0,001 $ avec Fast Search |
POST /search | des résultats web classés, sans réponse rédigée | results avec title, url, snippet, date, last_updated | 5,00 $ les 1 000 requêtes, 1,00 $ avec Fast Search, aucun jeton facturé |
POST /orchestrator/v1/chat/completions | une réponse générée au format OpenAI | annotations avec des objets url_citation portant url, title, start_index, end_index | les jetons au tarif de chaque modèle, sans frais par requête |
Endpoints, champs et tarifs tirés de la présentation de la Search API, de la référence Create Chat Completion et de la page de prix de Perplexity, lues le 3 novembre 2026.
La Search API est celle que la plupart des projets de citations oublient. Elle renvoie l'ensemble récupéré et classé par Perplexity en JSON, sans réponse rédigée et sans facturation de jetons, jusqu'à 20 résultats pour une recherche web, et une requête multi-questions compte pour une unité de facturation alors que chaque question du tableau consomme une unité de débit. Si votre question est « quelles pages l'index de Perplexity met en avant sur cette requête », cet endpoint y répond pour un demi-centime, sans modèle dans la boucle.
L'endpoint Orchestrator fait l'échange inverse : il accepte le schéma Chat Completions d'OpenAI, ne facture que les jetons sans frais par requête, et donne des plages de caractères plutôt que des identifiants, ce qui est la bonne forme si vous analysez déjà des annotations url_citation venues d'OpenAI.
Le prix d'une réponse citée
L'outil web_search se paie à l'appel, et le nombre d'appels découle du niveau d'effort demandé. La page sur l'effort publie les paquets : fast lance openai/gpt-6-luna avec une seule étape et au plus un appel d'outil, low autorise 5 étapes, medium 15, high 40, et xhigh lance anthropic/claude-opus-5-5 avec jusqu'à 300 étapes et 512 000 jetons de sortie. À partir de low, le budget de recherche est fixé à max_results: 15, max_tokens: 4000 et max_tokens_per_page: 4000.
| Configuration | Facturé pour une réponse citée |
|---|---|
Un appel Fast Search, effort low sur openai/gpt-6-luna | 0,001 $ pour la recherche, plus environ 4 500 jetons d'entrée et 700 de sortie à 0,10 $ et 0,50 $ le million, soit près de 0,0018 $ au total |
Un appel Fast Search, perplexity/sonar | 0,001 $, plus les mêmes jetons à 0,25 $ et 2,50 $ le million, soit près de 0,0039 $ |
| Un appel de recherche web standard | 0,0025 $ au lieu de 0,001 $, jetons inchangés |
| Un run de recherche avec dix appels de recherche | 0,01 $ d'appels d'outil à eux seuls, avant le premier jeton |
fetch_url en plus, par page ouverte | 0,0005 $ par appel |
| La Search API, une requête de cinq questions au plus | 0,005 $, ou 0,001 $ avec Fast Search, sans jetons |
Tarifs tirés de la page de prix de Perplexity, de sa page des modèles de l'Agent API et de sa page sur l'effort, lues le 3 novembre 2026. Les volumes de jetons sont une hypothèse de travail, Perplexity publiant un budget de recherche et non une moyenne.
Deux nombres de ce tableau décident d'un budget. Le premier est le nombre d'appels, puisqu'un run en xhigh avec 300 étapes disponibles n'a aucun plafond publié sur le nombre de recherches qu'il choisira de lancer, et que chacune est facturable. Le journal des versions garde la trace de ce qui a adouci ce point en octobre 2026 : les niveaux low, medium, high et xhigh sont passés à Fast Search, ce qui a fait tomber la recherche web « from $2.50 to $1.00 per 1,000 invocations ». Le second est le modèle, où l'écart entre openai/gpt-6-luna à 0,10 $ en entrée et anthropic/claude-fable-5 à 10,00 $ atteint un facteur cent pour les mêmes pages récupérées.
Le volume a lui aussi son plafond. La page des limites de débit fixe l'Agent API à 60 requêtes par minute au palier 0, 180 au palier 1 après 50 $ de dépense cumulée et 1 980 au palier 4 après 1 000 $, tandis que la Search API tient 50 unités de requête par seconde à tous les paliers.
Les filtres qui décident de la liste des sources
La liste des sources est la sortie que vous mesurez, et quatre paramètres la déplacent. Tous vivent sur l'outil web_search.
search_domain_filter, jusqu'à 20 entrées, en liste blanche (["nasa.gov"]) ou en liste noire avec un préfixe moins (["-reddit.com"]). Le restreindre à votre propre domaine vous dit si Perplexity sait récupérer vos pages, question différente de celle de savoir s'il les retient.search_recency_filter, parmihour,day,week,month,year, plus les quatre filtres de date au format MM/JJ/AAAA, qui séparent la date de publication de la date de mise à jour.user_location, un objet aveccountry,region,city,latitudeetlongitude, placé en dehors defilters. Un appel nu n'a pas de pays, un acheteur situé en a un.search_type,webpour l'index standard oufastpour le moins cher et le plus rapide. Les deux ne renvoient pas forcément les mêmes pages : choisissez-en un et gardez-le fixe pour tout ce que vous comparez dans le temps.
L'effet sur le suivi des marques
Les champs de citation ressemblent à un flux de visibilité, et n'en sont pas un. Perplexity énonce l'écart dans sa FAQ : « The API uses the same search system as the UI with differences in configuration, so their outputs may differ », et, sur la même page, que les deux « share search infrastructure, but their tools, configuration, and models differ, so results can differ ». Sur l'Agent API, vous choisissez en plus le modèle, les instructions, le niveau d'effort et les filtres : quatre variables qu'un lecteur de perplexity.ai ne touche jamais sont fixées par vous.
Trois absences de plus décident de ce que vous pouvez honnêtement rapporter.
- Ni position ni part de voix. Une réponse donne un ensemble récupéré. La place d'une marque dans la réponse, sa survie d'un run à l'autre et les concurrents cités à côté d'elle sont des comptages que vous écrivez. Les formules sont dans notre article sur les mesures GEO.
- Aucune garantie que la recherche a eu lieu. L'outil est déclenché par le modèle : l'absence d'un élément
search_resultsdansoutputsignifie que la réponse vient des poids du modèle. Notez sa présence dans une colonne. - Une conservation à régler. La page confidentialité et sécurité de Perplexity indique que le zéro conservation de données « is available only to eligible customers through an account-level configuration under a written agreement with Perplexity », et prévient que, s'il n'a pas été activé, « do not assume that Perplexity or its model providers apply zero data retention to your requests ». La même page indique que Perplexity n'utilise pas le contenu de ses clients pour entraîner des modèles génératifs.
La page des robots de Perplexity est un contrôle utile de l'autre côté de la même question. PerplexityBot y est décrit comme l'agent qui fait apparaître et relie les sites dans les résultats de recherche de Perplexity, et il n'est « not used to crawl content for AI foundation models », tandis que Perplexity-User va chercher une page quand la question d'un utilisateur l'exige et « generally ignores robots.txt rules ». Aucune des deux entrées ne dit quoi que ce soit du chemin suivi par un appel d'API : un éditeur qui lit ses journaux de serveur ne peut donc pas attribuer une visite à une requête d'API sur le seul agent utilisateur.
Les éditeurs qui vendent la surface grand public inscrivent la distinction dans leurs propres pages, et c'est la phrase à chercher avant d'acheter. cloro écrit que « Sonar returns a model response with citation URLs but strips the source metadata, related-question suggestions, and shopping cards », et que ses propres requêtes lisent l'interface rendue, en renvoyant les sources avec leur position, les questions associées, les cartes produit et les sous-requêtes employées par Perplexity. À notre avis, c'est ainsi qu'il faut lire une telle affirmation : non comme un verdict sur le meilleur produit, mais comme l'indication de la surface que chacun mesure.
| Voie vers les sources de Perplexity | Ce qu'elle lit | Ce qui revient | Prix pour 1 000 réponses |
|---|---|---|---|
| API for GEO | Perplexity interrogé nativement, dans le pays et la langue demandés | réponse brute, URL citées par catégorie, mentions de marque, position, part de voix, sentiment, thèmes, questions de fan-out | 13 $, jusqu'à 7 $ au plus gros palier |
Agent API, outil web_search | le modèle que vous avez choisi, avec la recherche de Perplexity attachée | search_results avec queries et results, marqueurs [web:ID] en ligne | environ 1,80 $ en effort low sur openai/gpt-6-luna |
| Perplexity Search API | l'index classé de Perplexity, sans réponse rédigée | results avec title, url, snippet, date, last_updated | 5,00 $, ou 1,00 $ avec Fast Search |
| cloro | l'interface perplexity.ai | réponse en markdown, sources avec position, questions associées, cartes produit, sous-requêtes | 4 $ sur le plan Lite |
| Bright Data AI Scrapers | l'interface | réponse brute, URL citées, produits shopping | 1,50 $ |
| DataForSEO AI Optimization | l'interface et l'API officielle, sur des endpoints séparés | réponse brute, URL citées, mentions de marque, questions de fan-out, produits shopping | 1,20 $ |
Prix et capacités des éditeurs issus de notre comparateur, relevés le 23 octobre 2026 ; tarifs de Perplexity lus sur sa page de prix le 3 novembre 2026.
API for GEO ouvre ce tableau comme exemple concret de la couche calculée : il liste Perplexity parmi les moteurs qu'il interroge nativement, et renvoie les mentions de marque, la position, la part de voix, le sentiment et les questions de fan-out déjà comptés, à 13 $ pour 1 000 réponses et jusqu'à 7 $ au plus gros palier, avec des lectures gratuites sur les runs stockés et la revente autorisée. Sa limite est dans la même colonne : 13 $ contre 1,20 $ à 4 $ pour les API de scraping qui vous rendent la réponse brute, et quatre de ses dix moteurs, comme ses webhooks, sa spécification OpenAPI et ses SDK officiels, ont été confirmés par notre test en conditions réelles du 26 octobre 2026 plutôt que documentés sur apiforgeo.com. MentionBox, qui édite ce site, a un lien commercial avec API for GEO.
Cinq erreurs qui cassent une migration depuis Sonar
- Lire
choicesau lieu deoutput. Le texte de la réponse est dansoutput_text, et les sources sont un élément voisin dans un tableau typé. Un code qui indexechoices[0]renvoie du vide au lieu d'échouer franchement. - Stocker l'
idd'un résultat comme clé. C'est un index entier limité à une réponse, réutilisé à l'appel suivant. Prenez l'URL comme clé et gardez l'identifiant seulement pour résoudre les marqueurs[web:ID]de cette réponse-là. - Dimensionner le budget sur les questions. À partir de l'effort
low, plusieurs appels de recherche par run sont la norme, et chacun se facture. Liseztool_calls_detailsdansusageavant de vous engager sur un volume. - Mélanger les valeurs de
search_typedans un même tableau. Les index standard et rapide ne sont pas facturés pareil et ne renvoient pas forcément les mêmes pages : une série qui change en cours de mois compare deux choses. - Compter sur
search_language_filter. Il a été supprimé à la migration. Le ciblage par langue passe maintenant paruser_locationsur l'Agent API, ou par la Search API, qui accepte encore jusqu'à 20 codes de langue.
En résumé, Perplexity a échangé un endpoint de conversation avec liste de citations contre un endpoint d'agent avec trace complète, et a transformé la récupération en ligne de facture mesurée. Pour qui construit un produit au-dessus de Perplexity, la trace est plus utile que ce que renvoyait Sonar, puisque les requêtes, l'ensemble récupéré, le sous-ensemble cité et le coût par outil arrivent dans un seul objet. Pour qui compte ce que les moteurs disent aux acheteurs, le calcul décrit plus haut reste à faire quelque part. Notre guide sur le suivi des citations IA de vos pages détaille cette chaîne moteur par moteur, et notre classement des API en libre-service pour développeurs couvre les clés que l'on obtient seul.
Questions fréquentes
L'API Sonar de Perplexity existe-t-elle encore ?
Sonar Chat Completions a atteint sa fin de vie le 27 septembre 2026, selon le guide de migration de Perplexity, qui ajoute que les requêtes synchrones et en flux continuent de fonctionner parce qu'elles sont « being reformulated as Agent API requests, rolling out gradually by model » (reformulées en requêtes Agent API, modèle par modèle). Les requêtes Sonar asynchrones, elles, se sont arrêtées et doivent être réécrites avec `background: true` sur l'Agent API. Le nom survit à deux endroits : `perplexity/sonar` reste un modèle sélectionnable, à 0,25 $ le million de jetons d'entrée et 2,50 $ le million en sortie, et l'infrastructure de recherche de Perplexity alimente toujours l'outil `web_search`.
Comment récupérer les citations de l'API Perplexity ?
Sur l'Agent API, parcourez le tableau `output` et prenez l'élément dont le `type` vaut `search_results`. Il porte un tableau `queries` avec les recherches lancées et un tableau `results` où chaque entrée a un `id`, une `url`, un `title`, un `snippet`, une `source`, une `date` et un `last_updated`. Le texte de la réponse renvoie à ces entrées par des marqueurs `[web:ID]` : le lien entre une phrase et sa source passe donc par l'identifiant, et non par une plage de caractères. Sur l'endpoint Orchestrator chat completions, la forme change : les sources arrivent en `annotations` contenant des objets `url_citation` avec `url`, `title`, `start_index` et `end_index`, et aucun élément `search_results` n'y est documenté.
L'API Perplexity renvoie-t-elle les mêmes sources que perplexity.ai ?
Non, et Perplexity l'écrit dans sa FAQ : « The API uses the same search system as the UI with differences in configuration, so their outputs may differ » (l'API utilise le même système de recherche que l'interface, avec des différences de configuration, donc les sorties peuvent différer), et sur la même page, que l'API et l'interface web « share search infrastructure, but their tools, configuration, and models differ ». Vous choisissez aussi le modèle et les instructions, ce que le produit grand public fait pour vous. Une liste de sources d'API mesure votre propre configuration.
Combien coûte une réponse Perplexity avec ses citations ?
Deux lignes sur la facture. L'outil `web_search` coûte 0,0025 $ par appel, ou 0,001 $ avec `search_type: "fast"`, et les jetons sont facturés au tarif du modèle sélectionné. Au niveau d'effort `low`, que Perplexity documente comme `openai/gpt-6-luna` avec un budget de recherche de 4 000 jetons, une réponse d'environ 700 jetons de sortie tombe autour de 0,0018 $, soit à peu près 1,80 $ les 1 000 réponses. La même réponse sur `perplexity/sonar`, à 0,25 $ et 2,50 $ le million, revient à environ 3,90 $ les 1 000 avec Fast Search. Tarifs lus sur les pages de prix et de modèles de Perplexity le 3 novembre 2026.
Peut-on limiter la recherche de Perplexity à certains domaines, dates ou pays ?
Oui, par l'objet `filters` de l'outil `web_search`. `search_domain_filter` accepte jusqu'à 20 entrées et fonctionne en liste blanche ou, avec un préfixe moins comme `-reddit.com`, en liste noire ; `search_recency_filter` prend `hour`, `day`, `week`, `month` ou `year` ; `search_after_date_filter`, `search_before_date_filter`, `last_updated_after_filter` et `last_updated_before_filter` prennent des dates au format MM/JJ/AAAA. La localisation est en dehors de `filters`, dans un objet `user_location` avec `country`, `region`, `city`, `latitude` et `longitude`. Le `search_language_filter` de Sonar a été supprimé au passage, alors que la Search API autonome accepte encore jusqu'à 20 codes de langue.
Peut-on mesurer la visibilité de sa marque dans Perplexity avec l'API officielle ?
Vous pouvez compter les sources que votre propre configuration a récupérées, ce qui est un chiffre plus étroit que ce que lit un acheteur sur perplexity.ai. L'API renvoie une réponse avec son ensemble récupéré, sans position, sans part de voix et sans répétition dans le temps : le comptage reste à écrire. La conservation est le second point à régler avant de stocker un an de réponses : la page de confidentialité de Perplexity indique que le zéro conservation de données « is available only to eligible customers through an account-level configuration under a written agreement », et met en garde contre l'idée qu'il s'appliquerait par défaut.