Nouveautés de l’API
Toutes les modifications de l’API REST et des outils MCP, des plus récentes aux plus anciennes.
-
2026-11-16 (v1.97.0)
L’AI Visibility Score se divise par les exécutions de suivi.
ai_visibility_scoresur/metrics/timeseries,/metrics/summary, les rapports d’analyse des modèles d’IA, les endpoints des rapports personnalisés et leurs outils MCP divise désormais les points d’une fenêtre ou d’une période par ses exécutions de suivi (une par jour, par semaine ou par mois, selon la fréquence de suivi du compte), et non plus par ses jours avec réponses. Pour un compte hebdomadaire, la semaine compte pour une seule exécution, même quand des prompts ajoutés en milieu de semaine ont répondu un autre jour : le score de cette semaine ne baisse donc plus. Rien ne change pour les comptes quotidiens. -
2026-11-14 (v1.96.0)
Les taux du résumé correspondent à ceux de l’application, et les noms de marque acceptent jusqu’à 100 caractères.
GET /metrics/summaryet l’outil MCPget_summarycumulent désormais les totaux de taux, de position et de sentiment sur toute la fenêtre, comme l’application : le taux de mention rapporte toutes les mentions de la fenêtre à toutes ses réponses,citation_rateses citations à ses réponses, une part de sentiment ses verdicts de ce type à tous ses verdicts, et une position moyenne est la moyenne de toutes les positions enregistrées dans la fenêtre. Auparavant, letotalétait la moyenne des valeurs des périodes, si bien qu’une semaine avec peu de réponses pesait autant qu’une semaine chargée ; il correspond désormais à la Vue d’ensemble pour les mêmes filtres.aggregationindique toujoursaverage, etmin,max,last, les totaux de comptage et l’AI Visibility Score ne changent pas. Lebrand_named’un projet accepte désormais au maximum 100 caractères :POST /projects,PATCH /projects/{id}, les brouillons de projet à la finalisation et les outils MCPcreate_projectetupdate_projectrefusent un nom plus long avecERR_INVALID_PARAM. Lorsquebrand_nameest omis, le nom du projet le remplace, avec la même limite. Les noms de marque déjà enregistrés continuent de fonctionner jusqu’à leur modification. -
2026-11-14 (v1.95.0)
Paramètres plus stricts, un seul AI Visibility Score et réponses datées à leur création. Les filtres et les indicateurs sont désormais contrôlés strictement en REST et en MCP : une valeur inconnue, un identifiant ou un indicateur mal formé (par exemple
12abcoumaybe), un identifiant qui n’appartient pas au projet, unrangemal formé ou unfrompostérieur àtorenvoieERR_INVALID_PARAMen nommant le paramètre au lieu d’être ignoré. Les valeurs énumérées sont acceptées quelle que soit la casse, dans les paramètres de requête comme dans les corps de requête (granularity=Week,event_type,cadence), et sont renvoyées dans leur graphie documentée. Sur/answers,/sentimentset les listes/dimensions, untoenvoyé sansfromdonne les 30 jours qui se terminent à cette date./answersetlist_answersacceptent aussiprompt_typeetbrand_kind. L’AI Visibility Score est désormais le même partout :/metrics/summaryetget_summaryrenvoient les points de la fenêtre divisés par ses jours avec réponses, soit le chiffre affiché dans l’application, et les périodes semaine et mois divisent leurs points par leurs propres jours avec réponses au lieu de les additionner. Le résumé de l’analyse des modèles d’IA suit la même règle, les points des concurrents étant divisés par les jours du projet. Les fenêtres de dates placent désormais chaque réponse au jour de sa création (fuseau Europe/Madrid), comme dans l’application, dans l’analyse des citations, les rapports d’analyse des modèles d’IA,/answers, les listes de dimensions et leurs outils MCP ; les chiffres de sentiment conservent l’heure d’exécution de la réponse. Avecoutput=csv, les horodatages utilisent la même forme ISO 8601 que le JSON, et/dimensions/adsrenvoieexecuted_atavec le décalage horaire Europe/Madrid. Créer un projet via l’API ou le MCP ne change plus le projet sélectionné dans l’application. Un concurrent ne peut plus utiliser une règle de domaine entier ou d’hôte exact sur le domaine du projet lui-même ; une règlepath_prefixsur ce domaine reste acceptée. Après la suppression d’un prompt, ses réponses, mentions et métriques restent prises en compte jusqu’à la fin du nettoyage en arrière-plan. -
2026-11-12 (v1.94.0)
Types de projet sur les accords personnalisés. Les comptes dont l’accord personnalisé tarifie chaque projet selon son type peuvent désormais choisir ce type à la création d’un projet :
POST /projectset l’outil MCPcreate_projectacceptent unproject_typefacultatif (par exemplecoreoulean), qui fixe le nombre maximal de prompts du projet et le prix auquel il est facturé ; s’il est omis, le projet prend le type par défaut du compte.PATCH /projects/:idet l’outil MCPupdate_projectpermettent de le changer ensuite (réservé au propriétaire du compte ou à un copropriétaire, avec une clé valable pour tout le compte), et le projet est facturé selon son nouveau type à partir du prochain renouvellement. Les détails du projet et les deux réponses renvoientproject_type, null pour les comptes sans types de projet. Tout autre compte qui l’envoie reçoitERR_INVALID_PARAM. -
2026-11-12 (v1.93.0)
Périodes des rapports personnalisés et détail mois par mois. Dans
GET /custom_reports,GET /custom_reports/{id}et les outils MCPlist_custom_reportsetget_custom_report,date_range.typepeut désormais aussi valoirprevious_3_months(les 3 mois calendaires qui précèdent le mois en cours) oucustom(dates fixes), etdate_rangeajoutecustom_frometcustom_to, les dates choisies pour une période personnalisée (null sinon). Letod’une période personnalisée s’arrête à aujourd’hui. Le nouveau widgetmonthly_breakdownrenvoie une ligne par mois calendaire de la période, avec ses réponses, ses mentions, son taux de mention, son AI Visibility Score, son Share of Voice, ses citations et sa position moyenne de mention. -
2026-11-11 (v1.92.0)
Les détails d’une page n’indiquent plus comment elle a été récupérée. L’objet
page_cachedes détails de page citée (GET /citation_intelligence/urls/{url_sha256},GET /citation_intelligence/urls/{url_sha256}/content, la vue par URL deGET /citation_intelligence/groups,GET /answers/{id}avecinclude_source_page_details=trueet leurs outils MCP) n’inclut plussource, un libellé interne non documenté qui désignait le service ayant récupéré la page. Aucun champ documenté n’a changé. -
2026-11-11 (v1.92.0)
Taux de réponse Trustpilot. Dans
GET /dimensions/owned_media?provider=trustpilot&view=brandset l’outil MCPlist_owned_media, chaque ligne de marque ajoutereviews_held,replied_count,not_replied_count,reply_rate_pctetmedian_reply_hours: la façon dont l’entreprise répond aux avis que nous conservons pour son profil (les plus récents de chaque relevé mensuel, pas tous les avis publiés sur Trustpilot), quelle que soit la période demandée.GET /dimensions/owned_media/summary?provider=trustpilotet l’outil MCPget_owned_media_summaryrenvoient les mêmes chiffres pour votre propre profil sousreplies. -
2026-11-11 (v1.91.0)
Bing AI Mode. La valeur
bing_ai_modedemodel(la page de réponse de l’IA dans Microsoft Bing, que Microsoft appelle Copilot Search, distincte decopilot) rejoint tous les endpoints et outils MCP qui filtrent par modèle, y compris l’analyse des citations et l’analyse des modèles d’IA. Les pages lues par ce modèle sans être citées sont des sources en arrière-plan : elles comptent comme citations mais n’ont pas de position de citation. -
2026-11-11 (v1.90.0)
Les liens vers les paramètres suivent les onglets renommés. Le
connect_urlrenvoyé lorsqu’un site WordPress est absent ou doit être reconnecté (GET /cms/content,GET /cms/content/{id},POST /intelligence_tasks/{id}/send_to_cmset leurs outils MCP) ouvre désormais la carte WordPress dans Paramètres du projet > Connexions (tab=data_connections#wordpress). Les liens avectab=wordpressfonctionnent toujours. Le message deERR_SEARCH_CONSOLE_ACCESS_REVOKEDet les descriptions des endpoints reprennent désormais les noms actuels des onglets : Connexions (anciennement Connexions de données) et Canaux de la marque (anciennement Réseaux et communautés, que certaines descriptions appelaient Médias propriétaires). Aucun champ, paramètre ni code d’erreur n’a changé. -
2026-11-09 (v1.89.0)
Part de chaque projet à la création de prompts. Sur un compte qui plafonne les exécutions de chaque projet à sa limite de prompts (les comptes en marque blanche complète et Enterprise Embed peuvent l’activer dans Paramètres du compte > Limites de prompts),
POST /prompts,POST /prompts/importet les outils MCPcreate_promptsetimport_promptsrenseignent aussifirst_runs_wait_untillorsque la part de réponses de l’IA propre au projet pour le cycle ne suffit pas à donner à chaque nouveau prompt une réponse par modèle d’IA activé, etwarningindique la part du projet comme motif. Rien ne change pour les autres comptes. -
2026-11-09 (v1.88.0)
Notes et avis Trustpilot.
GET /dimensions/owned_mediaet l’outil MCPlist_owned_mediaacceptentprovider=trustpilot:view=profilesliste les profils Trustpilot cités par les réponses de l’IA, avec leur note et leur nombre d’avis,view=brandsdonne la note, l’évolution de la note, le nombre d’avis et les citations de votre marque et de chaque concurrent, etview=reviewsliste les avis publiés sur leurs profils. Les lignes comportent désormaisrating,rating_change,reviews_count,status,brand,text,authoretreplied.GET /dimensions/owned_media/summaryet l’outil MCPget_owned_media_summaryacceptentprovider=trustpilot, etprovider=overviewinclut Trustpilot. Les notes et les avis sont relevés une fois par mois. -
2026-11-07 (v1.87.0)
Correspondances Search Console et corrections du trafic IA.
GET /search_console/ai_visibility_gapset l’outil MCPget_search_console_ai_visibility_gapsassocient désormais aussi une requête à un prompt dont les réponses de l’IA ont lancé cette même recherche, et chaque ligne comporte désormaismatch_type:prompt,fan_outounull. Les résultats Search Console rattachent les fragments d’URL comme#pricingà l’URL de base : une page n’apparaît donc qu’une fois, avec ses chiffres cumulés.GET /metrics/ai_trafficet l’outil MCPget_ai_trafficexcluent les sessions dont le support est payant, commecpc, sur Google Analytics 4 et Piano Analytics. -
2026-11-05 (v1.86.0)
Refus de répondre.
GET /answers,GET /answers/{id}et les outils MCPlist_answersetget_answerajoutentno_result_reasonà chaque réponse marquéeno_result:declinedquand le modèle a refusé de répondre (pour l’instant uniquement Gemini ; l’application l’affiche comme un refus) ouno_answerquand aucune réponse n’a pu être collectée. En cas de refus, le champresponsecontient désormais le texte renvoyé par le modèle au lieu d’un texte de remplacement.no_resultne change pas, et une véritable réponse ne comporte pas deno_result_reason. -
2026-11-05 (v1.85.0)
Lancer un rapport de réputation.
POST /reputation/reportset l’outil MCPcreate_reputation_reportlancent le rapport de réputation de marque du mois en cours, comme le bouton Générer de la page Réputation : 201 avec le nouveau rapport, ou 200 aveccreatedà false et le rapport qui couvre déjà le mois. Avecrecalculateà true, ils utilisent l’unique recalcul manuel du mois, qui relance tous les modèles d’analyse, et renvoientERR_LIMIT_REACHEDdès que le mois compte deux rapports. InterrogezGET /reputation/reportsjusqu’à ce que le rapport soit terminé. Nécessite le suivi de la réputation, une cléread_writeet, pour les membres de l’équipe, l’autorisation de création sur Réputation. -
2026-11-04 (v1.84.0)
Séries d’activité pour les médias propriétaires et Reddit.
GET /dimensions/owned_mediaaccepteview=activitypour YouTube, les réseaux sociaux et les applications mobiles. L’endpoint renvoie une ligne par entité et par période de suivi réelle du projet, avec le début de la période, les métadonnées actuelles de l’entité et les citations de la plage de dates sélectionnée. Les périodes sans exécution sont omises, et une période avec une exécution mais sans citation vaut zéro. Les lignes d’applications mobiles incluent la boutique d’applications et l’identifiant du concurrent ;entity_nameest l’identifiant de l’application, sans recherche externe.GET /dimensions/owned_media/summaryaccepteprovider=redditet renvoie l’activité de toutes les plateformes, y compris l’activité par plateforme dans la vue d’ensemble. Reddit ajoute les décomptes de sentiment positif, neutre et négatif, l’activité par subreddit, les tranches de position des citations et la part de la marque, ainsi que le nombre de subreddits et d’auteurs uniques etpositive_pct. Les paramètres existants restent en place ;viewetprovideracceptent ces nouvelles valeurs. Les membres de l’équipe doivent avoir accès à Réseaux et communautés, ainsi qu’à Reddit Intelligence pour Reddit ou à YouTube Intelligence pour YouTube. -
2026-11-04 (v1.83.0)
Envoyer les brouillons GEO Writer vers WordPress. Une fois un site WordPress connecté dans Paramètres du projet > WordPress,
POST /intelligence_tasks/{id}/send_to_cmsetsend_intelligence_task_to_cmsmettent en file d’attente un article ou une mise à jour de contenu terminés sous forme de nouveau brouillon sur ce site (202). Rien n’est publié, aucun article existant n’est modifié, et un nouvel envoi de la même version renvoie le brouillon existant.GET /intelligence_tasks/{id}etget_intelligence_tasklistent les brouillons danscms_draftsavec leur statut et leur lien de modification.GET /cms/content,GET /cms/content/{id},list_cms_contentetget_cms_contentlisent en direct les articles et les pages du site, avec un HTML nettoyé. Nouveaux codes :ERR_CMS_NOT_CONNECTED(404),ERR_CMS_ACCESS_REVOKED(403),ERR_CMS_REJECTED(422) etERR_CMS_UPSTREAM(503). Ces endpoints et outils ne sont pas disponibles sur les hôtes des portails en marque blanche. La référence indique désormaisrangeoufromcomme obligatoire surGET /metrics/summary,/metrics/prompt_summary,/metrics/timeseries,/metrics/sovet/metrics/top_sources. Ces endpoints refusaient déjà une requête sans l’un ni l’autre (ERR_INVALID_PARAM) : les appels existants ne sont donc pas affectés. -
2026-11-04 (v1.82.0)
Webhook des exécutions de suivi terminées. Le nouveau type d’événement
tracking_run.completedse déclenche une seule fois pour chaque exécution de suivi d’un projet : lorsque toutes les réponses de l’exécution sont définitives, que son analyse de sentiment est terminée et qu’aucune réponse ne s’y est ajoutée depuis une heure. Une intégration peut ainsi lire les nouvelles données dès leur arrivée au lieu d’interroger l’API à intervalles fixes. Une exécution est soit celle planifiée au début de chaque période de suivi, soit un lot plus petit lancé plus tard dans la période, par exemple pour de nouveaux prompts ou un modèle nouvellement activé. Le payload indique la période de suivi (period_startetperiod_end), lestatusde l’exécution (completed, outimed_outsi des réponses ou le sentiment manquaient encore au bout de 24 heures) et ses décomptes de réponses. -
2026-11-04
Les outils MCP de métriques indiquent leur période obligatoire.
get_prompt_summary,get_timeseries,get_sovetget_top_sourcesdéclarent désormais dans leur schéma d’entrée, comme le faisait déjàget_summary, qu’un appel exigerangeoufrom. Un appel sans l’un ni l’autre est refusé avant l’exécution de l’outil, toujours avecERR_INVALID_PARAM, et sonerrornomme désormais les deux arguments au lieu d’indiquerrange is required. Les endpoints REST ne changent pas. -
2026-11-04
Exécutions sans réponse exclues des taux du résumé par modèle.
GET /reports/ai_model_insights/summaryetget_ai_model_summarydivisent désormais les taux de mention et de citation de chaque modèle (mentions_market_share,citations_market_share) par les exécutions qui ont produit une réponse, comme le fait la matrice Analyse des modèles d’IA dans l’application. Les exécutions sans réponse (no_result: true, par exemple une recherche où Google n’affiche pas d’AI Overview) ne comptent plus dansdenominatorni dansdenominators_by_model: les taux des modèles qui en ont beaucoup augmentent donc. Un modèle non activé qui n’a eu que des exécutions sans réponse sur la période n’est plus listé. -
2026-11-03 (v1.81.0)
Rapports Search Console. Cinq nouveaux endpoints de lecture, chacun avec son outil MCP (
get_search_console_opportunities, etc.), lisent les données Search Console en direct et acceptent les mêmes paramètresproperty, de date et de périmètre que les autres endpoints Search Console.GET /search_console/opportunitiesclasse les requêtes situées entre les positions 4 et 20 (par défaut) selon les clics supplémentaires qu’apporterait une position dans le top 3, estimés au taux de clics du top 3 propre à la propriété.GET /search_console/cannibalizationliste les requêtes dont les impressions se répartissent entre au moins deux pages, avec la part de chaque page.GET /search_console/decayliste les pages ou requêtes qui ont perdu le plus de clics par rapport à la période précédente de même durée.GET /search_console/brand_splitrépartit les totaux entre les requêtes qui contiennent le nom de la marque et celles qui ne le contiennent pas.GET /search_console/ai_visibility_gapsassocie les principales requêtes aux prompts du projet dont le texte est identique et indique, pour chaque correspondance, les réponses de l’IA à ce prompt et la part d’entre elles qui mentionnent la marque. Ces rapports sont disponibles à partir du forfait Growth, et un membre de l’équipe doit aussi avoir accès à la Vue d’ensemble pour les lacunes de visibilité IA. Tous les rapports, sauf la répartition marque/hors marque, acceptentoutput=flatetoutput=csv. -
2026-11-03 (v1.80.0)
Le quota de réponses de l’IA dans les données du compte.
GET /accountetget_account_usageajoutentlimits.prompt_executions: les réponses de l’IA que le compte peut obtenir sur le cycle de suivi en cours (sa limite de prompts multipliée par le nombre de ses modèles d’IA activés, plus 5 %), le nombre de réponses utilisées et restantes,period(day,weekoumonth) etresets_at. Chaque exécution programmée et chaque première exécution d’un nouveau prompt consomment une réponse par modèle d’IA, la suppression d’un prompt ne restitue aucune réponse, et une fois le quota épuisé, les nouveaux prompts attendent jusqu’àresets_at.limits.geo_audit_manual_runs, jusqu’ici le seul quota à période quotidienne, compte les exécutions manuelles d’audits GEO, et non les exécutions de prompts. -
2026-11-03 (v1.79.0)
La création de prompts indique quand les premières exécutions doivent attendre.
POST /prompts,POST /prompts/importet leurs outils MCPcreate_promptsetimport_promptsrenvoientfirst_runs_wait_until. Ce champ est renseigné quand les réponses de l’IA qui restent dans le quota du compte pour le cycle ne suffisent pas à donner à chaque nouveau prompt une réponse par modèle d’IA activé : les autres s’exécutent à la réinitialisation du quota, à l’heure indiquée par ce champ, etwarningle signale. Sinon, il vaut null. Les descriptions indiquent désormais que les nouveaux prompts reçoivent leurs premières réponses sous 24 heures environ, et non en quelques minutes. -
2026-11-03 (v1.78.0)
La réponse du résumé par modèle entre dans le contrat. Les documents OpenAPI et Swagger, et donc les SDK, décrivent désormais la réponse de
GET /reports/ai_model_insights/summary, qui n’avait pas de schéma. Ses lignes sont les modèles d’IA que le compte a activés ou qui ont répondu sur la période.share_of_total,net_sentimentet lavaluedes parts de marché des mentions, des citations et du sentiment sont nullables : ils valentnullquand aucune donnée ne les alimente, tandis que les décomptes, les totaux et les scores de visibilité pondérés restent à 0. La réponse elle-même ne change pas. -
2026-11-02
Tous les modèles d’IA dans le résumé par modèle, périodes vides à null dans le MCP.
GET /reports/ai_model_insights/summaryetget_ai_model_summarylistent chaque modèle d’IA que le compte a activé ou qui a répondu sur la période, dans l’ordre affiché par l’application, au lieu de dix modèles fixes. Unshare_of_totalsans rien à répartir, unnet_sentimentsans sentiment et une valeur de part de marché pour un modèle qui n’a ni réponse ni sentiment valent désormaisnull, car 0 est une vraie valeur. Les outils MCPget_timeseriesetget_summaryrenvoientnullpour une période sans réponse au lieu de 0 ou d’une valeur reportée (responsesreste à 0) ; les endpoints REST conservent leur comportement.POST /prompts,POST /prompts/importetcreate_projectconsidèrent comme des doublons les prompts qui ne diffèrent que par la casse ou les espaces. La ligne de votre marque dansGET /dimensions/competitorsportematching_names, et lecontextd’une recommandation ne renvoie que les champs qui décrivent l’exécution. -
2026-11-02
Revalidation simplifiée sur les endpoints de métriques.
GET /metrics/timeseries,GET /metrics/summary,GET /metrics/prompt_summary,GET /metrics/sovetGET /metrics/top_sourcesn’envoient plusLast-Modifiedet ignorentIf-Modified-Since. LeurETagest désormais un hash du corps de la réponse : une réponse JSON, qui porte un nouveaurequest_idà chaque fois, revient donc toujours en entier, et seule une réponseoutput=csvinchangée peut encore donner lieu à un304 Not Modified. La version des données qu’ils utilisaient auparavant était plus lente à calculer que les métriques elles-mêmes sur les gros projets. Les champs de réponse ne changent pas. -
2026-11-01 (v1.77.0)
Projets de pitch.
POST /projectsetcreate_projectacceptentpitch: truepour créer un projet de pitch, un instantané ponctuel destiné à un prospect, qui exécute ses prompts une seule fois, n’occupe aucun emplacement de projet et est supprimé 90 jours plus tard s’il n’est pas converti.PATCH /projects/{id}etupdate_projectavecpitch: false, envoyé seul, convertissent un projet de pitch en projet suivi.GET /dimensions/projectsetlist_projectsexcluent les projets de pitch, sauf avecpitch=includeoupitch=only, et chaque ligne de projet comporte désormaispitchetpitch_expires_at. Les détails du projet ajoutentpitch_run(statut, dates, modèles d’IA et réponses reçues),GET /accountajoutelimits.pitch_projectsavec le quota mensuel et l’accès du compte, etuntracked_reasonpeut valoirpitch_project. Une fois qu’un projet de pitch a été exécuté, ses prompts sont figés : en ajouter, en importer ou en supprimer un renvoieERR_INVALID_PARAMavecerror.meta.reasonpitch_prompts_frozen. Dans les outils MCP, un projet de pitch n’est accessible que par son identifiant. -
2026-11-01 (v1.76.1)
GEO Optimization devient Audits GEO. L’espace de l’application consacré aux audits et rapports GEO techniques s’appelle désormais Audits GEO, tout comme l’autorisation des membres de l’équipe qui contrôle l’accès aux endpoints et aux outils MCP des audits GEO et des rapports GEO techniques. Le champ
app_urld’un audit GEO, d’une exécution ou d’une alerte pointe désormais vers/app/tools/geo-audits; les liens vers les anciennes pages/app/tools/geo-optimizationy redirigent. Les endpoints, les paramètres, les champs et les noms des outils MCP ne changent pas. -
2026-10-31 (v1.76.0)
Filtres Aucune citation et Aucune mention.
citation_filtersurGET /answersetGET /dimensions/prompt_executions, ainsi que sur les outils MCPlist_answersetlist_prompt_executions, accepteno_citations: les réponses qui ne citent aucune source, contrairement àcites_no_brands, qui autorise toujours d’autres domaines. Sur les réponses,mention_filter=no_brandsetcitation_filter=no_citationsne renvoient que les réponses terminées et excluent les exécutions en attente, en échec ou vides. Les pages Réponses et Prompts les affichent sous les libellés Aucune mention et Aucune citation. -
2026-10-31 (v1.75.0)
Sentiment et répartitions Reddit dans l’API et le MCP.
GET /dimensions/redditetlist_reddit_citationsacceptentview=breakdowns, qui renvoie les chiffres de Reddit Intelligence > Sentiment et répartitions : les citations Reddit réparties selon le sentiment de la réponse de l’IA qui les a citées (les cinq libellés, y compris ceux à zéro), par modèle d’IA et par pays, chaque tranche avec soncountet sonpctau sein de la répartition, comme sur les graphiques de la page. Les autres filtres de l’endpoint s’appliquent, et il prend en chargeoutput=flatetoutput=csv. -
2026-10-29
Les outils d’analytique web en direct ne sont pas disponibles dans ChatGPT. Les connexions ChatGPT, depuis l’application ChatGPT ou un connecteur personnalisé, ne listent ni n’exécutent plus les outils MCP
get_web_analytics_schemaetquery_web_analytics. Dans ChatGPT,get_ai_trafficrépond toujours aux questions sur le trafic référent provenant de l’IA ; Claude, les autres clients MCP et les clés API conservent les deux outils. L’outil MCPcreate_webhook_subscriptionporte désormais l’annotationdestructiveHint: true: lorsque la clé API ou la connexion OAuth qui a créé un abonnement a été révoquée, recréer cet abonnement supprime l’ancien et émet un nouveau secret de signature. -
2026-10-28 (v1.74.0)
Naver AI Tab, Qwen et Doubao. Les valeurs
naver_ai_tab,qwenetdoubaodu paramètremodelsont acceptées par tous les endpoints et outils MCP qui filtrent par modèle, y compris Citation Intelligence et Analyse des modèles d’IA. Qwen et Doubao n’indiquent aucune citation dans la réponse : chaque page qu’ils lisent est donc une source en arrière-plan, comptée comme citation mais sans position de citation. -
2026-10-28 (v1.73.0)
Supprimer un projet via l’API. Le nouvel endpoint
DELETE /projects/:idet l’outil MCPdelete_projectsuppriment un projet comme le bouton « Supprimer le projet » des Paramètres du projet : il disparaît immédiatement et libère un emplacement de projet, et une tâche en arrière-plan purge ses données. Cette action est irréversible. Ils exigent une clé read_write qui n’est pas limitée à certains projets (sinonERR_KEY_PROJECT_SCOPED), et les membres de l’équipe doivent avoir l’autorisation de supprimer des projets. -
2026-10-28 (v1.72.0)
Clés API via l’API. Les nouveaux endpoints
GET /api_keys,POST /api_keysetDELETE /api_keys/:idlistent vos clés, créent une clé limitée à certains de vos projets (son token n’est renvoyé qu’une seule fois) et en révoquent une. Ils exigent une clé read_write valable pour tout le compte, ne créent jamais de clé valable pour tout le compte et n’ont pas d’outil MCP. La liste et la révocation fonctionnent aussi en dessous du forfait Scale. -
2026-10-25 (v1.71.0)
Pas d’API pour les comptes qui ne paient pas, état de suivi des projets et des prompts, et suppression des webhooks en dessous de Scale. Toute requête REST ou MCP, lectures et OAuth compris, renvoie
403 ERR_ACCOUNT_INACTIVEquand le compte ne s’est jamais abonné ou que son abonnement a pris fin il y a plus de trois jours, et ses webhooks n’envoient rien tant qu’il ne paie pas. Les comptes réglés sur facture en sont exemptés. À partir de la date de fin de la période payée, les fonctions payantes (GEO Writer, rapports GEO techniques, exécutions d’audits GEO, recommandations, suggestions de prompts, brouillons de projet,ask_support) renvoient le même code et les nouveaux prompts n’ont pas de première exécution. Les projets, les détails du projet et les prompts renvoienttrackedetuntracked_reason, etPOST /promptset/prompts/importajoutent unwarningquand les prompts ne seront pas exécutés.GET /webhooksetDELETE /webhooks/:idfonctionnent sur tous les forfaits, pour supprimer un abonnement mis en pause en dessous du forfait Scale. Les audits GEO gagnent la valeurquotapourpaused_reason,public_link_activeexige un compte actif à partir du forfait Scale, et les exécutions des recommandations Sentiment et réputation renvoientERR_NOT_FOUNDsans accès à la réputation. -
2026-10-24 (v1.70.0)
Les filtres que l’API acceptait déjà entrent dans le contrat, et range s’applique aux listes. Les documents OpenAPI et Swagger, et donc les SDK, la CLI et les connecteurs, listent désormais des paramètres que ces endpoints lisaient sans les documenter :
country_code,language_codeetinclude_projectsurGET /metrics/summaryetGET /metrics/sov;collection_idsetdomainssurGET /metrics/top_sources;prompt_type,brand_kindetrangesurGET /dimensions/mentions,/citations,/competitor_mentions,/competitor_citations,/all_mentions,/all_citationset/sources(pluscountry_codeetlanguage_codesur les listes des concurrents et les listes combinées) ; etprompt_typeetbrand_kindsurGET /dimensions/prompt_executions. Correction de comportement :rangeétait ignoré sur ces sept listes REST, qui renvoyaient donc tout l’historique ; elles se limitent désormais aux N derniers jours, comme le faisaient déjà leurs outils MCP ; unfromou untoexplicite reste prioritaire, et unrangequi n’est pas un seul nombre positif, ou qui dépasse 1 500 jours, renvoieERR_INVALID_PARAM.domainssurGET /metrics/top_sourcesetGET /citation_intelligence/mentions_by_domain, ainsi quecollection_idssurGET /metrics/top_sources, acceptent une valeur ou une liste séparée par des virgules (domains=gmac.com,educaweb.com), et la forme entre crochetsdomains[]=fonctionne toujours. Undomainsséparé par des virgules ne correspondait auparavant à aucun domaine, et un client qui répétait la clé (domains=a&domains=b, comme le faisaient la plupart des SDK générés pourmentions_by_domain) n’obtenait que la dernière valeur ; les SDK régénérés envoient la forme séparée par des virgules.modelsurGET /reports/ai_model_insights/position_distributionne liste plus que les sept modèles acceptés par l’endpoint ; les autres valeurs étaient déjà refusées avecERR_INVALID_PARAM.statussurGET /intelligence_tasksliste désormais ses valeurs. Les outils MCP ne changent pas. -
2026-10-23 (v1.69.0)
Motifs d’archivage et effort pour les éléments de recommandation.
PATCH /recommendations/:id/items/:item_idetupdate_recommendation_itemacceptent unreasonfacultatif lors de l’archivage (not_relevant,too_complexoucompetitor), dont les exécutions suivantes des recommandations tiennent compte ; il est renvoyé dansmetadata.archive_reason. Les nouveaux éléments portentmetadata.effort(low,mediumouhigh). -
2026-10-22 (v1.68.0)
Plusieurs propriétés Search Console par projet. Le nouvel endpoint
GET /search_console/properties(MCPlist_search_console_properties) liste jusqu’à 10 propriétés connectées. Chaque lecture Search Console accepteproperty: un identifiant de propriété, ou une liste séparée par des virgules ouallpour en combiner plusieurs, avec en réponseproperties,excluded_properties(déjà comptées par une autre propriété sélectionnée) etproperty_errors.propertyest aussi unedimensiondu résumé et une dimension des lignes, et les détails du projet indiquentsearch_console.properties_count. -
2026-10-21 (v1.67.0)
État des connexions de données et liens de connexion.
GET /dimensions/projects/:idetget_project_detailsrenvoient désormaisai_trafficetagent_trafficà côté desearch_console, pour qu’un client voie quelles sources de données un projet possède avant d’appeler leurs endpoints. Chacun comporte unstatus(connected,reconnect_requiredounot_connected, plusimportedquand le trafic des agents provient uniquement de logs importés), lapropertyou leproviderconnecté, etconnect_url, la page où connecter ou reconnecter la source. Les erreurs « non connecté » et « accès révoqué » des endpoints Search Console, trafic IA, analyse web et trafic des agents portent le même lien danserror.meta.connect_url, et leurs outils MCP le renvoient sousconnect_url. Rien d’autre ne change dans ces réponses. -
2026-10-19 (v1.66.0)
URL de webhook masquées, webhooks en pause en dessous de Scale, champs de réponse selon le forfait et autorisations à l’import. Avec une clé API en lecture seule, ou une connexion OAuth MCP sans
mcp:write,GET /webhookset l’outil MCPlist_webhook_subscriptionsn’affichent plus detarget_urlque le schéma, l’hôte et le port s’il n’est pas celui par défaut, suivis de/…(par exemplehttps://hook.eu1.make.com/…), car l’URL complète peut permettre à n’importe qui d’envoyer des requêtes au destinataire. Une cléread_write, ou une connexion avecmcp:write, reçoit toujours l’URL complète. Un abonnement créé par une clé API limitée à certains projets s’arrête définitivement dès que cette clé ne couvre plus le projet de l’abonnement : il apparaît avecdisabled: true, et le recréer avec le même projet, le même événement et la même URL le remplace par un nouvel abonnement doté d’un nouveau secret. Tant que le compte est en dessous du forfait Scale, ses abonnements sont conservés mais n’envoient rien : aucun envoi en échec n’est compté et aucun abonnement n’est désactivé. Les envois reprennent dès que le compte repasse au forfait Scale ou à un forfait supérieur, et les événements de cette période ne sont pas renvoyés.GET /answers/:idomet désormaissentimentsen dessous du forfait Growth etshopping_productsen dessous du forfait Scale, comme le faisait déjà l’outil MCPget_answer. Les deux renvoientplan_required_fields, la liste des champs omis, toujours présente et vide si rien n’est omis ;get_answerla renvoyait auparavant sous forme d’objet indiquant le forfait de chaque champ, et seulement quand un champ était omis. DansPOST /prompts/importet l’outil MCPimport_prompts, une ligne qui nécessite un tag encore inexistant est ignorée pour un membre de l’équipe sans autorisation de création sur les tags, et une ligne correspondant à un prompt qui existait déjà ne lui ajoute aucun tag pour un membre de l’équipe sans autorisation de modification sur les prompts (la ligne est listée quand elle en aurait ajouté un). Les deux cas sont renvoyés dansrow_errors, à côté des lignes ignorées parce qu’elles donnaient plus de 50 tags à un prompt ou portaient la requête au-delà de 500 nouveaux tags, des limites que la description de l’import indique désormais. -
2026-10-19 (v1.65.0)
Limites des variantes du nom.
matching_namesaccepte désormais au maximum 50 noms, de 100 caractères chacun au plus, surPOST /projects,PATCH /projects/:id,POST /competitors,PATCH /competitors/:idetPOST /project_drafts/:id/finalize, ainsi que sur les outils MCPcreate_project,update_project,create_competitor,update_competitoretfinalize_project_draft. Ces 50 noms incluent le nom de marque quePOST /competitorsetPATCH /competitors/:idajoutent à la liste. Une liste plus longue ou un nom plus long renvoieERR_INVALID_PARAM(422) et aucun élément de la requête n’est appliqué. Les étapes dePATCH /project_drafts/:idcontinuent d’enregistrer les listes telles qu’elles sont envoyées, et la finalisation les vérifie. Les schémas de requête OpenAPI déclarent les deux limites avecmaxItemsetmaxLength. Une liste enregistrée avant ce changement continue de fonctionner jusqu’à sa prochaine modification. -
2026-10-16 (v1.64.0)
Limites de prompts par projet dans l’API et le MCP.
GET /dimensions/projects/:idetget_project_detailsrenvoientprompt_limit(null en l’absence de limite) etstats.prompts_available, le nombre de prompts que le projet peut encore accueillir : la plus petite valeur entre la marge restante sous cette limite et les prompts restants du compte, 0 au minimum, et null uniquement quand aucune des deux ne s’applique.PATCH /projects/:idet l’outil MCPupdate_projectacceptent unprompt_limitentier de 1 à 2147483647, ou null pour supprimer la limite. Seul le propriétaire du compte ou un admin du compte (copropriétaire) disposant de l’autorisation de modification des projets peut la modifier : les autres membres de l’équipe reçoiventERR_INSUFFICIENT_PERMISSION, une clé limitée à certains projets reçoitERR_KEY_PROJECT_SCOPED, et une requête refusée n’applique rien. Des valeurs comme"5"ou5.0renvoientERR_INVALID_PARAM. Une limite inférieure au nombre actuel de prompts ne supprime aucun prompt ; les nouveaux sont refusés jusqu’à ce que le projet repasse sous la limite. Une requête qui n’envoie queprompt_limitest enregistrée même pendant un recalcul. -
2026-10-15 (v1.63.0)
Davantage de fonctions de l’application dans l’API et le MCP.
GET /custom_reports,GET /custom_reports/:idetPOST /custom_reports/:id/send(list_custom_reports,get_custom_report,send_custom_report) listent, lisent et envoient les rapports personnalisés.PATCH /recommendations/:id/items/:item_id(update_recommendation_item) marque comme terminé, archive ou restaure un élément de recommandation.GET /reports/sentiment/topicsetGET /reports/sentiment/tags(get_sentiment_topics,get_sentiment_tags) renvoient le sentiment par thème et par tag, comme la page Sentiment.GET /competitors/suggestions(list_competitor_suggestions) renvoie les concurrents suggérés et les domaines les plus cités de la page Concurrents. -
2026-10-15 (v1.63.0)
Médias propriétaires et profils sociaux dans l’API.
GET /dimensions/owned_media/summary(get_owned_media_summary) renvoie les chiffres de chaque onglet de la page Médias propriétaires, YouTube et LinkedIn compris : les citations de la plateforme, la part qui cite vos profils et contenus, l’évolution par rapport à la période précédente, les citations hebdomadaires et les répartitions par modèle d’IA, pays, type de contenu et ancienneté.GET /dimensions/owned_media/citing_prompts(list_owned_media_citing_prompts) liste les réponses qui citent une publication, une vidéo ou un profil.GET /projects/:id/owned_mediaetPATCH /projects/:id/owned_media(get_owned_media_profiles,update_owned_media_profiles) lisent et définissent les profils qui comptent comme les vôtres, comme dans Paramètres du projet > Médias propriétaires. -
2026-10-15 (v1.63.0)
Toutes les façons d’ajouter des prompts, via l’API.
POST /prompts/importet l’outil MCPimport_promptsacceptent jusqu’à 500 lignes, chacune avec son pays, sa langue et ses tags, comme l’import CSV.POST /prompt_generationsetgenerate_prompt_suggestionslancent les générateurs de suggestions de l’application (site web, mot-clé, thème, Reddit, People Also Ask, réputation, traduction et Search Console) et répondent 202 avec une exécution à suivre surGET /prompt_generations/:id(get_prompt_generation). Les idées arrivent dans la file de suggestions :GET /suggested_prompts(list_suggested_prompts) la liste,POST /suggested_prompts/accepttransforme des idées en prompts suivis etPOST /suggested_prompts/rejectles écarte (accept_suggested_prompts,reject_suggested_prompts).POST /prompts/remove_tagsest désormais le jumeau REST de l’outil MCPremove_prompt_tags, etPATCH /prompts/:id(update_prompt_categorization) définit manuellement la classification d’un prompt : intention de recherche et marque dans le prompt. -
2026-10-14 (v1.62.0)
Citations par période pour une URL, un domaine ou un hôte cités.
GET /citation_intelligence/urls/:url_sha256et l’outil MCPget_cited_url_detailsacceptentinclude_series=true, qui ajoutecitation_series: les réponses citant l’URL par modèle d’IA (by_model) et par période (data), par jour, semaine ou mois selon la fréquence de suivi du compte (granularity), avectotalégal àstats.total_responses. Les périodes datent chaque réponse d’après sonexecuted_at, dans le fuseau Europe/Madrid. Sansinclude_series, la réponse ne change pas. L’endpoint documente désormais les filtres qu’il appliquait déjà (model,collection_id,country_code,language_code,prompt,from,to,source_type,sentimentetcontent_gap) et acceptebrand_kind. Pour un domaine ou un hôte,GET /citation_intelligence/groupset l’outil MCPlist_citation_groupsacceptentkey, qui ne renvoie que ce groupe de la vue choisie, et aveckey,include_series=trueajoute le mêmecitation_seriesà sa ligne ;include_seriessanskeyrenvoieERR_INVALID_PARAM(422).GET /citation_intelligence/groupsapplique aussibrand_kind, qu’il ignorait auparavant. -
2026-10-14 (v1.62.0)
Le balisage des fiches produit est nettoyé, et non refusé. Sur une tâche
product_listing,PATCH /intelligence_tasks/:idet l’outil MCPupdate_intelligence_task_contentne conservent quep,ul,ol,li,strong,em,h3etbrdansdescription_html, sans attribut. Les autres balises et tous les attributs sont supprimés et la modification aboutit quand même : lisez donc la valeur enregistrée dans la réponse.POST /intelligence_tasks/:id/revertrestaure la description générée, nettoyée de la même façon. -
2026-10-14 (v1.62.0)
Un refus de répondre est aussi une non-réponse sentinelle. Lorsque le modèle refuse de répondre à un prompt (aujourd’hui uniquement Gemini, en raison de ses filtres de sécurité ou d’un thème restreint),
GET /answers,GET /answers/:idet les outils MCPlist_answersetget_answerrenvoient cette exécution avecno_result: trueet le texte de remplacement habituel, comme une exécution pour laquelle aucune réponse n’a pu être collectée malgré toutes les tentatives. Une telle exécution n’est pas relancée et reste exclue de toutes les métriques de la plateforme. La structure de la réponse ne change pas ; les descriptions deno_resultcitent désormais les deux causes. -
2026-10-14 (v1.61.0)
Secret du webhook réservé à l’identifiant d’accès qui a créé l’abonnement. Envoyer de nouveau le même projet, le même événement et la même URL à
POST /webhooks, ou appeler à nouveau l’outil MCPcreate_webhook_subscription, renvoie, comme avant, l’abonnement existant, mais n’inclutsecretque si l’appel provient de la clé API ou de la connexion OAuth qui l’a créé. Toute autre clé API ou connexion OAuth reçoit l’abonnement sanssecretet ne peut donc plus lire un secret de signature qui ne lui a pas été remis. Un abonnement créé via une connexion OAuth MCP avant la v1.58.0 n’a pas de créateur enregistré : il ne renvoie donc plus jamaissecret. Un nouvel abonnement, y compris s’il en remplace un dont la clé API ou la connexion OAuth créatrice a été révoquée, renvoie toujourssecret. Pour obtenir un nouveau secret pour un abonnement existant, supprimez-le puis recréez-le. -
2026-10-12 (v1.60.0)
Un code sur chaque erreur d’outil MCP. Chaque
tools/callen échec porte désormaiscodeà côté deerror, avec la valeur que l’endpoint REST renvoie pour le même état ; jusqu’ici, certaines erreurs d’outil ne portaient queerror, et les deux refus émis avant l’exécution d’un outil (arguments obligatoires manquants, valeur rejetée par le schéma d’entrée) arrivaient en texte brut, et non sous forme d’objet JSON avecerror. Les arguments manquants ou invalides, y compris les valeurs que le schéma d’entrée d’un outil rejette avant son exécution, renvoientERR_INVALID_PARAM. Un projet inconnu renvoieERR_PROJECT_NOT_FOUNDsur tous les outils, et tout autre enregistrement introuvableERR_NOT_FOUND(ERR_DRAFT_NOT_FOUNDpour les brouillons). Un outil refusé en raison d’un scope OAuth ou une clé en lecture seule renvoieERR_INSUFFICIENT_SCOPE, pour les autorisations d’un membre de l’équipeERR_INSUFFICIENT_PERMISSION, et sur un portail en marque blancheERR_INTEGRATION_UNAVAILABLE. Les refus liés aux budgets et aux limites quotidiennes renvoientERR_LIMIT_REACHEDouERR_QUOTA_EXCEEDED, comme en REST. Le texte deerrorne change pas. -
2026-10-12 (v1.60.0)
GET /dimensions/sources refuse un source_type inconnu ou à la casse différente.
GET /dimensions/sourcesignorait auparavant unsource_typeinconnu, ou la forme tableausource_type[], et listait toutes les sources, tandis qu’une valeur à la casse différente commeOwnedétait appliquée commeowned. L’endpoint accepte désormais exactementowned,competitorouthird_party; toute autre valeur, y comprisOwnedetOWNED, renvoieERR_INVALID_PARAM(422) avec les valeurs acceptées. L’outil MCPlist_sourcesrefuse les mêmes valeurs avec le même code. -
2026-10-12 (v1.60.0)
Autres domaines de la marque dans l’API.
PATCH /projects/:idet l’outil MCPupdate_projectacceptentadditional_owned_domains, les autres domaines détenus par la marque, dont les citations comptent comme les vôtres, jusqu’ici modifiables uniquement dans l’application. Cette liste remplace entièrement la précédente et compte 10 domaines au maximum ;[]la vide. Une URL collée est enregistrée sous la forme de son domaine. Mêmes règles que dans l’application : un sous-domaine, une plateforme partagée par de nombreuses entreprises (comme youtube.com, amazon.com ou wordpress.com), le site web du projet ou un domaine suivi par un concurrent est refusé avecERR_INVALID_PARAMet le motif.GET /dimensions/projects/:idetget_project_detailsrenvoient la liste. -
2026-10-12 (v1.60.0)
Autres domaines de la marque : recalcul et modifications réservées au propriétaire. Une modification de
additional_owned_domainsretraite en arrière-plan les réponses passées qui citent un domaine ajouté ou retiré (rematching: true) ; une liste réordonnée ou identique ne lance rien. Seul le propriétaire du compte peut l’envoyer : la clé ou la connexion d’un membre de l’équipe, y compris celle d’un copropriétaire, reçoitERR_INSUFFICIENT_PERMISSIONet aucun élément de la requête n’est appliqué. Une requête s’applique entièrement ou pas du tout, et une requête envoyée avecmatching_namesne lance qu’un seul recalcul. L’objetprojectde la réponse renvoie la liste, etPATCH /projects/:idpublie désormais son schéma de réponse. Pendant un recalcul,PATCH /projects/:idet l’outil MCPupdate_projectrefusent toute nouvelle modification avecERR_INVALID_PARAM; ce message ne promet plus une attente de quelques minutes et demande désormais de réessayer une fois le recalcul terminé. -
2026-10-12 (v1.60.0)
Ce que conserve la suppression d’un concurrent.
DELETE /competitors/:idet l’outil MCPdelete_competitorconservent désormais les produits Shopping et les entités de marque du concurrent, que la tâche en arrière-plan supprimait auparavant, et ne laissent plus ses publicités ni ses établissements locaux sans propriétaire. Ces quatre types de données sont rattachés au projet ou à un autre concurrent dont le domaine leur correspond, ou restent non attribués. La tâche continue de supprimer les mentions, les citations, le sentiment et l’historique de Share of Voice du concurrent. -
2026-10-12 (v1.60.0)
Exceptions du filtre de modèle documentées. La référence décrit désormais le filtre
modeltel que chaque endpoint l’appliquait déjà. Un modèle inconnu, ou que le compte n’a pas activé, renvoieERR_INVALID_PARAM(422), avec les exceptions suivantes.GET /sentimentsignore une telle valeur. Les endpoints d’analyse des citations n’acceptent quechatgpt,ai_mode,ai_overview,perplexity,gemini,naver_aietbaidu_ai.GET /reports/ai_model_insights/position_distributionaccepte ces sept modèles même lorsqu’ils ne sont pas activés. Les endpoints/metricsacceptent aussigoogle-ai-modeetgoogle-ai-overview, comme équivalents deai_modeetai_overview. -
2026-10-12 (v1.60.0)
Forme tableau du filtre de modèle refusée sur les listes de dimensions.
model[]était auparavant ignoré sur les listes/dimensions, qui renvoyaient donc des données non filtrées. Il renvoie désormaisERR_INVALID_PARAM(422), comme sur/metricset/answers.project_idsurGET /dimensions/agent_botsest désormais documenté comme obligatoire mais ignoré : le catalogue de bots est le même pour tous les projets. -
2026-10-12 (v1.60.0)
Nom de marque dans les listes de projets, et filtre de modèle sur les prompts.
GET /dimensions/projectset l’outil MCPlist_projectsrenvoient désormais lebrand_namede chaque projet (null s’il n’est pas défini), tout comme leprojectqueGET /pingajoute lorsqu’il est appelé avecproject_id, comme le déclarait déjà le schéma Project publié.GET /dimensions/promptsapplique désormaismodel, qu’il ignorait jusqu’ici : il conserve les prompts ayant au moins une exécution sur ce modèle, quels qu’en soient le résultat et la date. Son filtreprompt, qui fonctionnait déjà, est désormais documenté. L’outil MCPlist_promptsaccepte les deux filtres. -
2026-10-12 (v1.60.0)
Les webhooks dont l’identifiant d’accès est révoqué apparaissent comme désactivés.
GET /webhookset l’outil MCPlist_webhook_subscriptionsrenvoientdisabled: true, au lieu defalse, pour un abonnement dont la clé API ou la connexion OAuth a été révoquée. Un tel abonnement ne reçoit plus d’événements. Supprimez-le, ou recréez-le avec le même projet, le même événement et la même URL pour le remplacer par un nouvel abonnement et un nouveau secret. -
2026-10-12 (v1.59.0)
Les lignes de
GET /metrics/prompt_summarycomportent désormais le sentiment de marque de chaque prompt :sentiment_responses(réponses avec un verdict de sentiment pour la marque), les cinq pourcentagessentiment_*rapportés à ce nombre etnet_sentiment, calculés comme les métriques de sentiment de/metrics/timeserieset null lorsqu’aucune réponse n’a de verdict. Ils respectentbreakdown=modelet tous les filtres, et ne permettent pas de trier. Chaque ligne comporte aussi le pays, la langue, l’intention de recherche, la marque dans le prompt et les tags de son prompt, comme dans/dimensions/prompts. L’outil MCPget_prompt_summaryrenvoie les mêmes champs. -
2026-10-12 (v1.58.0)
API des membres de l’équipe. Gérez l’équipe du compte via l’API, selon les mêmes règles que la page de paramètres Membres de l’équipe. Les nouveaux endpoints
GET /team_membersetGET /team_invitationslistent les membres (propriétaire du compte en premier) et les invitations en attente, avec leurs accès et leurs projets,POST /team_invitationsenvoie une invitation par e-mail,DELETE /team_invitations/:iden révoque une etDELETE /team_members/:idretire un membre. Les outils MCP sontlist_team_members,list_team_invitations,invite_team_member,revoke_team_invitationetremove_team_member. La lecture est réservée au propriétaire du compte, aux copropriétaires et aux membres disposant de l’autorisation Membres de l’équipe ; la révocation et le retrait sont réservés au propriétaire ou à un copropriétaire. Un membre de l’équipe autorisé à inviter ne peut pas choisir les accès : l’invitation reprend ses propres autorisations. Les écritures exigent une clé API de portée read_write, et une clé API limitée à certains projets reçoitERR_KEY_PROJECT_SCOPED(403) sur tous les endpoints d’équipe. Les invitations envoyées via l’API et le MCP sont soumises à une limite quotidienne qui compte aussi les invitations révoquées ; l’atteindre renvoieERR_LIMIT_REACHED. -
2026-10-12 (v1.58.0)
Vérification de version dans GEO Writer, plages de trafic plus strictes et abonnements webhook envoyés de nouveau. Les payloads des tâches GEO Writer renvoient
result_version, etPATCH /intelligence_tasks/:idet l’outil MCPupdate_intelligence_task_contentl’acceptent comme champ facultatif. Si la tâche a été régénérée depuis que vous l’avez lue, la modification est refusée avec le nouveau code d’erreurERR_STALE_CONTENT(409), rien n’est écrit eterror.meta.result_versioncontient le token actuel. Sansresult_version, les modifications s’appliquent comme avant.GET /metrics/ai_traffic,GET /metrics/agent_trafficet les outils MCPget_ai_trafficetget_agent_trafficrenvoientERR_INVALID_PARAM(422) pour unrangeinférieur à 1 ou unfrompostérieur àto, au lieu d’un résultat vide. Envoyer de nouveau le même projet, le même événement et la même URL àPOST /webhooksrenvoie l’abonnement existant, sauf si la clé API ou la connexion OAuth qui l’a créé a été révoquée ; il est alors remplacé par un nouvel abonnement avec un nouveau secret. -
2026-10-12 (v1.58.0)
Ajouts à l’API Search Console. Le nouvel endpoint
GET /search_console/rowset l’outil MCPget_search_console_rowsregroupent les lignes selon trois dimensions au maximum (par exemple page et requête, ou date et page).start_row, sur les endpoints de requêtes, de pages et de lignes, permet de lire au-delà de la fenêtre de 25 000 lignes de Google, etaggregation_type(auto,byPage,byProperty) fonctionne sur tous les endpoints Search Console. Les réponses REST incluent désormaisdata_through; avecoutput=csv,X-Data-ThroughetX-Truncatedtransmettent la même information. Côté MCP, les erreurs amont incluentretry_after.GET /dimensions/projects/:idetget_project_detailsindiquent la connexion Search Console (search_console.statusetproperty). REST et MCP lisent la plage de dates de la même façon : unrangenon valide renvoieERR_INVALID_PARAM, et seul unfrompostérieur àtorenvoieERR_INVALID_RANGE. -
2026-10-10 (v1.57.0)
Analyse web en direct (à partir du forfait Growth). Les nouveaux endpoints
GET /web_analytics/schemaetPOST /web_analytics/query, avec les outils MCPget_web_analytics_schemaetquery_web_analytics, font de LLM Pulse une passerelle en direct, en lecture seule, vers l’outil d’analyse web connecté sur la page Trafic IA (Google Analytics 4, Adobe Analytics ou Customer Journey Analytics, Matomo, PostHog, Plausible ou Piano). L’appelant rédige la requête dans le format natif de l’outil ; la propriété connectée est toujours utilisée, seules les lectures s’exécutent, les lignes sont plafonnées à 5 000 et les requêtes identiques sont mises en cache pendant 10 minutes. Nouveaux codes d’erreur :ERR_WEB_ANALYTICS_NOT_CONNECTED(404),ERR_WEB_ANALYTICS_INVALID_QUERY(422, avec le message de validation de l’outil),ERR_WEB_ANALYTICS_ACCESS_REVOKED(403) etERR_WEB_ANALYTICS_UPSTREAM(503 avecRetry-After). -
2026-10-10 (v1.57.0)
Indicateur de troncature de la répartition Search Console.
GET /search_console/summaryet l’outil MCPget_search_console_summaryrenvoient désormaisbreakdown_truncated: truelorsque la répartition omet des lignes, en raison delimitou du maximum de 25 000 lignes que renvoie Google. Avecfilterset sansdimension, les totaux du résumé correspondent au chiffre complet que Google indique pour ce filtre. -
2026-10-07 (v1.56.0)
Parité REST et MCP. Ces paramètres MCP refusent désormais les valeurs non documentées au lieu d’appliquer une valeur par défaut (rien ne change côté REST) :
sort,sort_diretbreakdownsurget_prompt_summary,sortsurget_top_sources,group_byetgranularitysurget_agent_traffic,granularitysurget_ai_traffic, etsource_typesurlist_sources, désormais sensible à la casse.get_ai_model_position_distributionacceptenaver_aietbaidu_ai. Davantage d’outils MCP d’écriture renvoient lecoded’erreur REST. Certains messages d’erreur REST et MCP ont été reformulés ; les codes REST et les statuts HTTP ne changent pas.assign_prompt_tagsignorecreate_missingpour les membres de l’équipe qui ne peuvent pas créer de tags, comme en REST.start_project_draftaccepteexecute_prompts_immediately.POST /collectionsetcreate_collectionn’associent plus les prompts en cours de suppression.PATCH /project_drafts/{id}accepte un objetowned_mediaimbriqué et y refuse les champs inconnus. -
2026-10-07 (v1.56.0)
Audits GEO. Un nouveau groupe, Audits GEO, assure un contrôle GEO technique continu d’un domaine ou d’une URL et en suit l’évolution d’une exécution à l’autre.
GET/POST /geo_auditslistent les audits et en créent un par type d’audit, ponctuel, hebdomadaire ou mensuel (le rythme hebdomadaire ou mensuel est réservé àagent_readinessetrobots_txt) ;GET,PATCHetDELETE /geo_audits/{id}lisent, reprogramment, mettent en pause ou archivent un audit, et recréer un audit archivé restaure son historique.GET/POST /geo_audits/{geo_audit_id}/runslistent les exécutions et lancent une exécution manuelle (6 par audit et par heure glissante, 200 par compte et par jour),GET /geo_audits/{geo_audit_id}/runs/{sequence}et son/findingsrenvoient le résultat complet et les constats contrôle par contrôle,GET /geo_audits/{id}/comparisoncompare deux exécutions,GET/PATCH /geo_audits/{geo_audit_id}/issueslistent les problèmes et en acceptent ou rouvrent un (une acceptation devient caduque lorsque les éléments de preuve changent), etGET /geo_alertsliste les alertes déclenchées par les audits. Les audits récurrents actifs sont plafonnés selon le forfait : au-delà, la requête renvoieERR_LIMIT_REACHED, comme lorsque les limites d’exécution sont atteintes. De nouveaux outils MCP reprennent chaque endpoint :list_geo_audits,get_geo_audit,create_geo_audit,update_geo_audit,delete_geo_audit,compare_geo_audit_runs,list_geo_audit_runs,run_geo_audit,get_geo_audit_run,list_geo_audit_findings,list_geo_audit_issues,update_geo_audit_issueetlist_geo_alerts. Les écritures exigent une clé avec accès en écriture et, pour les membres de l’équipe, l’autorisation correspondante sur GEO Optimization. -
2026-10-04 (v1.55.0)
Clés API limitées à des projets. Une clé API peut désormais être limitée à un ou plusieurs projets lors de sa création, avec le champ Projets de la page Clés API. Cette sélection ne peut pas être modifiée par la suite, et les clés existantes continuent de voir tout le compte. Une clé limitée à certains projets ne voit que ceux-là :
GET /dimensions/projectset l’outil MCPlist_projectsne renvoient qu’eux, tout autre identifiant, domaine ou nom de projet renvoieERR_PROJECT_NOT_FOUND, exactement comme un projet inexistant, et les abonnements webhook et les études ne listent que ceux de ces projets.GET /accountetget_account_usagelistent ces projets dans le nouveau champapi_key_project_ids. La création d’un projet et l’assistant de brouillon de projet renvoient le nouveau codeERR_KEY_PROJECT_SCOPED(403), et leurs outils MCP sont exclus detools/list. La suppression d’un projet le retire des clés qui y étaient limitées, et une clé qui n’a plus aucun projet est révoquée. -
2026-10-04 (v1.54.0)
Intégrations de boutique. Un nouveau groupe, Intégrations de boutique, alimente l’application LLM Pulse pour Shopify :
GET /store_connectionassocie un domaine de boutique à un projet,PUT /ai_ordersetGET /ai_ordersenregistrent et relisent les commandes que les assistants d’IA ont apportées à la boutique, etGET/POST /catalog_prompt_suggestions, avec/acceptet/reject, transforment les produits du catalogue en prompts d’acheteurs à suivre. L’outil MCPget_ai_orderslit les commandes enregistrées.POST /intelligence_tasksaccepte aussitask_type=product_listingavec un objetproductet renvoie un texte de fiche produit prêt à appliquer ; ce type n’existe que dans l’API. Les lignes de produits deGET /dimensions/shoppingincluent désormaisbest_rank,modelsetlast_seen_at. Nouveaux codes d’erreur :ERR_INTEGRATION_UNAVAILABLE(403, comptes dotés d’un portail en marque blanche ou d’une intégration iframe) etERR_GENERATION_FAILED(502, réessayez la requête). -
2026-10-03 (v1.53.0)
Établissements locaux. Le nouvel endpoint
GET /dimensions/local_businesseset l’outil MCPlist_local_businesseslistent les commerces, restaurants et services que les réponses de l’IA nomment pour vos prompts, une ligne par établissement et par adresse, avec les apparitions, les prompts, la note moyenne, la position moyenne, le nombre d’avis et s’il s’agit du vôtre ou d’un concurrent suivi, ainsi qu’un bloctotals. Tous deux acceptent les filtres de liste standard,owned,query,orderetdirection, et l’endpoint prend en chargeoutput=flatetoutput=csv. Disponible sur tous les forfaits ; les membres de l’équipe ont besoin d’un accès en lecture à Établissements locaux. -
2026-10
Liens vers les entités Google regroupés à part. Les liens de Google AI Mode et de Google AI Overviews vers la visionneuse d’entités de Google (
google.com/searchviewer/...) conservent leururlmais indiquent désormaisgoogle-entity.invalidcommedomainethostau lieu degoogle.com, dansGET /metrics/top_sources,GET /dimensions/sources, les endpoints Citation Intelligence et les exports. Ils ne comptent jamais comme citations propriétaires ou de concurrents : un projet ou un concurrent sur un domaine Google n’est donc plus crédité pour ces liens. L’application nomme ce groupe « Google (entité) ». -
2026-09-30
Les clés API ne fonctionnent plus sous Scale. Les clés API sont une fonctionnalité disponible à partir de Scale. Elles cessent désormais de fonctionner tant que le compte est sur un forfait inférieur à Scale, par exemple après un passage à un forfait inférieur : toute requête REST et toute requête
/mcpeffectuée avec une clé renvoieERR_PLAN_REQUIRED(403). Les clés ne sont pas révoquées : elles restent listées, peuvent toujours être révoquées et fonctionnent de nouveau dès que le compte repasse à Scale ou à un forfait supérieur. Le MCP via OAuth n’est pas concerné. -
2026-09-29 (v1.52.0)
Modification des fichiers des rapports llms.txt via l’API.
PATCH /technical_geo_reports/:id/contentremplace les fichiers llms.txt et llms-full.txt d’un rapport llms.txt terminé : envoyezreport_type=llms_txt, un objeteditscontenant le nouveau texte complet dellms_txt, dellms_full_txtou des deux, et le derniercontent_versionque vous avez lu. Le détail du rapport renvoie désormaisresult_data.content_version. Uncontent_versionobsolète ou absent, un fichier vide, un fichier de plus de 200 000 caractères ou un rapport non terminé renvoieERR_INVALID_PARAM, et la réponse de mise à jour ajoutechanged_files. La première modification conserve les fichiers générés dansoriginal_llms_txt_contentetoriginal_llms_full_txt_content, etPOST /technical_geo_reports/:id/revert_contentles restaure. Deux outils MCP reprennent ces endpoints :update_technical_geo_report_contentetrevert_technical_geo_report_content. Ces deux écritures exigent une clé avec accès en écriture et, pour les membres de l’équipe, l’autorisation de création sur GEO Optimization. -
2026-09-29 (v1.52.0)
Langue de sortie automatique pour les rapports llms.txt.
output_language_codesurPOST /technical_geo_reportsetcreate_technical_geo_reportaccepte aussiauto, qui conserve les fichiers llms.txt dans la langue du site web. La réponse de création reprendauto, puis le rapport renvoieoutput_language_code: null. -
2026-09-28 (v1.51.1)
Quota des rapports GEO techniques.
POST /technical_geo_reportsetcreate_technical_geo_reportcomptent désormais chaque rapport créé avec succès comme une unité quotidienne. Le lancement du lot complet tente de créer neuf rapports et ne démarre que s’il reste au moins neuf unités quotidiennes. Un rapport qui n’est pas créé ne consomme aucune unité. Les allocations quotidiennes varient selon le compte. -
2026-09-28 (v1.51.0)
Les schémas de réponse correspondent à ce que l’API envoie. Les réponses envoyées ne changent pas ; le document OpenAPI et les SDK officiels les décrivent désormais correctement. Les points de
GET /metrics/timeseries, deGET /metrics/summaryet de la sérieover_timedeGET /metrics/sov(TimeseriesPoint) portent une date calendaire comme2026-09-01(le premier jour de l’intervalle pour les granularités semaine et mois), et non un horodatage, etvaluevautnullpour les métriques de taux, de position et de sentiment les jours sans réponse. Les SDK Go, Java, Kotlin, Rust et C# ne pouvaient pas décoder ces points jusqu’ici. Dans les SDK typés,dateest désormais un type date, par exempleLocalDateen Java et en Kotlin,DateOnlyen C#,NaiveDateen Rust,dateen Python et une chaîne en Go. Les champs que l’API peut envoyer ànull, ce que le SDK C# rejetait jusqu’ici, sont désormais déclarés nullables :brand_name,url,description,business_model,target_audience,brand_voice,goals,google_play_idetapp_store_idsurGET /dimensions/projects/{id};matching_names,google_play_id,app_store_idetcolorsurGET /dimensions/competitors/{id};domainsur l’entrée du projet dansGET /metrics/timeseries,GET /metrics/summaryetGET /metrics/sov, ainsi que sur la ligne de votre marque dansGET /dimensions/competitors, lorsque le projet n’a pas d’URL ;response,executed_at,success,duration_msetfan_out_queriessurGET /answers/{id};result_datasur les tâches GEO Writer ; etlast_delivered_atsur les abonnements webhook.duration_msest un nombre à une décimale, et non un entier. Dans le SDK Go, les champs de cette liste qui ne sont pas des tableaux utilisent désormais les types enveloppesNullable*. -
2026-09-28 (v1.50.1)
Harmonisation de l’accès aux sentiments.
GET /sentimentsetGET /dimensions/sentimentsexigent désormais un forfait Growth ou supérieur. Les outils MCP correspondants appliquent la même restriction Growth et renvoientERR_PLAN_REQUIREDaux appels directs effectués avec un forfait inférieur. -
2026-09-28 (v1.50.0)
Configuration d’un projet en moins d’appels.
POST /projectset l’outil MCPcreate_projectacceptentcollections, une liste de{name, prompts}qui crée des tags de prompts avec le projet et y associe, par leur texte, les prompts de la même requête ; la réponse ajoutecollectionsetsame_domain_projects(les projets du même domaine que vous voyez déjà ; la création n’est jamais bloquée).industryaccepte une clé ou un tableau à la création, dans les brouillons et à la mise à jour, et une clé inconnue renvoie désormais la liste des clés valides.PATCH /projects/:idetupdate_projectacceptentname. Les périodes deGET /metrics/sovajoutentconfidenceetmargin_of_error, ainsi qu’unsamplede premier niveau.GET /accountetget_account_usageajoutentplan_name. MCP uniquement :get_sovaccepteview=compactetlist_promptsacceptefields. -
2026-09
Code « forfait requis » sur les outils MCP réservés à certains forfaits. Un appel
tools/calldirect à un outil que votre forfait n’inclut pas renvoie désormaiscode: "ERR_PLAN_REQUIRED"à côté deerror, le même code que les endpoints REST renvoient pour une restriction de forfait. Le texte deerrorne change pas. -
2026-09 (v1.49.0)
Les mentions de page sont lues par projet. Les champs de mention de page de
GET /citation_intelligence/groups,GET /citation_intelligence/urls/{url_sha256}et/content, y compris le nombre de mentions par domaine et par hôte et le filtrecontent_gap, décrivent désormais l’analyse de la page citée pour le projet qui fait la requête. Une page pas encore analysée pour le projet, y compris une page enregistrée avant que le projet ne la cite, renvoienullpourbrand_mentionedetcompetitor_mentionedau lieu defalse, ainsi quecontent_gap_status: mentions_not_processedetpage_cache.mentions_processed: false; les nombres de mentions d’un groupe valentnulllorsqu’aucune de ses pages n’a été analysée. La même règle s’applique àpage_detailsdansGET /answers/{id}, àmention_filtersurGET /dimensions/sourceset aux outils MCP correspondants.mentions_not_processedétait déjà renvoyé avant cette version et est désormais documenté. -
2026-09 (v1.48.0)
Liens vers l’application. Les réponses (
GET /answers,GET /answers/{id},GET /dimensions/prompt_executions), les prompts (GET /dimensions/prompts,GET /metrics/prompt_summary) et les rapports GEO techniques (GET /technical_geo_reports,GET /technical_geo_reports/{id}) renvoient désormaisapp_url, le lien qui ouvre l’élément dans l’application.POST /technical_geo_reportsrenvoieapp_urls, un lien par rapport créé, indexé par type de rapport. Chaque lien se termine par?project_id=: il ouvre donc ce projet pour toute personne qui y a accès. Les outils MCP renvoient les mêmes liens. -
2026-09 (v1.47.0)
Langue de sortie et modifications manuelles de llms.txt.
POST /technical_geo_reportset l’outil MCPcreate_technical_geo_reportacceptentoutput_language_code(ISO 639-1, langue du projet par défaut) pour le rapport llms.txt du lot. Les résumés de rapport exposentoutput_language_code, et leresult_datad’un rapport llms.txt terminé ajoutemanually_edited_at,original_llms_txt_content,original_llms_full_txt_contentetmetadata.output_language_code: lorsque les fichiers ont été modifiés dans l’application,llms_txt_contentetllms_full_txt_contentrenvoient le texte modifié. -
2026-09 (v1.46.0)
Le paramètre
filtersde Search Console est désormais utilisable depuis les SDK officiels. Il accepte toute la liste sous forme d’une seule valeur JSON,filters=[{"dimension":"page","operator":"contains","expression":"/blog/"}], car un tableau d’objets n’a aucune forme de paramètre de requête qu’un client généré puisse produire. L’encodage existant avec crochets,filters[][dimension]=page, est inchangé et continue de fonctionner. -
2026-09 (v1.45.0)
Les filtres de modèle acceptent désormais
naver_aietbaidu_aipour les comptes qui ont activé ces options en libre-service. -
2026-09
Compatibilité avec les annuaires MCP. Les descriptions des outils n’indiquent plus que leur propre opération, leurs entrées, leurs limites et leurs effets de bord. Les instructions d’orchestration entre outils et de comportement du modèle ont été supprimées. Les playbooks d’analyse guidée restent disponibles via la fonctionnalité de prompts MCP, que l’utilisateur appelle lui-même, mais ne sont plus exposés par
get_analysis_playbook, car les outils ne doivent pas injecter dynamiquement d’instructions de comportement. -
2026-09 (v1.44.0)
Les URL citées conservent leurs métriques de citation lorsque le contenu de la page n’est pas disponible. Les mentions de page inconnues renvoient désormais null ; content_gap_status inclut content_unavailable. Les résultats de crawl vides n’apparaissent plus comme des pages analysées. Les statuts 404 et 410 observés restent visibles.
-
2026-09
Codes lisibles par machine dans les erreurs des outils MCP. Un
tools/callen échec conserveisError: true, et son texte contient désormaiscodeà côté deerrorchaque fois que cette erreur a un équivalent REST, avec la même valeur que l’endpoint REST :ERR_PROJECT_NOT_FOUND,ERR_INVALID_PARAM,ERR_INVALID_RANGE, les trois codes Search Console (ERR_SEARCH_CONSOLE_NOT_CONNECTED,ERR_SEARCH_CONSOLE_ACCESS_REVOKED,ERR_SEARCH_CONSOLE_UPSTREAM) etERR_AI_TRAFFIC_NOT_CONNECTED/ERR_AGENT_TRAFFIC_NOT_CONNECTED. Le texte deerrorne change pas. -
2026-09
Webhook pour les modifications manuelles dans GEO Writer (v1.43.0). Un nouveau type d’événement,
intelligence_task.updated, se déclenche lorsque le texte d’une tâche terminée est modifié à la main ou rétabli dans sa version générée par l’IA. Les deux payloads d’événement GEO Writer contiennent désormaismanually_edited_at, qui vautnullpour une tâche jamais modifiée et pour une tâche qui vient d’être rétablie. Pour vous y abonner, utilisezPOST /webhookscomme pour tout autre événement ;GET /webhooks/sample/intelligence_task.updatedrenvoie des exemples de payloads. Les connecteurs Zapier, Make et n8n le proposent comme nouveau déclencheur. -
2026-09
Modification du texte généré par GEO Writer (v1.42.0).
PATCH /intelligence_tasks/:idmodifie sur place le texte d’une tâche terminée : envoyez un objeteditsdont les clés sont des chemins en notation pointée dansresult_data(par exemplesections.0.contentoutitle) et dont les valeurs sont le texte de remplacement. Seuls les champs texte qui existent déjà peuvent changer : un chemin introuvable, untitlevide ou une valeur de plus de 20 000 caractères renvoieERR_INVALID_PARAM. La première modification conserve une copie du texte généré, quePOST /intelligence_tasks/:id/revertrestaure. Les payloads des tâches comportent désormaismanually_edited_at(liste et détail) etedited_by_user_id(détail), et la réponse de mise à jour ajoutechanged_paths. Deux outils MCP reprennent ces endpoints :update_intelligence_task_contentetrevert_intelligence_task_content. Ces deux écritures exigent une clé avec droits d’écriture et, pour les membres de l’équipe, l’autorisation de modification sur GEO Writer. -
2026-09
Filtres de prompts sur la part de mentions par domaine citant (v1.42.0).
GET /citation_intelligence/mentions_by_domainet l’outil MCPget_mentions_by_citing_domainacceptent désormaisbrand_kind(brand,brand_otherounon_brand) et l’appliquent à l’ensemble des réponses du projet, avec les filtres de modèle, de pays, de langue et de tag. Sans ce paramètre, le comportement précédent est conservé : tous les prompts sont pris en compte. L’endpoint REST rejette les valeurs non valides avecERR_INVALID_PARAM; l’outil MCP renvoie une erreur de validation. -
2026-09
Deux corrections Search Console (v1.41.0). Une
dimensioninconnue renvoie désormaisERR_INVALID_PARAMau lieu d’être ignorée sans avertissement, et les valeurs de répartitionpageetqueryconservent la casse renvoyée par Google au lieu d’être converties en minuscules, car l’URL d’une page est sensible à la casse. -
2026-09
Les endpoints Search Console prennent en charge tout le vocabulaire de requête de Google (v1.41.0). Les quatre endpoints
/search_console/*et leurs outils MCP acceptent trois nouveaux paramètres issus de la requête Search Analytics exposée par Google :search_type(web,image,video,news,discover,googleNews),filters(un tableau d’objets{dimension, operator, expression}combinés par un ET logique ; parmi les six opérateurs, deux utilisent des expressions régulières RE2) etdata_state(finalpar défaut, ouallpour inclure les jours les plus récents, encore incomplets).GET /search_console/summarypropose désormais une répartition parpage,queryetsearchAppearanceen plus decountryetdevice, plafonnée parlimit(1 000 par défaut et au maximum). Les plages de dates passent de 400 à 487 jours, soit les 16 mois de conservation appliqués par Google. -
2026-09
Corrections des plages de dates et de l’agrégation (v1.40.0). Un
tosans heure (par exempleto=2026-09-01) couvre désormais toute la journée. Il correspondait auparavant à minuit : le dernier jour était donc exclu et chaque plage comptait un jour de moins. Les clients qui envoient déjà un horodatage complet ne sont pas concernés. SurGET /reports/ai_model_insights/*, les intervalles hebdomadaires et mensuels divisent désormais le total de l’intervalle au lieu de faire la moyenne des pourcentages quotidiens : un jour chargé ne compte plus autant qu’un jour calme. Le calcul de la position moyenne pondère chaque ligne par le nombre de positions qu’elle contient au lieu de traiter toutes les lignes de la même façon. Les lignes retirées d’un projet ne comptent plus dans les mentions, citations, sources ou sentiments, sur aucun endpoint de lecture. -
2026-09
Devise sur les lignes Shopping.
GET /dimensions/shoppingavecview=merchantsrenvoie désormais un champcurrencyqui indique la devise dans laquelle sont exprimésmin_price,max_priceetavg_price. Les réponses de l’IA affichent les prix de chaque marché dans sa propre devise, sans champ de devise dédié ; un marchand qui vend dans plusieurs devises indique donc désormais celle qu’utilisent la plupart de ses prix au lieu de faire une moyenne entre elles, et une fourchette ne mélange jamais deux devises. Ce champ vautnulllorsqu’aucun prix ne portait une devise que nous avons pu identifier. Avecview=products,currencyindique désormais la devise demax_price, et un nouveau champcurrency_countprécise dans combien de devises ce produit était proposé : au-delà de 1, la ligne présente son offre la plus chère etmin_pricepeut être dans une autre devise.totals.avg_priceest désormais calculé dans une seule devise au lieu d’une moyenne entre devises, ettotals.avg_price_currencyindique laquelle. Aucun nouvel endpoint ni code d’erreur. -
2026-09
Détails d’erreur plus clairs et filtre de modèle plus strict sur les réponses (v1.38.0). Les erreurs qui comportent des détails dans
error.meta.messageles reprennent désormais aussi danserror.message.error.metareste inchangé. Les erreurs sans détails utilisent toujours les identifiants de message par défaut, commemissing_authorization. Fondez votre logique surerror.code, jamais sur le texte du message.GET /answersrejette désormais avec422 ERR_INVALID_PARAMune valeurmodelque le compte ne suit pas, au lieu d’ignorer le filtre. Les descriptions deERR_LIMIT_REACHEDetERR_QUOTA_EXCEEDEDlistent désormais toutes les limites couvertes par chacun. -
2026-09
Clés révoquées et refus faute de droits d’écriture (v1.37.1). Une clé API révoquée renvoie désormais
403 ERR_REVOKED_API_KEY, comme documenté, au lieu de401 ERR_INVALID_API_KEY. La clé d’un membre de l’équipe est refusée de la même manière tant que le propriétaire du compte est bloqué ou en attente de suppression.POST /intelligence_tasks,PATCH /project_drafts/:idetPOST /project_drafts/:id/finalizedocumentent désormais la réponse403 ERR_INSUFFICIENT_SCOPEque reçoit une clé en lecture seule, comme les autres opérations d’écriture. -
2026-09
Codes d’erreur Search Console et contrat des lectures en direct (v1.37.0). Lorsque les lectures en direct sont activées, les quatre endpoints
/search_console/*renvoientERR_SEARCH_CONSOLE_ACCESS_REVOKED(403) si l’accès Google a été révoqué ; reconnectez la propriété dans Préférences > Paramètres du projet > Connexions de données. Ils renvoientERR_SEARCH_CONSOLE_UPSTREAM(503) lorsque Google Search Console est indisponible ou que son quota est dépassé ; attendez le nombre de secondes indiqué dansRetry-Afteravant de réessayer. Les outils MCP signalent ces situations sous forme d’erreurs d’outil. L’en-tête de réponseX-Search-Console-Backendindique une lecturestored(données stockées) oulive(en direct). Les lectures stockées utilisent les données synchronisées sans contacter Google. Pour les requêtes et les pages,totalcompte les clés distinctes disponibles sur la période : les clés des lignes quotidiennes synchronisées pour les lectures stockées, ou jusqu’à 25 000 lignes issues d’un seul appel à Google pour les lectures en direct. Les réponses en direct incluenttruncated: truelorsque cette limite est atteinte. Le tri et la pagination s’appliquent à l’ensemble disponible. -
2026-09
Correspondance des URL citées par concurrent (v1.36.0).
POST /competitorsetPATCH /competitors/:idacceptent désormais le champ facultatifcitation_match_mode, avec la valeurdomain,hostoupath_prefix.citation_match_pathest obligatoire avecpath_prefix.PATCH /competitors/:idpeut aussi modifierdomain, qui enregistre le domaine du site web ou l’hôte exact utilisé par la règle. Les payloads de lecture des concurrents renvoient les champs de la règle. Modifier le site web ou l’un des deux paramètres de la règle reclasse les citations historiques en arrière-plan, afin que les métriques historiques et l’attribution des sources suivent la nouvelle configuration. -
2026-08 (fin de mois)
Référence publique de l’API découpée en une page par ressource.
https://llmpulse.ai/api-docscouvre désormais la prise en main (clés, premier appel, utilisation du compte) et renvoie vers une page par ressource :/api-docs/projects,/api-docs/metrics,/api-docs/prompts,/api-docs/webhooks,/api-docs/core-concepts(filtres communs, formats de sortie, codes d’erreur),/api-docs/integrations(extraits de code, Postman, MCP),/api-docs/oauthet les autres, chacune accessible depuis toutes les autres. Les anciens liens vers une section, comme/api-docs#webhooks, redirigent vers la page qui la contient désormais.llms.txtindique l’URL de documentation de chaque groupe de ressources à côté de ses endpoints. Après connexion, les comptes Scale+ retrouvent toujours la référence complète sur une seule page, avec le playground interactif, sur la page Clés API de l’application. Aucun endpoint, paramètre, payload ni code d’erreur n’a changé. -
2026-08 (fin de mois)
Énumérations du profil de projet mises à jour (v1.35.0).
business_modeldécrit désormais une seule chose, la façon dont une marque vend, au lieu de mêler canal et secteur. Les clés acceptées sontB2B_SAAS,B2C_SUBSCRIPTION,ECOMMERCE,RETAIL,MARKETPLACE,LEAD_GENERATION,SERVICES,ENTERPRISE_SOFTWARE,MEDIA_ADVERTISING,EDUCATION_TRAINING,NONPROFIT_PUBLICetOTHER. Les clés retirées (B2B_CLOUD_SERVICES,B2C_SMART_HOME,B2C_STREAMING,B2C_GAMING) sont converties vers leur valeur actuelle la plus proche surPOST /projectsetPATCH /projects/:idau lieu d’être rejetées, pour que les intégrations existantes continuent de fonctionner ; les clés réellement inconnues renvoient toujoursERR_INVALID_PARAM.industryaccepte désormais 34 clés au lieu de 19, avec de nouveaux secteurs qui devaient jusqu’ici se rabattre surOTHER. Les valeurs stockées ont été migrées : un projet créé avant ce changement renvoie sa nouvelle clé à la lecture. Le champ libre associébusiness_model_otherfait désormais partie de l’API : envoyez-le avecbusiness_model: OTHERsurPOST /projectsouPATCH /projects/:id(et les outils MCPcreate_project/update_project) et il est renvoyé dans le payload du projet. Envoyé avec une autre clé, il est refusé avecERR_INVALID_PARAM, et il est effacé automatiquement lorsque le modèle économique n’est plusOTHER. -
2026-08 (fin de mois)
Filtres d’analyse à valeurs multiples (v1.34.0).
collection_id,country_code,language_codeetprompt_typeacceptent désormais une valeur ou une liste séparée par des virgules sur les endpoints de métriques, de dimensions, de réponses, d’analyse des citations et d’Analyse des modèles d’IA qui prenaient déjà en charge ces filtres.GET /sentimentsaccepte aussi plusieurs valeursanalysis. Les valeurs d’un même filtre sont combinées par un OU logique, et des filtres différents par un ET logique. Les requêtes à valeur unique fonctionnent toujours sans changement, et les outils MCP correspondants suivent le même contrat. -
2026-08 (fin de mois)
Récupération des rapports GEO techniques (v1.33.0).
GET /technical_geo_reportsliste les rapports parproject_idetreport_type, tandis queGET /technical_geo_reports/:idrenvoie le statut actuel et, une fois le rapport terminé, l’intégralité deresult_data. Les nouveaux outils MCPlist_technical_geo_reportsetget_technical_geo_reportoffrent le même accès, etcreate_technical_geo_reportrenvoie désormais les identifiants des rapports en indiquant aux clients de les interroger régulièrement. Claude et les autres clients MCP peuvent désormais lancer un rapport GEO technique, attendre sa fin et le lire dans la même conversation, sans copier-coller. -
2026-08 (fin de mois)
Non-réponses sentinelles signalées par
no_result. Lorsqu’aucune réponse ne peut être collectée pour un prompt après toutes les tentatives, ce qui est stocké est un texte de remplacement et non une véritable réponse de l’IA ; ces lignes étaient déjà exclues de toutes les métriques de la plateforme, mais impossibles à distinguer via l’API. Les éléments deGET /answersetGET /answers/:idcomportent désormais un booléenno_result, etGET /answers(ainsi que l’outil MCPlist_answers) accepte un filtre facultatifno_result:false= uniquement les vraies réponses (recommandé pour calculer vos propres métriques),true= uniquement les sentinelles, omis = les deux (format historique inchangé). -
2026-08 (mi-mois)
Mise à jour du profil de projet et brand book dès la création (v1.31.0). Le nouvel endpoint
PATCH /api/v1/projects/:idmet à jour le profil d’un projet après sa création, avec les mêmes champs que dans Paramètres du projet :brand_name,description,industry,business_model,target_audience,brand_voice,goals,primary_productsetmatching_names. Les champs du brand book (description,industry,brand_voice,target_audience) alimentent GEO Writer, les suggestions de prompts et les recommandations, ce qui permet aux systèmes externes de garder le contexte de marque synchronisé par programmation. N’envoyez que les champs à modifier ; un champ inconnu renvoieERR_INVALID_PARAM. Modifiermatching_names(une liste qui remplace entièrement la précédente) relance en arrière-plan la détection des mentions et des citations sur tout l’historique du projet (rematching: true; toute nouvelle modification est refusée pendant ce traitement), tandis qu’un changement debrand_namene s’applique qu’aux exécutions futures.POST /api/v1/projects(et l’outil MCPcreate_project) accepte désormaisbusiness_model,target_audience,brand_voice,goalsetprimary_productsdès la création. L’outil MCP existantupdate_projectet le nouvel endpoint REST s’appuient désormais sur un seul et même service. Nécessite une cléread_write; les membres de l’équipe ont besoin de l’autorisation de modification sur les projets. -
2026-08 (mi-mois)
Corrections de filtres sur les nouvelles listes (v1.30.0). Des filtres documentés mais ignorés sans avertissement fonctionnent désormais.
store(médias propriétaires) etstatus(discussions Reddit) sont bien transmis à la requête au lieu d’être écartés :store=app_storeetstatus=archivedne renvoient plus de lignes non filtrées.owned=trues’applique àGET /dimensions/shopping?view=merchants, qui renvoyait auparavant tous les marchands, concurrents compris, et àGET /dimensions/owned_media?provider=mobile_apps, dont les lignes comportent maintenant l’indicateuryoursque toutes les autres plateformes renvoyaient déjà. Sur cette même plateforme,totalcorrespond désormais à la taille complète du classement (plafonnée à 500) et non à la taille de la page, qui laissait croire aux clients qui paginent qu’il n’y avait rien après la page 1.direction=descs’applique désormais aux tris textuels deGET /dimensions/query_fan_outs(order=query_text,order=prompt_text), qui répondaient toujours par ordre croissant ; les deux sont maintenant décroissants par défaut, comme tous les autres tris. Le paramètreviewpropre à un endpoint peut enfin être combiné avecoutput=flatououtput=csv(par exemple?view=merchants&output=csv), alors que cela renvoyaitERR_INVALID_PARAM, et les réponses flat reprennentview,provideretstore.GET /accountindique désormais la limite de requêtes de la clé utilisée pour l’appel au lieu de la limite par défaut, et son blocsubscriptionest réservé aux appelants qui ont accès à la page Forfaits et facturation. Les études sont limitées aux projets auxquels l’appelant a accès. -
2026-08 (mi-mois)
Six nouveaux modules du produit (v1.29.0). Achats et emplacements payants dans les réponses de l’IA :
GET /api/v1/dimensions/shoppingetGET /api/v1/dimensions/ads(à partir de Scale+). Médias propriétaires et communautés :GET /api/v1/dimensions/owned_media(YouTube, Instagram, Facebook, TikTok, LinkedIn, boutiques d’applications) etGET /api/v1/dimensions/reddit(à partir de Growth). Rapports d’analyse multimodèles :GET /api/v1/reputation/reports,GET /api/v1/reputation/reports/:id,GET /api/v1/studies,GET /api/v1/studies/:idetGET /api/v1/studies/:id/reports/:report_id(suivi de la réputation requis). Les chemins shopping et ads sont volontairement indépendants du modèle plutôt que nommés d’après un seul assistant, car les données sous-jacentes ont toujours comporté l’énumération standard des modèles. Neuf outils MCP correspondants :list_shopping_products,list_ads,list_reddit_citations,list_owned_media,list_reputation_reports,get_reputation_report,list_studies,get_study,get_study_report. Ces neuf endpoints prennent tous en chargeoutput=flatetoutput=csv. -
2026-08
Query Fan Out dans l’API et le MCP (v1.28.0). Le nouvel endpoint
GET /api/v1/dimensions/query_fan_outsexpose les sous-requêtes qu’un modèle a réellement lancées pour répondre à vos prompts suivis, souvent différentes de la formulation que vous avez écrite.view=query(par défaut) renvoie une ligne par sous-requête distincte, avec son nombre d’occurrences et sa part ;view=promptrenvoie une ligne par prompt, avec le nombre de sous-requêtes distinctes qu’il a produites. L’endpoint accepte les filtres de prompts standard, ainsi quequery(recherche de sous-chaîne),order,directionetoutputpour le format flat ou CSV ; une valeur deorderqui ne correspond pas à la vue choisie renvoieERR_INVALID_PARAM. L’outil MCP correspondant estlist_query_fan_outs. Les sous-requêtes sont surtout fournies par ChatGPT : un résultat vide signifie donc généralement que les modèles concernés ne les exposent pas, et non qu’aucune recherche n’a eu lieu. L’endpoint ne renvoie que l’agrégation : pour une variation d’une période à l’autre, appelez-le deux fois avec desfrom/toexplicites. Comme la page de l’application, l’API et le MCP dépendent de l’autorisation Query Fan Out des membres de l’équipe. -
2026-08
Consommation du compte, en-têtes de limite de requêtes et glossaire MCP (v1.27.0). Le nouvel endpoint
GET /api/v1/accountrenvoie le forfait, la fréquence de suivi, la période d’abonnement, la consommation des quotas (prompts, projets, concurrents par projet, tâches GEO Writer mensuelles, membres de l’équipe) et les limites de requêtes qui s’appliquent à votre clé : une intégration voit ainsi le budget qui lui reste au lieu de découvrir le plafond en l’atteignant. Un quota illimité renvoielimitetremainingànull, avecunlimited: true. Les limites sont celles du propriétaire du compte : un membre de l’équipe voit donc la capacité qui s’applique à lui. L’outil MCP correspondant estget_account_usage, disponible sur tous les forfaits. Chaque réponse/api/v1comporte désormaisX-RateLimit-Limit,X-RateLimit-RemainingetX-RateLimit-Reset(la réponse429 ERR_RATE_LIMITEDles inclut en plus deRetry-After), et les deux budgets, 300 requêtes par minute au total et 60 par minute pour les écritures, sont maintenant documentés au lieu d’être implicites. Le serveur MCP expose aussi une nouvelle ressourcellmpulse://glossaryqui définit chaque métrique, unité, dimension et précaution de lecture (distinction entre taux de mention et AI Visibility Score, dénominateurs du Share of Voice, marque dans le prompt, périodes partielles, petits échantillons) : un assistant peut ainsi lire les définitions au lieu de les déduire. Aucun endpoint, paramètre, payload ou code d’erreur existant n’a changé. -
2026-08
La préparation aux agents d’IA rejoint le lot GEO technique (v1.26.0).
POST /technical_geo_reportscrée désormais aussi un rapportagent_readinessqui évalue dans quelle mesure le domaine est prêt pour les agents d’IA :created_reportsetreport_idsincluent donc la nouvelle cléagent_readiness(9 rapports par exécution au lieu de 8). L’outil MCPcreate_technical_geo_reportcrée le même lot. Les clés existantes et les structures de réponse sont inchangées. -
2026-08
Suivi hebdomadaire de Grok et DeepSeek. Les valeurs
groketdeepseekdu filtremodelrenvoient désormais de vraies données de visibilité hebdomadaires sur les comptes qui ont activé ces options, dans tous les endpoints de métriques, de dimensions, de réponses, de sentiments et de citations (elles étaient déjà acceptées comme valeurs de filtre, mais ne correspondaient à aucune exécution). Les réponses de Grok proviennent de sa recherche web native : elles comportent des sources et des citations, comme celles de tous les autres modèles. Les réponses de DeepSeek ne comportent ni sources ni citations : DeepSeek ne propose pas de recherche web, si bien que ses réponses reflètent les connaissances propres du modèle. Les lignes DeepSeek renvoient volontairementcitations: 0et une liste de sources vide ;visibility,mention_rate, le Share of Voice et le sentiment se comportent normalement. Les structures de réponse sont inchangées, et les modèles que le compte d’une clé API n’a pas activés sont toujours écartés sans avertissement. -
2026-08
Carte serveur MCP publique. Le nouvel endpoint
GET /api/v1/mcp/server-cardrenvoie une Server Card du Model Context Protocol qui décrit l’endpoint, son transport Streamable HTTP, les versions du protocole qu’il accepte et l’en-tête Authorization qu’un client doit envoyer. Il ne requiert aucune authentification, car la carte est le document qu’un client lit avant de détenir un identifiant d’accès, et elle n’en contient aucun. La carte est annoncée dans le catalogue Agentic Resource Discovery à/.well-known/ai-catalog.json, dont l’entrée MCP utilise désormais le bon type de médiaapplication/mcp-server-card+jsonet pointe vers la carte plutôt que vers l’endpoint de transport. La carte n’est volontairement PAS servie à/.well-known/mcp/server-card.json: la spécification MCP exclut cet emplacement. LLM Pulse publie aussi désormais un catalogue d’API à/.well-known/api-catalog(RFC 9727) et un index d’Agent Skills à/.well-known/agent-skills/index.json. -
2026-08
Référence de l’API réorganisée par ressource. La documentation de
/api-docs, les spécifications OpenAPI et Swagger, l’index lisible par machinellms.txtet la collection Postman regroupent désormais chaque endpoint sous sa ressource (Projects, Metrics, Competitors, Prompts, Collections & Tags, Answers, Mentions & Citations, Sentiments, Sources & Citation Intelligence, AI Model Insights, AI & Agent Traffic, Search Console, Recommendations, GEO Writer, Technical GEO Reports, Annotations, Webhooks, MCP). Chaque ressource présente ses lectures et ses écritures ensemble, dans le même ordre sur chacun de ces supports. La liste des tags OpenAPI déclare maintenant tous les tags utilisés : Projects, Competitors, Collections, Annotations, Reports et OAuth manquaient, si bien que Swagger UI et Redoc affichaient ces endpoints en dernier, sans description.POST /projectset l’assistant/project_drafts, jusqu’ici absents dellms.txt, y figurent désormais, et la collection Postman couvre chaque endpoint au lieu des deux dossiers d’origine. Aucun endpoint, paramètre, payload ou code d’erreur n’a changé. -
2026-08
Amazon Rufus devient Alexa for Shopping. Amazon a renommé son assistant d’achat : le modèle s’affiche donc sous le nom Alexa for Shopping dans l’application, sur le site et dans la documentation. Rien ne change pour les intégrations : la valeur API reste
amazon_rufusdans le filtremodelet dans chaque réponse, et l’historique des données n’est pas modifié. Aucune action requise. -
2026-08
CLI native en Rust et SDK officiels. La CLI v2 remplace l’implémentation JavaScript par des binaires natifs pour macOS, Linux et Windows, tout en conservant le format existant de configuration et de profils. Des commandes typées couvrent les 71 opérations REST, avec une sortie JSON, tableau ou CSV, ainsi qu’une commande REST directe. Des clients officiels générés sont désormais maintenus pour TypeScript, Python, Go, Java, Kotlin, C#, PHP, Ruby, Rust, Swift, Dart et R. Le document OpenAPI utilise des champs nullable compatibles avec OpenAPI 3.0, afin que chaque client puisse être généré avec la même chaîne d’outils aux versions figées.
-
2026-08
Annotations automatiques et accès sur tous les forfaits (v1.23.0). Les annotations sont désormais disponibles sur tous les forfaits, y compris Starter et les comptes en période d’essai. Les lignes renvoyées par
GET /annotationset par l’outil MCPlist_annotationsincluentorigin:manual,automation,geo_testouplatform. Les annotations automatiques de projet consignent les modifications quotidiennes du jeu de prompts, ainsi que les changements de modèles d’IA activés et de fréquence de suivi. Les champs existants et le comportement en écriture sont inchangés. -
2026-08
Share of Voice : taille d’échantillon et regroupement par modèle (v1.22.0).
GET /metrics/sovrenvoie désormais un tableauperiodsqui indique, pour chaque intervalle, le total dementionssur lequel les parts ont été calculées (la taille de l’échantillon : un intervalle de 1 à 3 mentions donne 100/50/33,33 et doit être traité comme un petit échantillon), ainsi qu’un indicateurpartialqui signale les intervalles encore en cours de collecte ou tronqués par la fenêtre demandée. Chaque lignecurrentcontient aussi des écarts précalculés :previous_share(dernier intervalle complet) etavg_share(moyenne des intervalles complets avec données, intervalles partiels exclus). Les champs existants sont inchangés. L’outil MCPget_sovgagnegroup_by=model, qui renvoie par appel une comparaison compacte des parts par modèle (ajoutezinclude_series=truepour les séries d’évolution par modèle). Chaque outil MCP lié à un projet accepte désormais dansproject_idle domaine du projet, son nom exact ou son nom de marque, en plus de l’identifiant numérique. Les réponses de métriques MCP incluent un lienapp_urlvers la source, et les outils de métriques MCP affichent des widgets interactifs dans les hôtes compatibles : graphique en anneau du Share of Voice, carte de synthèse de la visibilité, courbe d’une métrique dans le temps (get_timeseries) et domaines les plus cités (get_top_sources). -
2026-07 (fin de mois)
Correction de la réponse à la création de projet (v1.21.1).
POST /projectsetPOST /project_drafts/:id/finalizerenvoient désormaiscompetitors.processing: false, car la configuration des concurrents se termine dans la transaction du projet. Les réponses précédentes indiquaient à torttrue. Une URL de site web de projet renvoie désormaisERR_INVALID_PARAMsi elle contient des identifiants de connexion, une adresse IP privée ou spéciale, localhost ou un nom d’hôte interne. Les noms d’hôte DNS publics, les noms de domaine internationalisés et les adresses IP publiques littérales restent acceptés. Un corps JSON mal formé envoyé à un endpoint d’écriture renvoie désormais l’erreur d’analyse JSON (familleERR_INVALID_PARAM) au lieu deERR_PROJECT_NOT_FOUND. -
2026-07 (fin de mois)
Filtres de mentions et de citations (v1.21.0).
GET /answers,GET /dimensions/prompt_executionsetGET /dimensions/sourcesacceptentmention_filteret (pour les deux premiers)citation_filter, la même matrice à deux axes que sur les pages Réponses et Citations : votre marque croisée avec les concurrents, chaque axe pouvant être présent, absent ou indifférent. Les valeurs prédéfinies sontmentions_you,not_mentions_you,mentions_competitor,not_mentions_competitor,you_and_competitor,competitor_not_you,you_not_competitoretno_brands(aucune marque suivie n’apparaît), avec les variantes de citationcites_you,not_cites_you,cites_competitor,not_cites_competitoretcites_no_brands. Associez l’un ou l’autre filtre àcompetitorspour limiter le côté concurrents à des concurrents précis. Avec une valeur négative, cette liste signifie « aucun de ceux-ci ». Sur/dimensions/sources, le filtre s’applique au contenu crawlé de chaque page citée. Les valeurs inconnues renvoientERR_INVALID_PARAM. Les mêmes arguments sont disponibles dans les outils MCPlist_answers,list_prompt_executionsetlist_sources. -
2026-07 (fin de mois)
Sortie tabulaire et CSV pour les outils de BI (v1.20.0). Les endpoints de lecture acceptent désormais un paramètre facultatif
output:output=flatrenvoie les mêmes métadonnées ainsi que descolumnsetrowsrectangulaires, etoutput=csvrenvoie ces lignes au formattext/csv. Tableau (via son REST API Connector), Excel, Google Sheets et les outils de chargement d’entrepôts de données peuvent ainsi lire l’API sans code pour parcourir le JSON imbriqué./metrics/sovaccepte aussiview=over_time|current|breakdown. Sansoutput, la réponse reste exactement celle que reçoivent déjà les intégrations existantes. Les erreurs sont toujours renvoyées en JSON, les pourcentages restent sur l’échelle de 0 à 100, les endpoints paginés exposent les en-têtesX-Total-Count,X-PageetX-Per-Page, et la sortie tabulaire est plafonnée à 200 000 lignes. -
2026-07 (fin de mois)
Historique des métriques allongé. La fenêtre de dates maximale des endpoints de métriques (
/metrics/*), des listes/dimensions/*, de l’analyse des citations et de l’analyse des modèles d’IA (en REST et via leurs outils MCP équivalents) passe de 400 à 1 500 jours, ce qui permet d’interroger tout l’historique. Les endpoints Search Console conservent leur fenêtre de 400 jours, qui correspond à la durée de conservation des données GSC que nous stockons. Le connecteur Looker Studio gagne les options « Last 365 days », « All time » et « Follow report date range », ainsi que trois nouveaux types de rapports (Prompt performance, Share of Voice, Top Sources) fondés sur ces endpoints. -
2026-07 (fin de mois)
API d’écriture étendue : lancement, modification, suppression (v1.19.0). Les recommandations peuvent désormais être lancées via l’API :
POST /recommendations(MCPlaunch_recommendations) démarre une génération asynchrone et renvoie l’exécution à interroger. L’outil MCP n’exige plus la carte de confirmation du chat de l’application (les clients externes lancent directement, l’agent du chat intégré demande toujours une confirmation). Nouveaux endpoints de gestion, chacun avec son équivalent MCP :DELETE /prompts/:id,PATCH/DELETE /competitors/:id,PATCH/DELETE /collections/:idet un jeu complet pour les annotations (GET /annotations,PATCH/DELETE /annotations/:id, à partir du forfait Growth). Les suppressions sont irréversibles : les lignes disparaissent immédiatement et les données historiques sont purgées en arrière-plan. Tous les endpoints d’écriture exigent une clé APIread_writeet respectent la matrice d’autorisations des membres de l’équipe. -
2026-07
Amélioration de la qualité du MCP (à la suite de l’audit d’un agent externe). Les valeurs de
modelinconnues et les fenêtresfrom/toinversées renvoient désormaisERR_INVALID_PARAMau lieu d’être ignorées sans avertissement.GET /metrics/agent_trafficrenvoie le nouveau codeERR_AGENT_TRAFFIC_NOT_CONNECTEDlorsqu’aucune source de trafic des agents n’est connectée. DansGET /metrics/top_sources,avg_visibilitycorrespond désormais au pourcentage de réponses qui citent le domaine (entre 0 et 100). Les champsduration_mssont désormais réellement exprimés en millisecondes. Champs ajoutés :url_sha256+created_atsur les lignes de sources,matching_namessur les lignes de la liste des concurrents,scoresur les catégories de sentiment,created_atsur les annotations créées,data_throughsur les réponses Search Console (GSC publie ses données avec 2 à 3 jours de décalage). Outils MCP : les outils de liste acceptentrange,list_answerstronque par défaut les réponses à 1 500 caractères (full_text=truepour davantage), la vue par URL delist_citation_groupsreste compacte sauf avecinclude_page_details=true, les outils d’URL citées acceptent uneurlbrute en alternative àurl_sha256,get_sovinclut par défaut tous les concurrents configurés,list_promptsgagne un paramètre de recherchequery, et les erreurs de type « introuvable » reprennent l’identifiant demandé. -
2026-07 (fin de mois)
Fin de l’accès à l’API pour les abonnements expirés. Lorsqu’un abonnement en libre-service (Starter, Growth ou Scale) est résilié et que sa période payée est écoulée (après un court délai de grâce), les clés API du compte renvoient
403 ERR_ACCOUNT_INACTIVE. Les abonnements actifs ne sont pas concernés, pas plus que les forfaits payés sur facture et les forfaits négociés (Scale+ sur mesure, Partner, Enterprise), qui continuent de fonctionner, leur facturation étant gérée manuellement. Réabonnez-vous depuis la page de facturation pour rétablir l’accès. Nouveau code d’erreur :ERR_ACCOUNT_INACTIVE(403). -
2026-07 (fin de mois)
Visibilité corrigée pour les sources les plus citées. Dans
GET /metrics/top_sources,avg_visibility(et son aliasavg_mention_rate) correspond désormais à la part des réponses valides qui citent le domaine : le nombre de réponses distinctes qui le citent, divisé par l’ensemble des réponses valides de la période. Auparavant, le calcul comptait les lignes de sources (une réponse citant trois fois un domaine comptait trois fois) et ne divisait que par les réponses comportant au moins une source, ce qui pouvait donner des valeurs supérieures à 100 %. Attendez-vous à des pourcentages plus bas, mais exacts.total_responsesest inchangé. -
2026-07 (fin de mois)
Modèle Amazon Rufus (v1.18.0). Nouveau modèle d’IA
amazon_rufus(l’assistant IA d’Amazon pour les achats, alors appelé Amazon Rufus et depuis renommé Alexa for Shopping), lancé comme option du forfait Enterprise et désormais proposé en option payante sur tous les forfaits. Le filtremodeldes endpoints de métriques, de dimensions, de réponses et de sentiments accepteamazon_rufus. Comme pour les autres modèles en option, les données n’apparaissent que pour les comptes où le modèle est activé. -
2026-07 (fin de mois)
API de l’assistant de création de projet (v1.17.0). Création de projet en plusieurs étapes avec suggestions de l’IA :
POST /project_draftslance un brouillon et suggère un nom, une description et un secteur d’activité pour l’URL,PATCH /project_drafts/:idenvoie chaque étape (détails, prompts, concurrents, médias propriétaires) avec une progression strictement séquentielle et renvoie des suggestions pour l’étape suivante,GETlit l’état (suggestions servies uniquement depuis le cache, pour un polling sans risque) etPOST .../finalizecrée le projet avec exactement les mêmes effets que le mode rapide, de façon idempotente. Nouveaux codes d’erreurERR_DRAFT_NOT_FOUNDetERR_DRAFT_STATE. Les brouillons expirent au bout de 24 heures. Cinq outils MCP équivalents sont livrés en parallèle :create_project,start_project_draft,get_project_draft,update_project_draftetfinalize_project_draft, qui utilisent exactement les mêmes services que l’API REST. -
2026-07 (fin de mois)
API de création de projet (v1.16.0). Le nouvel endpoint
POST /projectscrée un projet complet en un seul appel (mode rapide) : champs du projet, prompts (mis en file pour une exécution et une catégorisation immédiates), concurrents, abonnement à l’e-mail hebdomadaire. Les rejeux idempotents viaexternal_identifier(comptes avec l’intégration iframe activée) renvoient le projet existant avecidempotent: true. L’optionexecute_prompts_immediately: falsereporte la première exécution au prochain créneau de suivi planifié. Les restrictions par forfait et les quotas s’appliquent exactement comme dans l’assistant de création dans l’application (ERR_LIMIT_REACHED,ERR_QUOTA_EXCEEDED,ERR_PLAN_REQUIRED). -
2026-07 (fin de mois)
Consignes d’utilisation MCP et détails de projet enrichis (v1.15.6). Dès l’initialisation, le serveur MCP renvoie désormais aux clients IA connectés des consignes d’utilisation : la marche à suivre recommandée, la dénomination des métriques, des conseils d’efficacité et la règle
brand_kind=non_brandpour des comparaisons équitables entre la marque et ses concurrents (comme le réglage par défaut de la page Vue d’ensemble dans l’application). Les filtresbrand_kindetprompt_typesont ajoutés aux trois endpointsGET /reports/ai_model_insights/*et à leurs outils MCP (get_ai_model_summary,get_ai_model_position_distribution,get_ai_overview_results) ; les valeurs invalides renvoientERR_INVALID_PARAM.GET /dimensions/projects/:id(et l’outil MCPget_project_details) incluent désormaisstats.prompts_by_brand_kindainsi qu’un blocdata_coveragequi liste les modèles, pays et langues disposant réellement de données : un seul appel remplace ainsi les appels distincts aux listes de modèles et de pays et langues. -
2026-07 (mi-mois)
Cohérence des métriques de citation (v1.15.4). Les citations et le taux de citation incluent désormais les citations visibles et les références de sources en arrière-plan dans les pages Vue d’ensemble et Analyse des modèles d’IA, l’API REST et le MCP. Les citations en arrière-plan n’ont pas de rang visible et restent exclues de
avg_positionet des répartitions de positions. L’appartenance des sources applique désormais de façon cohérente la correspondance exacte des sous-domaines. La vue Par domaine reste un regroupement par domaine enregistrable. Le format des réponses ne change pas. -
2026-07 (mi-mois)
Les notifications MCP Streamable HTTP renvoient désormais une réponse 202 vide. Les clients stricts comme Claude et Codex peuvent mener l’initialisation à son terme au lieu d’échouer en analysant une réponse JSON
null. -
2026-07 (mi-mois)
Les connexions OAuth MCP expirent désormais au bout d’un an. Les identifiants d’accès et de rafraîchissement partagent une même échéance d’autorisation fixe. Les réponses de rafraîchissement renvoient le même jeton de rafraîchissement réutilisable, pour éviter la perte d’identifiants et les échecs liés aux accès concurrents dans les clients MCP.
-
2026-07 (mi-mois)
REST et MCP réunis sur une couche de requêtes commune. Les endpoints de métriques (
/metrics/timeseries,summary,sov,prompt_summary,top_sources,agent_traffic,ai_traffic) et toutes les listes/dimensions/*exécutent désormais le même code de requête que leurs équivalents MCP, si bien que les deux interfaces renvoient toujours des données identiques. Les outils MCP ont reçu les filtres qui leur manquaient :prompt_type/brand_kindsurget_prompt_summary,get_top_sourceset les outils de liste, ainsi quesource_typesurlist_sources(dont les lignes incluent désormaissource_typeet des indicateurs de liens vers les boutiques d’applications, comme en REST). La validation des entrées MCP s’aligne sur REST : les identifiantscollection_id/promptinconnus, les dates mal formées et les plages de dates de plus de 400 jours renvoient des erreurs au lieu d’être ignorés sans avertissement. Les lignes delist_promptsincluent désormaiscollection_ids, et les lignes de résumé REST incluent le champmetricque le MCP renvoyait déjà. Une différence volontaire subsiste : en granularité semaine ou mois, le MCP laisse à null les périodes antérieures au premier point de données pour les métriques de taux et de position, afin de ne pas tirer les moyennes vers le bas, tandis que REST continue de les remplir avec0.0. -
2026-07
Établissements locaux dans le détail des réponses.
GET /answers/:id(et l’outil MCPget_answer) incluent désormais un tableaulocal_businesses: les établissements que ChatGPT affiche dans son widget de résultats locaux pour les prompts à intention locale, avec nom, adresse, téléphone, nombre d’avis, note, domaine du site web et position dans le classement, chacun rattaché à votre marque ou à un concurrent suivi viais_owned/competitor_id. -
2026-07
Corrections de bugs. Les outils MCP
get_timeseriesetget_summaryrenvoient désormais de vraies valeurs pournet_sentiment, les cinq ventilationssentiment_*etavg_mention_position(auparavant, chaque point de données valait null via MCP ; l’API REST n’était pas concernée), conformément à la sémantique des métriques REST.GET /dimensions/all_mentionsetGET /dimensions/all_citationseffectuent désormais la pagination dans la base de données, avec un ordre déterministe en cas d’égalité surcreated_at, ce qui rend les pages profondes rapides et stables sur les gros projets. Le format de réponse ne change pas. Les limites de requêtes personnalisées par clé sont désormais respectées par la limitation globale de l’API (la valeur par défaut reste de 300 requêtes par minute ; contactez-nous pour des quotas plus élevés). -
2026-06 (fin de mois)
API Trafic IA (Scale+). Le nouvel endpoint
GET /metrics/ai_trafficexpose le trafic provenant de l’IA que nous mesurons à partir de l’outil d’analyse web connecté au projet (Google Analytics 4, Adobe Analytics, PostHog, Plausible ou Piano) : utilisateurs, sessions et conversions par jour, regroupés par source IA (ChatGPT, Perplexity, Gemini, Claude et autres), avec les totaux et un taux de conversion. Nouvel outil MCP :get_ai_traffic. Nécessite le forfait Scale ou supérieur et un outil connecté ; les projets qui n’en ont pas renvoient le nouveau codeERR_AI_TRAFFIC_NOT_CONNECTED(404). -
2026-06 (fin de mois)
API Search Console (à partir du forfait Growth). De nouveaux endpoints exposent les données de performances de Google Search Console que nous synchronisons déjà pour les projets dont une propriété GSC est connectée :
GET /search_console/summary(impressions, clics, CTR et position moyenne globaux, avec ventilation facultative parcountry/device),GET /search_console/timeseries(séries par jour, semaine ou mois),GET /search_console/queriesetGET /search_console/pages(principales requêtes et pages classées par impressions, clics, CTR ou position, avec pagination).ctrest une fraction comprise entre 0 et 1 etpositionla moyenne pondérée par les impressions, comme dans l’API Search Console. Nouveaux outils MCP :get_search_console_summary,get_search_console_timeseries,get_search_console_queries,get_search_console_pages. Les projets sans propriété connectée renvoient le nouveau codeERR_SEARCH_CONSOLE_NOT_CONNECTED(404). -
2026-06 (fin de mois)
Part de mentions par domaine citant et filtres de sources par lot. Nouvel endpoint
GET /citation_intelligence/mentions_by_domain(et outil MCPget_mentions_by_citing_domain) : pour les réponses où chaque domaine source indiqué est cité, il renvoie la part de mentions de la marque face aux concurrents, normalisée pour que les acteurs de chaque domaine totalisent 100 %.GET /metrics/top_sourcesetGET /citation_intelligence/groups(et leurs outils MCP) acceptent désormais un tableaudomains(liste blanche de domaines exacts) et un tableaucollection_ids(filtre sur plusieurs tags à la fois) : même une grande matrice domaines x tags tient ainsi en un seul appel au lieu d’un appel par cellule. -
2026-06 (fin de mois)
Matrice d’autorisations des membres de l’équipe désormais appliquée à l’API et au MCP. Une clé API (ou une session MCP ou de l’agent de chat) appartenant à un membre de l’équipe aux droits restreints est soumise à la même matrice de fonctionnalités que l’application web : les endpoints et outils hors des fonctionnalités accordées au membre renvoient
403 ERR_INSUFFICIENT_PERMISSION(nouveau code d’erreur). Les clés du propriétaire du compte et des admins ne sont pas concernées : les intégrations existantes continuent donc de fonctionner sans changement. Les webhooks sortants deviennent une fonctionnalité à part entière, qui s’accorde séparément dans les autorisations (toujours Scale+). -
2026-06 (fin de mois)
Agrégats de période corrigés pour les métriques de taux dans
GET /metrics/summary. Pour les métriques en pourcentage (visibility/mention_rate,citation_rate,ai_visibility_score/weighted_visibility, parts de sentiment), le champtotalcorrespond désormais à la moyenne des périodes, et non plus à la somme des taux de chaque période (une somme qui pouvait dépasser 100 %). Les métriques de comptage (mentions,citations,responses) restent additionnées. Chaque ligne du résumé comporte désormais un champaggregation("sum"ou"average") qui indique commenttotala été calculé. La même correction s’applique à l’outil MCPget_summary, qui ne renvoie plus laseriescomplète avec le résumé (appelezget_timeseriespour les séries) et accepte un nouvel argumentgroup_by(modeloucollection) qui renvoie un résumé par groupe en un seul appel.GET /answers(et l’outil MCPlist_answers) acceptent un nouveau paramètrequerypour la recherche plein texte, insensible à la casse, dans le texte des réponses de l’IA :totaldevient le nombre exact de correspondances et les lignes contiennent unsnippetet unmatch_countau lieu du texte complet de la réponse. -
2026-06 (fin de mois)
Autorisation des membres sur les prompts et limites de prompts par projet. Les propriétaires de compte peuvent désormais retirer à un membre de l’équipe la possibilité d’ajouter ou de supprimer des prompts. Lorsque cette autorisation est désactivée,
POST /promptset l’outil MCPcreate_promptsrenvoient403 ERR_INSUFFICIENT_SCOPEpour la clé de ce membre (les endpoints de lecture ne sont pas concernés). Les propriétaires peuvent aussi définir une limite de prompts par projet dans les paramètres du projet ; une fois cette limite atteinte,POST /promptsetcreate_promptsrenvoientERR_LIMIT_REACHED(en plus du contrôle existant du quota du compte) pour tout le monde, propriétaire compris, jusqu’à ce que la limite soit relevée. Aucun nouvel endpoint ni code d’erreur. -
2026-06 (fin de mois)
Nouvel outil MCP
get_webhook_sample(Scale+), l’équivalent MCP deGET /webhooks/sample/:event_type, pour que les clients MCP puissent prévisualiser les payloads d’événements avant de s’abonner. Harmonisation des restrictions par forfait pour le catalogue des bots IA : l’endpoint RESTGET /dimensions/agent_botsest désormais réservé aux forfaits à partir de Scale (ERR_PLAN_REQUIREDen dessous), tandis que l’outil MCPlist_agent_botsdevient disponible sur tous les forfaits. -
2026-06 (mi-mois)
Webhooks sortants (Scale+, v1.9). Nouveaux endpoints :
POST /webhooks(abonner une URL HTTPS publique à un événement de projet),GET /webhooks(lister les abonnements),DELETE /webhooks/:id(se désabonner),GET /webhooks/sample/:event_type(exemples de payloads pour les outils de création d’intégrations). Sept types d’événements :mention.created,competitor_mention.created,citation.created,prompt_execution.completed,sentiment.negative_detected,recommendation.completed,intelligence_task.completed. Les envois sont signés en HMAC-SHA256 (X-LLMPulse-Signature), tentés jusqu’à 5 fois au total avec un délai croissant, et les abonnements se désactivent automatiquement après 20 échecs consécutifs. La création et la suppression exigent une clé de scoperead_write. Nouveaux outils MCP :create_webhook_subscription,list_webhook_subscriptions,delete_webhook_subscription. Les webhooks alimentent les nouveaux connecteurs Zapier, Make et n8n. -
2026-06
Content Intelligence devient GEO Writer. La fonctionnalité et sa section d’API s’appellent désormais GEO Writer dans l’application et la documentation. Ce changement ne concerne que l’affichage : les endpoints de l’API (
POST/GET /intelligence_tasks,GET /intelligence_tasks/:id), les formats de requête et de réponse, les codes d’erreur et les noms des outils MCP (create_intelligence_task,list_intelligence_tasks,get_intelligence_task) restent inchangés. La page marketing est passée de/features/content-intelligenceà/features/geo-writer, avec une redirection 301. -
2026-05 (fin de mois)
MCP disponible sur tous les forfaits via OAuth. L’endpoint MCP (
POST /api/v1/mcp) accepte désormais les jetons d’accès OAuth 2.1 émis via Dynamic Client Registration (RFC 7591) et PKCE-S256. Tout compte LLM Pulse, y compris les comptes Starter, Growth et en période d’essai, peut connecter ChatGPT, Claude, Gemini, Cursor ou tout autre client compatible MCP en collant l’URLhttps://api.llmpulse.ai/api/v1/mcpdans les paramètres MCP / connecteurs de ce client ; le client guide ensuite l’utilisateur dans une connexion OAuth, sans clé API. Le filtrage des outils par forfait s’applique toujours : les outils d’écriture et les outils de lecture avancés qui exigent Growth ou Scale restent exclus detools/listpour les comptes qui n’y ont pas accès. L’authentification par clé API (Authorization: Bearer …) ne change pas et reste la méthode recommandée pour les intégrations headless comme Data Studio, Zapier et les scripts de CI (à partir du forfait Scale). Les endpoints de découverte (/.well-known/oauth-authorization-server,/.well-known/oauth-protected-resource,/oauth/jwks.json) et les endpoints d’enregistrement, d’autorisation et de jeton se trouvent sous/oauth/*. -
2026-05 (fin de mois)
Nouveau type de recommandation : Sentiment et réputation (Scale+).
recommendation_typesurGET /recommendations(et l’outil MCPlaunch_recommendations) accepte désormaissentiment_reputationen plus deai_visibility,social_communityetbrand_building. Ce type transforme en recommandations concrètes les 30 derniers jours de sentiment de marque (étendus à 90 si les données sont rares), les thèmes négatifs, les écarts comparatifs où un concurrent est salué, les sources citées derrière les réponses négatives et les dimensions de réputation faibles. Disponible à partir du forfait Scale ; les comptes qui n’y ont pas droit reçoiventERR_INVALID_PARAMou une erreur de forfait. -
2026-05 (fin de mois)
Filtres de catégorisation des prompts. Chaque prompt est désormais classé automatiquement par
prompt_type(intention de recherche :informational,navigational,commercial,transactional) et parbrand_kind(brand= votre propre marque ou vos produits,brand_other= concurrents ou autres marques,non_brand= générique, aucune marque nommée). Les deux sont acceptés comme filtres facultatifs sur/metrics/timeseries,/metrics/summary,/metrics/sov,/metrics/prompt_summary,/metrics/top_sourceset/dimensions/prompts(qui renvoie aussi désormais ces deux champs pour chaque prompt). Les valeurs non valides renvoientERR_INVALID_PARAM. Les mêmes filtres sont disponibles via les argumentsprompt_type/brand_kinddes outils MCPget_timeseries,get_summary,get_sovetlist_prompts. -
2026-05 (mi-mois)
Endpoints d’écriture pour agents (v1.5). Les clés API exposent désormais un
scope(readouread_write) ; pour les clés existantes,fullest traité comme synonyme deread_write. Les endpoints de modification (POST/PATCH/PUT/DELETE) exigent désormais une clé de scoperead_writeet renvoient sinon403 ERR_INSUFFICIENT_SCOPE. Une seconde limite de requêtes (60/min par clé) s’applique aux écritures, en plus du budget global de 300/min par clé. Nouveaux endpoints REST :POST /competitors,POST /collections,POST /prompts/assign_tags(ajout de tags en masse, idempotent),POST /annotations(à partir de Growth),POST /technical_geo_reports(ensemble GEO complet). Nouveaux outils MCP d’écriture :create_competitor,create_collection,assign_prompt_tags,create_annotation,launch_recommendations(avec confirmation préalable de l’utilisateur dans l’agent de chat),create_technical_geo_report(idem). Nouveaux codes d’erreur :ERR_INSUFFICIENT_SCOPE(403) pour les clés en lecture seule qui tentent une écriture,ERR_PLAN_REQUIRED(403) pour les annotations sur le forfait Starter. -
2026-05
Les projets exposent désormais
brand_nameséparément denamedans les payloads de l’API et du MCP.brand_nameest le libellé de marque envoyé aux LLM et affiché dans les graphiques destinés aux clients ;namereste le libellé interne du projet.nameest toujours renvoyé pour la rétrocompatibilité.mention_rateest accepté comme synonyme devisibilitydans les paramètres de/metrics/*et dans les outils MCP timeseries / summary / top_sources. Le paramétrage des modèles d’IA propre à chaque utilisateur s’applique désormais à tous les endpoints de lecture : les métriques, dimensions, réponses, sentiments et citations renvoyés par l’API excluent sans avertissement les modèles non activés pour l’utilisateur de la clé API. À la date de cette version, les options payantes actives étaient Copilot, Claude, Grok, DeepSeek et Alexa for Shopping ; l’exécution récurrente de Meta AI n’était pas encore active. Les métriques par date utilisent désormais le fuseauEurope/Madridpour les regroupements quotidiens, hebdomadaires et mensuels, ce qui corrige les lignes décalées d’un jour autour de minuit UTC. -
2026-04 (fin de mois)
API Agent Analytics (Scale+, bêta) :
GET /metrics/agent_trafficetGET /dimensions/agent_botsexposent le trafic des crawlers IA (GPTBot, PerplexityBot, ClaudeBot, OAI-SearchBot, Google-Extended et environ 25 autres), issu de Cloudflare ou d’imports CSV. Nouvel outil MCP :get_agent_traffic. Letools/listdu MCP est désormais filtré selon votre forfait : les outils auxquels vous n’avez pas accès n’apparaissent plus dans le catalogue, et un appel direct à un outil restreint renvoie proprementERR_PLAN_REQUIREDau lieu d’exposer son schéma. Renforcement des contrôles d’authentification du MCP pour l’accès des membres au compte de leur propriétaire. -
2026-04 (mi-mois)
API Citation Intelligence :
GET /citation_intelligence/groups(groupes d’URL citées, filtrables par source et par type),GET /citation_intelligence/urls/:url_sha256,/occurrenceset/contentpour le détail par URL. API des rapports d’analyse des modèles d’IA :GET /reports/ai_model_insights/summary,/position_distributionet/ai_overview_results. API Recommandations :GET /recommendationsetGET /recommendations/:id. Nouveaux outils MCP : list_citation_groups, get_cited_url_details, list_cited_url_occurrences, get_cited_url_content, get_ai_model_summary, get_ai_model_position_distribution, get_ai_overview_results, list_recommendations, get_recommendation, list_competitor_mentions, list_competitor_citations, list_prompt_executions, list_tags. Validation plus stricte des valeurs énumérées pourview,order,direction,granularity,model,source_type,sentiment,content_gap,recommendation_typeetstatus: les valeurs inconnues renvoient désormaisERR_INVALID_PARAMau lieu d’être ignorées sans avertissement. Le filtresource_typeaccepteowned,competitoretthird_partyen plus des listes de classification. Les résultats Google AI Overviews sont regroupés parexecuted_at(et non parcreated_at), si bien que les lignes relancées ou rattrapées sont rattachées au bon jour. -
2026-04
Nouvel endpoint
POST /promptspour créer des prompts en masse (jusqu’à 100 par requête). Nouvelle API Content Intelligence :POST /intelligence_taskspour créer des tâches,GET /intelligence_taskspour les lister avec des filtres,GET /intelligence_tasks/:idpour le détail complet et les résultats. Nouveaux outils MCP : create_prompts, create_intelligence_task, list_intelligence_tasks, get_intelligence_task. Nouveaux codes d’erreur :ERR_LIMIT_REACHED(quota de prompts),ERR_QUOTA_EXCEEDED(quota de tâches Content Intelligence),ERR_NOT_FOUND(ressource introuvable). -
2026-03
Nouvel endpoint
GET /metrics/prompt_summarypour obtenir en une seule requête les métriques paginées par prompt (réponses, mentions, citations, taux de mention, taux de citation) -
2026-02
Ajout de la métrique
ai_visibility_score(visibilité pondérée par la position). Nouveaux outils MCP : list_answers, get_answer, list_detailed_sentiments, get_project_details, get_competitor_details. Nouveaux endpoints de l’API : /answers, /sentiments, /dimensions/projects/:id, /dimensions/competitors/:id. Ajout de la métriqueresponses(nombre d’exécutions de prompts) et de la métriquecitation_rate(citations / réponses x 100). Limite de requêtes de l’API relevée de 100 à 300 requêtes par minute. Ajout du filtrepromptà tous les endpoints de métriques et de dimensions. -
2026-01
Ajout de l’endpoint MCP (Model Context Protocol) pour les intégrations IA avec Claude, ChatGPT et d’autres assistants IA
-
2025-12
Ajout des métriques de sentiment à /metrics/timeseries (sentiment_very_positive/positive/neutral/negative/very_negative) et documentation de leur sémantique
-
2025-09
Métriques alignées sur la page Vue d’ensemble (totaux de période avec report des valeurs, rapport des sommes de la période pour le taux de mention, propagation dans avg_position), répartition du Share of Voice, filtre
querydans Top Sources, notes sur le cache, téléchargement Postman et section sur les environnements -
2025-08
Première documentation publique de l’API (v1)