Aller au contenu

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.

Un nœud circulaire relié par des lignes courbes à six tuiles plates, dont une en bleu

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: true sur 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.

SonarAgent API
model: "sonar"effort: "fast", ou un identifiant de modèle comme perplexity/sonar
messagesinput, une chaîne simple ou un tableau d'éléments typés
le message systèmeinstructions, champ de premier niveau
search_domain_filtertools: [{"type": "web_search", "filters": {"search_domain_filter": [...]}}]
search_recency_filterle même objet filters sur l'outil web_search
web_search_options.user_locationuser_location sur l'outil web_search, en dehors de filters
num_search_resultsmax_results sur l'outil web_search
max_tokensmax_output_tokens
choices[0].message.contentoutput_text
les sources des citationsl'élément output de type: "search_results"
return_images, num_imagesun 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 obtenezOù le lireÀ quoi ça sert
Les recherches lancéesqueries sur l'élément search_resultslire le fan-out derrière une question, et compter ce que l'outil facture
Les pages récupéréesresults avec id, url, title, snippet, source, date, last_updatedla liste des sources, en URL d'éditeur et non en redirections
Le lien entre réponse et sourceles marqueurs [web:ID] dans output_textrattacher une phrase à une entrée par son identifiant
La trace des outilsdes éléments output comme fetch_url_results, image_search_results, sandbox_resultsvoir ce que le run a touché d'autre
La factureusage, avec input_tokens, output_tokens, tool_calls_details et un objet costle 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.

EndpointCe qu'il renvoieLes sources sous forme dePrix
POST /v1/agentune réponse générée et toute la trace des outilsélément search_results avec queries et resultsles jetons au tarif du modèle, plus 0,0025 $ par appel de recherche web, ou 0,001 $ avec Fast Search
POST /searchdes résultats web classés, sans réponse rédigéeresults avec title, url, snippet, date, last_updated5,00 $ les 1 000 requêtes, 1,00 $ avec Fast Search, aucun jeton facturé
POST /orchestrator/v1/chat/completionsune réponse générée au format OpenAIannotations avec des objets url_citation portant url, title, start_index, end_indexles 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.

ConfigurationFacturé pour une réponse citée
Un appel Fast Search, effort low sur openai/gpt-6-luna0,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/sonar0,001 $, plus les mêmes jetons à 0,25 $ et 2,50 $ le million, soit près de 0,0039 $
Un appel de recherche web standard0,0025 $ au lieu de 0,001 $, jetons inchangés
Un run de recherche avec dix appels de recherche0,01 $ d'appels d'outil à eux seuls, avant le premier jeton
fetch_url en plus, par page ouverte0,0005 $ par appel
La Search API, une requête de cinq questions au plus0,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, parmi hour, 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 avec country, region, city, latitude et longitude, placé en dehors de filters. Un appel nu n'a pas de pays, un acheteur situé en a un.
  • search_type, web pour l'index standard ou fast pour 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.

  1. 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.
  2. Aucune garantie que la recherche a eu lieu. L'outil est déclenché par le modèle : l'absence d'un élément search_results dans output signifie que la réponse vient des poids du modèle. Notez sa présence dans une colonne.
  3. 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 PerplexityCe qu'elle litCe qui revientPrix pour 1 000 réponses
API for GEOPerplexity interrogé nativement, dans le pays et la langue demandésréponse brute, URL citées par catégorie, mentions de marque, position, part de voix, sentiment, thèmes, questions de fan-out13 $, jusqu'à 7 $ au plus gros palier
Agent API, outil web_searchle modèle que vous avez choisi, avec la recherche de Perplexity attachéesearch_results avec queries et results, marqueurs [web:ID] en ligneenviron 1,80 $ en effort low sur openai/gpt-6-luna
Perplexity Search APIl'index classé de Perplexity, sans réponse rédigéeresults avec title, url, snippet, date, last_updated5,00 $, ou 1,00 $ avec Fast Search
clorol'interface perplexity.airéponse en markdown, sources avec position, questions associées, cartes produit, sous-requêtes4 $ sur le plan Lite
Bright Data AI Scrapersl'interfaceréponse brute, URL citées, produits shopping1,50 $
DataForSEO AI Optimizationl'interface et l'API officielle, sur des endpoints séparésréponse brute, URL citées, mentions de marque, questions de fan-out, produits shopping1,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

  1. Lire choices au lieu de output. Le texte de la réponse est dans output_text, et les sources sont un élément voisin dans un tableau typé. Un code qui indexe choices[0] renvoie du vide au lieu d'échouer franchement.
  2. Stocker l'id d'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à.
  3. Dimensionner le budget sur les questions. À partir de l'effort low, plusieurs appels de recherche par run sont la norme, et chacun se facture. Lisez tool_calls_details dans usage avant de vous engager sur un volume.
  4. Mélanger les valeurs de search_type dans 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.
  5. Compter sur search_language_filter. Il a été supprimé à la migration. Le ciblage par langue passe maintenant par user_location sur 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.