Nouveautés de l’API

Toutes les modifications de l’API REST et des outils MCP, des plus récentes aux plus anciennes.

  1. 2026-11-16 (v1.97.0)

    L’AI Visibility Score se divise par les exécutions de suivi. ai_visibility_score sur /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.

  2. 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/summary et l’outil MCP get_summary cumulent 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_rate ses 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, le total é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. aggregation indique toujours average, et min, max, last, les totaux de comptage et l’AI Visibility Score ne changent pas. Le brand_name d’un projet accepte désormais au maximum 100 caractères : POST /projects, PATCH /projects/{id}, les brouillons de projet à la finalisation et les outils MCP create_project et update_project refusent un nom plus long avec ERR_INVALID_PARAM. Lorsque brand_name est 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.

  3. 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 12abc ou maybe), un identifiant qui n’appartient pas au projet, un range mal formé ou un from postérieur à to renvoie ERR_INVALID_PARAM en 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, /sentiments et les listes /dimensions, un to envoyé sans from donne les 30 jours qui se terminent à cette date. /answers et list_answers acceptent aussi prompt_type et brand_kind. L’AI Visibility Score est désormais le même partout : /metrics/summary et get_summary renvoient 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. Avec output=csv, les horodatages utilisent la même forme ISO 8601 que le JSON, et /dimensions/ads renvoie executed_at avec 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ègle path_prefix sur 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.

  4. 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 /projects et l’outil MCP create_project acceptent un project_type facultatif (par exemple core ou lean), 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/:id et l’outil MCP update_project permettent 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 renvoient project_type, null pour les comptes sans types de projet. Tout autre compte qui l’envoie reçoit ERR_INVALID_PARAM.

  5. 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 MCP list_custom_reports et get_custom_report, date_range.type peut désormais aussi valoir previous_3_months (les 3 mois calendaires qui précèdent le mois en cours) ou custom (dates fixes), et date_range ajoute custom_from et custom_to, les dates choisies pour une période personnalisée (null sinon). Le to d’une période personnalisée s’arrête à aujourd’hui. Le nouveau widget monthly_breakdown renvoie 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.

  6. 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_cache des détails de page citée (GET /citation_intelligence/urls/{url_sha256}, GET /citation_intelligence/urls/{url_sha256}/content, la vue par URL de GET /citation_intelligence/groups, GET /answers/{id} avec include_source_page_details=true et leurs outils MCP) n’inclut plus source, un libellé interne non documenté qui désignait le service ayant récupéré la page. Aucun champ documenté n’a changé.

  7. 2026-11-11 (v1.92.0)

    Taux de réponse Trustpilot. Dans GET /dimensions/owned_media?provider=trustpilot&view=brands et l’outil MCP list_owned_media, chaque ligne de marque ajoute reviews_held, replied_count, not_replied_count, reply_rate_pct et median_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=trustpilot et l’outil MCP get_owned_media_summary renvoient les mêmes chiffres pour votre propre profil sous replies.

  8. 2026-11-11 (v1.91.0)

    Bing AI Mode. La valeur bing_ai_mode de model (la page de réponse de l’IA dans Microsoft Bing, que Microsoft appelle Copilot Search, distincte de copilot) 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.

  9. 2026-11-11 (v1.90.0)

    Les liens vers les paramètres suivent les onglets renommés. Le connect_url renvoyé lorsqu’un site WordPress est absent ou doit être reconnecté (GET /cms/content, GET /cms/content/{id}, POST /intelligence_tasks/{id}/send_to_cms et leurs outils MCP) ouvre désormais la carte WordPress dans Paramètres du projet > Connexions (tab=data_connections#wordpress). Les liens avec tab=wordpress fonctionnent toujours. Le message de ERR_SEARCH_CONSOLE_ACCESS_REVOKED et 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é.

  10. 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/import et les outils MCP create_prompts et import_prompts renseignent aussi first_runs_wait_until lorsque 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é, et warning indique la part du projet comme motif. Rien ne change pour les autres comptes.

  11. 2026-11-09 (v1.88.0)

    Notes et avis Trustpilot. GET /dimensions/owned_media et l’outil MCP list_owned_media acceptent provider=trustpilot : view=profiles liste les profils Trustpilot cités par les réponses de l’IA, avec leur note et leur nombre d’avis, view=brands donne la note, l’évolution de la note, le nombre d’avis et les citations de votre marque et de chaque concurrent, et view=reviews liste les avis publiés sur leurs profils. Les lignes comportent désormais rating, rating_change, reviews_count, status, brand, text, author et replied. GET /dimensions/owned_media/summary et l’outil MCP get_owned_media_summary acceptent provider=trustpilot, et provider=overview inclut Trustpilot. Les notes et les avis sont relevés une fois par mois.

  12. 2026-11-07 (v1.87.0)

    Correspondances Search Console et corrections du trafic IA. GET /search_console/ai_visibility_gaps et l’outil MCP get_search_console_ai_visibility_gaps associent 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ésormais match_type : prompt, fan_out ou null. 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_traffic et l’outil MCP get_ai_traffic excluent les sessions dont le support est payant, comme cpc, sur Google Analytics 4 et Piano Analytics.

  13. 2026-11-05 (v1.86.0)

    Refus de répondre. GET /answers, GET /answers/{id} et les outils MCP list_answers et get_answer ajoutent no_result_reason à chaque réponse marquée no_result : declined quand le modèle a refusé de répondre (pour l’instant uniquement Gemini ; l’application l’affiche comme un refus) ou no_answer quand aucune réponse n’a pu être collectée. En cas de refus, le champ response contient désormais le texte renvoyé par le modèle au lieu d’un texte de remplacement. no_result ne change pas, et une véritable réponse ne comporte pas de no_result_reason.

  14. 2026-11-05 (v1.85.0)

    Lancer un rapport de réputation. POST /reputation/reports et l’outil MCP create_reputation_report lancent 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 avec created à false et le rapport qui couvre déjà le mois. Avec recalculate à true, ils utilisent l’unique recalcul manuel du mois, qui relance tous les modèles d’analyse, et renvoient ERR_LIMIT_REACHED dès que le mois compte deux rapports. Interrogez GET /reputation/reports jusqu’à ce que le rapport soit terminé. Nécessite le suivi de la réputation, une clé read_write et, pour les membres de l’équipe, l’autorisation de création sur Réputation.

  15. 2026-11-04 (v1.84.0)

    Séries d’activité pour les médias propriétaires et Reddit. GET /dimensions/owned_media accepte view=activity pour 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_name est l’identifiant de l’application, sans recherche externe. GET /dimensions/owned_media/summary accepte provider=reddit et 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 et positive_pct. Les paramètres existants restent en place ; view et provider acceptent 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.

  16. 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_cms et send_intelligence_task_to_cms mettent 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} et get_intelligence_task listent les brouillons dans cms_drafts avec leur statut et leur lien de modification. GET /cms/content, GET /cms/content/{id}, list_cms_content et get_cms_content lisent 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) et ERR_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ésormais range ou from comme obligatoire sur GET /metrics/summary, /metrics/prompt_summary, /metrics/timeseries, /metrics/sov et /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.

  17. 2026-11-04 (v1.82.0)

    Webhook des exécutions de suivi terminées. Le nouveau type d’événement tracking_run.completed se 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_start et period_end), le status de l’exécution (completed, ou timed_out si des réponses ou le sentiment manquaient encore au bout de 24 heures) et ses décomptes de réponses.

  18. 2026-11-04

    Les outils MCP de métriques indiquent leur période obligatoire. get_prompt_summary, get_timeseries, get_sov et get_top_sources déclarent désormais dans leur schéma d’entrée, comme le faisait déjà get_summary, qu’un appel exige range ou from. Un appel sans l’un ni l’autre est refusé avant l’exécution de l’outil, toujours avec ERR_INVALID_PARAM, et son error nomme désormais les deux arguments au lieu d’indiquer range is required. Les endpoints REST ne changent pas.

  19. 2026-11-04

    Exécutions sans réponse exclues des taux du résumé par modèle. GET /reports/ai_model_insights/summary et get_ai_model_summary divisent 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 dans denominator ni dans denominators_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é.

  20. 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ètres property, de date et de périmètre que les autres endpoints Search Console. GET /search_console/opportunities classe 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/cannibalization liste les requêtes dont les impressions se répartissent entre au moins deux pages, avec la part de chaque page. GET /search_console/decay liste 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_split ré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_gaps associe 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, acceptent output=flat et output=csv.

  21. 2026-11-03 (v1.80.0)

    Le quota de réponses de l’IA dans les données du compte. GET /account et get_account_usage ajoutent limits.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, week ou month) et resets_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.

  22. 2026-11-03 (v1.79.0)

    La création de prompts indique quand les premières exécutions doivent attendre. POST /prompts, POST /prompts/import et leurs outils MCP create_prompts et import_prompts renvoient first_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, et warning le 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.

  23. 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_sentiment et la value des parts de marché des mentions, des citations et du sentiment sont nullables : ils valent null quand 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.

  24. 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/summary et get_ai_model_summary listent 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. Un share_of_total sans rien à répartir, un net_sentiment sans sentiment et une valeur de part de marché pour un modèle qui n’a ni réponse ni sentiment valent désormais null, car 0 est une vraie valeur. Les outils MCP get_timeseries et get_summary renvoient null pour une période sans réponse au lieu de 0 ou d’une valeur reportée (responses reste à 0) ; les endpoints REST conservent leur comportement. POST /prompts, POST /prompts/import et create_project considèrent comme des doublons les prompts qui ne diffèrent que par la casse ou les espaces. La ligne de votre marque dans GET /dimensions/competitors porte matching_names, et le context d’une recommandation ne renvoie que les champs qui décrivent l’exécution.

  25. 2026-11-02

    Revalidation simplifiée sur les endpoints de métriques. GET /metrics/timeseries, GET /metrics/summary, GET /metrics/prompt_summary, GET /metrics/sov et GET /metrics/top_sources n’envoient plus Last-Modified et ignorent If-Modified-Since. Leur ETag est désormais un hash du corps de la réponse : une réponse JSON, qui porte un nouveau request_id à chaque fois, revient donc toujours en entier, et seule une réponse output=csv inchangée peut encore donner lieu à un 304 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.

  26. 2026-11-01 (v1.77.0)

    Projets de pitch. POST /projects et create_project acceptent pitch: true pour 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} et update_project avec pitch: false, envoyé seul, convertissent un projet de pitch en projet suivi. GET /dimensions/projects et list_projects excluent les projets de pitch, sauf avec pitch=include ou pitch=only, et chaque ligne de projet comporte désormais pitch et pitch_expires_at. Les détails du projet ajoutent pitch_run (statut, dates, modèles d’IA et réponses reçues), GET /account ajoute limits.pitch_projects avec le quota mensuel et l’accès du compte, et untracked_reason peut valoir pitch_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 renvoie ERR_INVALID_PARAM avec error.meta.reason pitch_prompts_frozen. Dans les outils MCP, un projet de pitch n’est accessible que par son identifiant.

  27. 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_url d’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-optimization y redirigent. Les endpoints, les paramètres, les champs et les noms des outils MCP ne changent pas.

  28. 2026-10-31 (v1.76.0)

    Filtres Aucune citation et Aucune mention. citation_filter sur GET /answers et GET /dimensions/prompt_executions, ainsi que sur les outils MCP list_answers et list_prompt_executions, accepte no_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_brands et citation_filter=no_citations ne 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.

  29. 2026-10-31 (v1.75.0)

    Sentiment et répartitions Reddit dans l’API et le MCP. GET /dimensions/reddit et list_reddit_citations acceptent view=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 son count et son pct au sein de la répartition, comme sur les graphiques de la page. Les autres filtres de l’endpoint s’appliquent, et il prend en charge output=flat et output=csv.

  30. 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_schema et query_web_analytics. Dans ChatGPT, get_ai_traffic ré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 MCP create_webhook_subscription porte désormais l’annotation destructiveHint: 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.

  31. 2026-10-28 (v1.74.0)

    Naver AI Tab, Qwen et Doubao. Les valeurs naver_ai_tab, qwen et doubao du paramètre model sont 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.

  32. 2026-10-28 (v1.73.0)

    Supprimer un projet via l’API. Le nouvel endpoint DELETE /projects/:id et l’outil MCP delete_project suppriment 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 (sinon ERR_KEY_PROJECT_SCOPED), et les membres de l’équipe doivent avoir l’autorisation de supprimer des projets.

  33. 2026-10-28 (v1.72.0)

    Clés API via l’API. Les nouveaux endpoints GET /api_keys, POST /api_keys et DELETE /api_keys/:id listent 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.

  34. 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_INACTIVE quand 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 renvoient tracked et untracked_reason, et POST /prompts et /prompts/import ajoutent un warning quand les prompts ne seront pas exécutés. GET /webhooks et DELETE /webhooks/:id fonctionnent sur tous les forfaits, pour supprimer un abonnement mis en pause en dessous du forfait Scale. Les audits GEO gagnent la valeur quota pour paused_reason, public_link_active exige un compte actif à partir du forfait Scale, et les exécutions des recommandations Sentiment et réputation renvoient ERR_NOT_FOUND sans accès à la réputation.

  35. 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_code et include_project sur GET /metrics/summary et GET /metrics/sov ; collection_ids et domains sur GET /metrics/top_sources ; prompt_type, brand_kind et range sur GET /dimensions/mentions, /citations, /competitor_mentions, /competitor_citations, /all_mentions, /all_citations et /sources (plus country_code et language_code sur les listes des concurrents et les listes combinées) ; et prompt_type et brand_kind sur GET /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 ; un from ou un to explicite reste prioritaire, et un range qui n’est pas un seul nombre positif, ou qui dépasse 1 500 jours, renvoie ERR_INVALID_PARAM. domains sur GET /metrics/top_sources et GET /citation_intelligence/mentions_by_domain, ainsi que collection_ids sur GET /metrics/top_sources, acceptent une valeur ou une liste séparée par des virgules (domains=gmac.com,educaweb.com), et la forme entre crochets domains[]= fonctionne toujours. Un domains sé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 pour mentions_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. model sur GET /reports/ai_model_insights/position_distribution ne liste plus que les sept modèles acceptés par l’endpoint ; les autres valeurs étaient déjà refusées avec ERR_INVALID_PARAM. status sur GET /intelligence_tasks liste désormais ses valeurs. Les outils MCP ne changent pas.

  36. 2026-10-23 (v1.69.0)

    Motifs d’archivage et effort pour les éléments de recommandation. PATCH /recommendations/:id/items/:item_id et update_recommendation_item acceptent un reason facultatif lors de l’archivage (not_relevant, too_complex ou competitor), dont les exécutions suivantes des recommandations tiennent compte ; il est renvoyé dans metadata.archive_reason. Les nouveaux éléments portent metadata.effort (low, medium ou high).

  37. 2026-10-22 (v1.68.0)

    Plusieurs propriétés Search Console par projet. Le nouvel endpoint GET /search_console/properties (MCP list_search_console_properties) liste jusqu’à 10 propriétés connectées. Chaque lecture Search Console accepte property : un identifiant de propriété, ou une liste séparée par des virgules ou all pour en combiner plusieurs, avec en réponse properties, excluded_properties (déjà comptées par une autre propriété sélectionnée) et property_errors. property est aussi une dimension du résumé et une dimension des lignes, et les détails du projet indiquent search_console.properties_count.

  38. 2026-10-21 (v1.67.0)

    État des connexions de données et liens de connexion. GET /dimensions/projects/:id et get_project_details renvoient désormais ai_traffic et agent_traffic à côté de search_console, pour qu’un client voie quelles sources de données un projet possède avant d’appeler leurs endpoints. Chacun comporte un status (connected, reconnect_required ou not_connected, plus imported quand le trafic des agents provient uniquement de logs importés), la property ou le provider connecté, et connect_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 dans error.meta.connect_url, et leurs outils MCP le renvoient sous connect_url. Rien d’autre ne change dans ces réponses.

  39. 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 /webhooks et l’outil MCP list_webhook_subscriptions n’affichent plus de target_url que le schéma, l’hôte et le port s’il n’est pas celui par défaut, suivis de /… (par exemple https://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 avec mcp: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 avec disabled: 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/:id omet désormais sentiments en dessous du forfait Growth et shopping_products en dessous du forfait Scale, comme le faisait déjà l’outil MCP get_answer. Les deux renvoient plan_required_fields, la liste des champs omis, toujours présente et vide si rien n’est omis ; get_answer la renvoyait auparavant sous forme d’objet indiquant le forfait de chaque champ, et seulement quand un champ était omis. Dans POST /prompts/import et l’outil MCP import_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 dans row_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.

  40. 2026-10-19 (v1.65.0)

    Limites des variantes du nom. matching_names accepte désormais au maximum 50 noms, de 100 caractères chacun au plus, sur POST /projects, PATCH /projects/:id, POST /competitors, PATCH /competitors/:id et POST /project_drafts/:id/finalize, ainsi que sur les outils MCP create_project, update_project, create_competitor, update_competitor et finalize_project_draft. Ces 50 noms incluent le nom de marque que POST /competitors et PATCH /competitors/:id ajoutent à la liste. Une liste plus longue ou un nom plus long renvoie ERR_INVALID_PARAM (422) et aucun élément de la requête n’est appliqué. Les étapes de PATCH /project_drafts/:id continuent 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 avec maxItems et maxLength. Une liste enregistrée avant ce changement continue de fonctionner jusqu’à sa prochaine modification.

  41. 2026-10-16 (v1.64.0)

    Limites de prompts par projet dans l’API et le MCP. GET /dimensions/projects/:id et get_project_details renvoient prompt_limit (null en l’absence de limite) et stats.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/:id et l’outil MCP update_project acceptent un prompt_limit entier 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çoivent ERR_INSUFFICIENT_PERMISSION, une clé limitée à certains projets reçoit ERR_KEY_PROJECT_SCOPED, et une requête refusée n’applique rien. Des valeurs comme "5" ou 5.0 renvoient ERR_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 que prompt_limit est enregistrée même pendant un recalcul.

  42. 2026-10-15 (v1.63.0)

    Davantage de fonctions de l’application dans l’API et le MCP. GET /custom_reports, GET /custom_reports/:id et POST /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/topics et GET /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.

  43. 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_media et PATCH /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.

  44. 2026-10-15 (v1.63.0)

    Toutes les façons d’ajouter des prompts, via l’API. POST /prompts/import et l’outil MCP import_prompts acceptent jusqu’à 500 lignes, chacune avec son pays, sa langue et ses tags, comme l’import CSV. POST /prompt_generations et generate_prompt_suggestions lancent 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 sur GET /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/accept transforme des idées en prompts suivis et POST /suggested_prompts/reject les écarte (accept_suggested_prompts, reject_suggested_prompts). POST /prompts/remove_tags est désormais le jumeau REST de l’outil MCP remove_prompt_tags, et PATCH /prompts/:id (update_prompt_categorization) définit manuellement la classification d’un prompt : intention de recherche et marque dans le prompt.

  45. 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_sha256 et l’outil MCP get_cited_url_details acceptent include_series=true, qui ajoute citation_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), avec total égal à stats.total_responses. Les périodes datent chaque réponse d’après son executed_at, dans le fuseau Europe/Madrid. Sans include_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, sentiment et content_gap) et accepte brand_kind. Pour un domaine ou un hôte, GET /citation_intelligence/groups et l’outil MCP list_citation_groups acceptent key, qui ne renvoie que ce groupe de la vue choisie, et avec key, include_series=true ajoute le même citation_series à sa ligne ; include_series sans key renvoie ERR_INVALID_PARAM (422). GET /citation_intelligence/groups applique aussi brand_kind, qu’il ignorait auparavant.

  46. 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/:id et l’outil MCP update_intelligence_task_content ne conservent que p, ul, ol, li, strong, em, h3 et br dans description_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/revert restaure la description générée, nettoyée de la même façon.

  47. 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/:id et les outils MCP list_answers et get_answer renvoient cette exécution avec no_result: true et 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 de no_result citent désormais les deux causes.

  48. 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 MCP create_webhook_subscription, renvoie, comme avant, l’abonnement existant, mais n’inclut secret que 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 sans secret et 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 jamais secret. 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 toujours secret. Pour obtenir un nouveau secret pour un abonnement existant, supprimez-le puis recréez-le.

  49. 2026-10-12 (v1.60.0)

    Un code sur chaque erreur d’outil MCP. Chaque tools/call en échec porte désormais code à côté de error, avec la valeur que l’endpoint REST renvoie pour le même état ; jusqu’ici, certaines erreurs d’outil ne portaient que error, 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 avec error. Les arguments manquants ou invalides, y compris les valeurs que le schéma d’entrée d’un outil rejette avant son exécution, renvoient ERR_INVALID_PARAM. Un projet inconnu renvoie ERR_PROJECT_NOT_FOUND sur tous les outils, et tout autre enregistrement introuvable ERR_NOT_FOUND (ERR_DRAFT_NOT_FOUND pour les brouillons). Un outil refusé en raison d’un scope OAuth ou une clé en lecture seule renvoie ERR_INSUFFICIENT_SCOPE, pour les autorisations d’un membre de l’équipe ERR_INSUFFICIENT_PERMISSION, et sur un portail en marque blanche ERR_INTEGRATION_UNAVAILABLE. Les refus liés aux budgets et aux limites quotidiennes renvoient ERR_LIMIT_REACHED ou ERR_QUOTA_EXCEEDED, comme en REST. Le texte de error ne change pas.

  50. 2026-10-12 (v1.60.0)

    GET /dimensions/sources refuse un source_type inconnu ou à la casse différente. GET /dimensions/sources ignorait auparavant un source_type inconnu, ou la forme tableau source_type[], et listait toutes les sources, tandis qu’une valeur à la casse différente comme Owned était appliquée comme owned. L’endpoint accepte désormais exactement owned, competitor ou third_party ; toute autre valeur, y compris Owned et OWNED, renvoie ERR_INVALID_PARAM (422) avec les valeurs acceptées. L’outil MCP list_sources refuse les mêmes valeurs avec le même code.

  51. 2026-10-12 (v1.60.0)

    Autres domaines de la marque dans l’API. PATCH /projects/:id et l’outil MCP update_project acceptent additional_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é avec ERR_INVALID_PARAM et le motif. GET /dimensions/projects/:id et get_project_details renvoient la liste.

  52. 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_domains retraite 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çoit ERR_INSUFFICIENT_PERMISSION et 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 avec matching_names ne lance qu’un seul recalcul. L’objet project de la réponse renvoie la liste, et PATCH /projects/:id publie désormais son schéma de réponse. Pendant un recalcul, PATCH /projects/:id et l’outil MCP update_project refusent toute nouvelle modification avec ERR_INVALID_PARAM ; ce message ne promet plus une attente de quelques minutes et demande désormais de réessayer une fois le recalcul terminé.

  53. 2026-10-12 (v1.60.0)

    Ce que conserve la suppression d’un concurrent. DELETE /competitors/:id et l’outil MCP delete_competitor conservent 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.

  54. 2026-10-12 (v1.60.0)

    Exceptions du filtre de modèle documentées. La référence décrit désormais le filtre model tel que chaque endpoint l’appliquait déjà. Un modèle inconnu, ou que le compte n’a pas activé, renvoie ERR_INVALID_PARAM (422), avec les exceptions suivantes. GET /sentiments ignore une telle valeur. Les endpoints d’analyse des citations n’acceptent que chatgpt, ai_mode, ai_overview, perplexity, gemini, naver_ai et baidu_ai. GET /reports/ai_model_insights/position_distribution accepte ces sept modèles même lorsqu’ils ne sont pas activés. Les endpoints /metrics acceptent aussi google-ai-mode et google-ai-overview, comme équivalents de ai_mode et ai_overview.

  55. 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ésormais ERR_INVALID_PARAM (422), comme sur /metrics et /answers. project_id sur GET /dimensions/agent_bots est désormais documenté comme obligatoire mais ignoré : le catalogue de bots est le même pour tous les projets.

  56. 2026-10-12 (v1.60.0)

    Nom de marque dans les listes de projets, et filtre de modèle sur les prompts. GET /dimensions/projects et l’outil MCP list_projects renvoient désormais le brand_name de chaque projet (null s’il n’est pas défini), tout comme le project que GET /ping ajoute lorsqu’il est appelé avec project_id, comme le déclarait déjà le schéma Project publié. GET /dimensions/prompts applique désormais model, 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 filtre prompt, qui fonctionnait déjà, est désormais documenté. L’outil MCP list_prompts accepte les deux filtres.

  57. 2026-10-12 (v1.60.0)

    Les webhooks dont l’identifiant d’accès est révoqué apparaissent comme désactivés. GET /webhooks et l’outil MCP list_webhook_subscriptions renvoient disabled: true, au lieu de false, 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.

  58. 2026-10-12 (v1.59.0)

    Les lignes de GET /metrics/prompt_summary comportent désormais le sentiment de marque de chaque prompt : sentiment_responses (réponses avec un verdict de sentiment pour la marque), les cinq pourcentages sentiment_* rapportés à ce nombre et net_sentiment, calculés comme les métriques de sentiment de /metrics/timeseries et null lorsqu’aucune réponse n’a de verdict. Ils respectent breakdown=model et 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 MCP get_prompt_summary renvoie les mêmes champs.

  59. 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_members et GET /team_invitations listent les membres (propriétaire du compte en premier) et les invitations en attente, avec leurs accès et leurs projets, POST /team_invitations envoie une invitation par e-mail, DELETE /team_invitations/:id en révoque une et DELETE /team_members/:id retire un membre. Les outils MCP sont list_team_members, list_team_invitations, invite_team_member, revoke_team_invitation et remove_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çoit ERR_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 renvoie ERR_LIMIT_REACHED.

  60. 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, et PATCH /intelligence_tasks/:id et l’outil MCP update_intelligence_task_content l’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’erreur ERR_STALE_CONTENT (409), rien n’est écrit et error.meta.result_version contient le token actuel. Sans result_version, les modifications s’appliquent comme avant. GET /metrics/ai_traffic, GET /metrics/agent_traffic et les outils MCP get_ai_traffic et get_agent_traffic renvoient ERR_INVALID_PARAM (422) pour un range inférieur à 1 ou un from posté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 /webhooks renvoie 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.

  61. 2026-10-12 (v1.58.0)

    Ajouts à l’API Search Console. Le nouvel endpoint GET /search_console/rows et l’outil MCP get_search_console_rows regroupent 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, et aggregation_type (auto, byPage, byProperty) fonctionne sur tous les endpoints Search Console. Les réponses REST incluent désormais data_through ; avec output=csv, X-Data-Through et X-Truncated transmettent la même information. Côté MCP, les erreurs amont incluent retry_after. GET /dimensions/projects/:id et get_project_details indiquent la connexion Search Console (search_console.status et property). REST et MCP lisent la plage de dates de la même façon : un range non valide renvoie ERR_INVALID_PARAM, et seul un from postérieur à to renvoie ERR_INVALID_RANGE.

  62. 2026-10-10 (v1.57.0)

    Analyse web en direct (à partir du forfait Growth). Les nouveaux endpoints GET /web_analytics/schema et POST /web_analytics/query, avec les outils MCP get_web_analytics_schema et query_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) et ERR_WEB_ANALYTICS_UPSTREAM (503 avec Retry-After).

  63. 2026-10-10 (v1.57.0)

    Indicateur de troncature de la répartition Search Console. GET /search_console/summary et l’outil MCP get_search_console_summary renvoient désormais breakdown_truncated: true lorsque la répartition omet des lignes, en raison de limit ou du maximum de 25 000 lignes que renvoie Google. Avec filters et sans dimension, les totaux du résumé correspondent au chiffre complet que Google indique pour ce filtre.

  64. 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_dir et breakdown sur get_prompt_summary, sort sur get_top_sources, group_by et granularity sur get_agent_traffic, granularity sur get_ai_traffic, et source_type sur list_sources, désormais sensible à la casse. get_ai_model_position_distribution accepte naver_ai et baidu_ai. Davantage d’outils MCP d’écriture renvoient le code d’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_tags ignore create_missing pour les membres de l’équipe qui ne peuvent pas créer de tags, comme en REST. start_project_draft accepte execute_prompts_immediately. POST /collections et create_collection n’associent plus les prompts en cours de suppression. PATCH /project_drafts/{id} accepte un objet owned_media imbriqué et y refuse les champs inconnus.

  65. 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_audits listent les audits et en créent un par type d’audit, ponctuel, hebdomadaire ou mensuel (le rythme hebdomadaire ou mensuel est réservé à agent_readiness et robots_txt) ; GET, PATCH et DELETE /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}/runs listent 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 /findings renvoient le résultat complet et les constats contrôle par contrôle, GET /geo_audits/{id}/comparison compare deux exécutions, GET / PATCH /geo_audits/{geo_audit_id}/issues listent les problèmes et en acceptent ou rouvrent un (une acceptation devient caduque lorsque les éléments de preuve changent), et GET /geo_alerts liste les alertes déclenchées par les audits. Les audits récurrents actifs sont plafonnés selon le forfait : au-delà, la requête renvoie ERR_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_issue et list_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.

  66. 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/projects et l’outil MCP list_projects ne renvoient qu’eux, tout autre identifiant, domaine ou nom de projet renvoie ERR_PROJECT_NOT_FOUND, exactement comme un projet inexistant, et les abonnements webhook et les études ne listent que ceux de ces projets. GET /account et get_account_usage listent ces projets dans le nouveau champ api_key_project_ids. La création d’un projet et l’assistant de brouillon de projet renvoient le nouveau code ERR_KEY_PROJECT_SCOPED (403), et leurs outils MCP sont exclus de tools/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.

  67. 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_connection associe un domaine de boutique à un projet, PUT /ai_orders et GET /ai_orders enregistrent et relisent les commandes que les assistants d’IA ont apportées à la boutique, et GET / POST /catalog_prompt_suggestions, avec /accept et /reject, transforment les produits du catalogue en prompts d’acheteurs à suivre. L’outil MCP get_ai_orders lit les commandes enregistrées. POST /intelligence_tasks accepte aussi task_type=product_listing avec un objet product et renvoie un texte de fiche produit prêt à appliquer ; ce type n’existe que dans l’API. Les lignes de produits de GET /dimensions/shopping incluent désormais best_rank, models et last_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) et ERR_GENERATION_FAILED (502, réessayez la requête).

  68. 2026-10-03 (v1.53.0)

    Établissements locaux. Le nouvel endpoint GET /dimensions/local_businesses et l’outil MCP list_local_businesses listent 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 bloc totals. Tous deux acceptent les filtres de liste standard, owned, query, order et direction, et l’endpoint prend en charge output=flat et output=csv. Disponible sur tous les forfaits ; les membres de l’équipe ont besoin d’un accès en lecture à Établissements locaux.

  69. 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 leur url mais indiquent désormais google-entity.invalid comme domain et host au lieu de google.com, dans GET /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é) ».

  70. 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 /mcp effectuée avec une clé renvoie ERR_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é.

  71. 2026-09-29 (v1.52.0)

    Modification des fichiers des rapports llms.txt via l’API. PATCH /technical_geo_reports/:id/content remplace les fichiers llms.txt et llms-full.txt d’un rapport llms.txt terminé : envoyez report_type=llms_txt, un objet edits contenant le nouveau texte complet de llms_txt, de llms_full_txt ou des deux, et le dernier content_version que vous avez lu. Le détail du rapport renvoie désormais result_data.content_version. Un content_version obsolète ou absent, un fichier vide, un fichier de plus de 200 000 caractères ou un rapport non terminé renvoie ERR_INVALID_PARAM, et la réponse de mise à jour ajoute changed_files. La première modification conserve les fichiers générés dans original_llms_txt_content et original_llms_full_txt_content, et POST /technical_geo_reports/:id/revert_content les restaure. Deux outils MCP reprennent ces endpoints : update_technical_geo_report_content et revert_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.

  72. 2026-09-29 (v1.52.0)

    Langue de sortie automatique pour les rapports llms.txt. output_language_code sur POST /technical_geo_reports et create_technical_geo_report accepte aussi auto, qui conserve les fichiers llms.txt dans la langue du site web. La réponse de création reprend auto, puis le rapport renvoie output_language_code: null.

  73. 2026-09-28 (v1.51.1)

    Quota des rapports GEO techniques. POST /technical_geo_reports et create_technical_geo_report comptent 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.

  74. 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, de GET /metrics/summary et de la série over_time de GET /metrics/sov (TimeseriesPoint) portent une date calendaire comme 2026-09-01 (le premier jour de l’intervalle pour les granularités semaine et mois), et non un horodatage, et value vaut null pour 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, date est désormais un type date, par exemple LocalDate en Java et en Kotlin, DateOnly en C#, NaiveDate en Rust, date en 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_id et app_store_id sur GET /dimensions/projects/{id} ; matching_names, google_play_id, app_store_id et color sur GET /dimensions/competitors/{id} ; domain sur l’entrée du projet dans GET /metrics/timeseries, GET /metrics/summary et GET /metrics/sov, ainsi que sur la ligne de votre marque dans GET /dimensions/competitors, lorsque le projet n’a pas d’URL ; response, executed_at, success, duration_ms et fan_out_queries sur GET /answers/{id} ; result_data sur les tâches GEO Writer ; et last_delivered_at sur les abonnements webhook. duration_ms est 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 enveloppes Nullable*.

  75. 2026-09-28 (v1.50.1)

    Harmonisation de l’accès aux sentiments. GET /sentiments et GET /dimensions/sentiments exigent désormais un forfait Growth ou supérieur. Les outils MCP correspondants appliquent la même restriction Growth et renvoient ERR_PLAN_REQUIRED aux appels directs effectués avec un forfait inférieur.

  76. 2026-09-28 (v1.50.0)

    Configuration d’un projet en moins d’appels. POST /projects et l’outil MCP create_project acceptent collections, 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 ajoute collections et same_domain_projects (les projets du même domaine que vous voyez déjà ; la création n’est jamais bloquée). industry accepte 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/:id et update_project acceptent name. Les périodes de GET /metrics/sov ajoutent confidence et margin_of_error, ainsi qu’un sample de premier niveau. GET /account et get_account_usage ajoutent plan_name. MCP uniquement : get_sov accepte view=compact et list_prompts accepte fields.

  77. 2026-09

    Code « forfait requis » sur les outils MCP réservés à certains forfaits. Un appel tools/call direct à un outil que votre forfait n’inclut pas renvoie désormais code: "ERR_PLAN_REQUIRED" à côté de error, le même code que les endpoints REST renvoient pour une restriction de forfait. Le texte de error ne change pas.

  78. 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 filtre content_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, renvoie null pour brand_mentioned et competitor_mentioned au lieu de false, ainsi que content_gap_status: mentions_not_processed et page_cache.mentions_processed: false ; les nombres de mentions d’un groupe valent null lorsqu’aucune de ses pages n’a été analysée. La même règle s’applique à page_details dans GET /answers/{id}, à mention_filter sur GET /dimensions/sources et aux outils MCP correspondants. mentions_not_processed était déjà renvoyé avant cette version et est désormais documenté.

  79. 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ésormais app_url, le lien qui ouvre l’élément dans l’application. POST /technical_geo_reports renvoie app_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.

  80. 2026-09 (v1.47.0)

    Langue de sortie et modifications manuelles de llms.txt. POST /technical_geo_reports et l’outil MCP create_technical_geo_report acceptent output_language_code (ISO 639-1, langue du projet par défaut) pour le rapport llms.txt du lot. Les résumés de rapport exposent output_language_code, et le result_data d’un rapport llms.txt terminé ajoute manually_edited_at, original_llms_txt_content, original_llms_full_txt_content et metadata.output_language_code : lorsque les fichiers ont été modifiés dans l’application, llms_txt_content et llms_full_txt_content renvoient le texte modifié.

  81. 2026-09 (v1.46.0)

    Le paramètre filters de 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.

  82. 2026-09 (v1.45.0)

    Les filtres de modèle acceptent désormais naver_ai et baidu_ai pour les comptes qui ont activé ces options en libre-service.

  83. 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.

  84. 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.

  85. 2026-09

    Codes lisibles par machine dans les erreurs des outils MCP. Un tools/call en échec conserve isError: true, et son texte contient désormais code à côté de error chaque 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) et ERR_AI_TRAFFIC_NOT_CONNECTED / ERR_AGENT_TRAFFIC_NOT_CONNECTED. Le texte de error ne change pas.

  86. 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ésormais manually_edited_at, qui vaut null pour une tâche jamais modifiée et pour une tâche qui vient d’être rétablie. Pour vous y abonner, utilisez POST /webhooks comme pour tout autre événement ; GET /webhooks/sample/intelligence_task.updated renvoie des exemples de payloads. Les connecteurs Zapier, Make et n8n le proposent comme nouveau déclencheur.

  87. 2026-09

    Modification du texte généré par GEO Writer (v1.42.0). PATCH /intelligence_tasks/:id modifie sur place le texte d’une tâche terminée : envoyez un objet edits dont les clés sont des chemins en notation pointée dans result_data (par exemple sections.0.content ou title) et dont les valeurs sont le texte de remplacement. Seuls les champs texte qui existent déjà peuvent changer : un chemin introuvable, un title vide ou une valeur de plus de 20 000 caractères renvoie ERR_INVALID_PARAM. La première modification conserve une copie du texte généré, que POST /intelligence_tasks/:id/revert restaure. Les payloads des tâches comportent désormais manually_edited_at (liste et détail) et edited_by_user_id (détail), et la réponse de mise à jour ajoute changed_paths. Deux outils MCP reprennent ces endpoints : update_intelligence_task_content et revert_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.

  88. 2026-09

    Filtres de prompts sur la part de mentions par domaine citant (v1.42.0). GET /citation_intelligence/mentions_by_domain et l’outil MCP get_mentions_by_citing_domain acceptent désormais brand_kind (brand, brand_other ou non_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 avec ERR_INVALID_PARAM ; l’outil MCP renvoie une erreur de validation.

  89. 2026-09

    Deux corrections Search Console (v1.41.0). Une dimension inconnue renvoie désormais ERR_INVALID_PARAM au lieu d’être ignorée sans avertissement, et les valeurs de répartition page et query conservent la casse renvoyée par Google au lieu d’être converties en minuscules, car l’URL d’une page est sensible à la casse.

  90. 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) et data_state (final par défaut, ou all pour inclure les jours les plus récents, encore incomplets). GET /search_console/summary propose désormais une répartition par page, query et searchAppearance en plus de country et device, plafonnée par limit (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.

  91. 2026-09

    Corrections des plages de dates et de l’agrégation (v1.40.0). Un to sans heure (par exemple to=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. Sur GET /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.

  92. 2026-09

    Devise sur les lignes Shopping. GET /dimensions/shopping avec view=merchants renvoie désormais un champ currency qui indique la devise dans laquelle sont exprimés min_price, max_price et avg_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 vaut null lorsqu’aucun prix ne portait une devise que nous avons pu identifier. Avec view=products, currency indique désormais la devise de max_price, et un nouveau champ currency_count précise dans combien de devises ce produit était proposé : au-delà de 1, la ligne présente son offre la plus chère et min_price peut être dans une autre devise. totals.avg_price est désormais calculé dans une seule devise au lieu d’une moyenne entre devises, et totals.avg_price_currency indique laquelle. Aucun nouvel endpoint ni code d’erreur.

  93. 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.message les reprennent désormais aussi dans error.message. error.meta reste inchangé. Les erreurs sans détails utilisent toujours les identifiants de message par défaut, comme missing_authorization. Fondez votre logique sur error.code, jamais sur le texte du message. GET /answers rejette désormais avec 422 ERR_INVALID_PARAM une valeur model que le compte ne suit pas, au lieu d’ignorer le filtre. Les descriptions de ERR_LIMIT_REACHED et ERR_QUOTA_EXCEEDED listent désormais toutes les limites couvertes par chacun.

  94. 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 de 401 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/:id et POST /project_drafts/:id/finalize documentent désormais la réponse 403 ERR_INSUFFICIENT_SCOPE que reçoit une clé en lecture seule, comme les autres opérations d’écriture.

  95. 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/* renvoient ERR_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 renvoient ERR_SEARCH_CONSOLE_UPSTREAM (503) lorsque Google Search Console est indisponible ou que son quota est dépassé ; attendez le nombre de secondes indiqué dans Retry-After avant de réessayer. Les outils MCP signalent ces situations sous forme d’erreurs d’outil. L’en-tête de réponse X-Search-Console-Backend indique une lecture stored (données stockées) ou live (en direct). Les lectures stockées utilisent les données synchronisées sans contacter Google. Pour les requêtes et les pages, total compte 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 incluent truncated: true lorsque cette limite est atteinte. Le tri et la pagination s’appliquent à l’ensemble disponible.

  96. 2026-09

    Correspondance des URL citées par concurrent (v1.36.0). POST /competitors et PATCH /competitors/:id acceptent désormais le champ facultatif citation_match_mode, avec la valeur domain, host ou path_prefix. citation_match_path est obligatoire avec path_prefix. PATCH /competitors/:id peut aussi modifier domain, 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.

  97. 2026-08 (fin de mois)

    Référence publique de l’API découpée en une page par ressource. https://llmpulse.ai/api-docs couvre 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/oauth et 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.txt indique 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é.

  98. 2026-08 (fin de mois)

    Énumérations du profil de projet mises à jour (v1.35.0). business_model dé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 sont B2B_SAAS, B2C_SUBSCRIPTION, ECOMMERCE, RETAIL, MARKETPLACE, LEAD_GENERATION, SERVICES, ENTERPRISE_SOFTWARE, MEDIA_ADVERTISING, EDUCATION_TRAINING, NONPROFIT_PUBLIC et OTHER. Les clés retirées (B2B_CLOUD_SERVICES, B2C_SMART_HOME, B2C_STREAMING, B2C_GAMING) sont converties vers leur valeur actuelle la plus proche sur POST /projects et PATCH /projects/:id au lieu d’être rejetées, pour que les intégrations existantes continuent de fonctionner ; les clés réellement inconnues renvoient toujours ERR_INVALID_PARAM. industry accepte désormais 34 clés au lieu de 19, avec de nouveaux secteurs qui devaient jusqu’ici se rabattre sur OTHER. 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_other fait désormais partie de l’API : envoyez-le avec business_model: OTHER sur POST /projects ou PATCH /projects/:id (et les outils MCP create_project / update_project) et il est renvoyé dans le payload du projet. Envoyé avec une autre clé, il est refusé avec ERR_INVALID_PARAM, et il est effacé automatiquement lorsque le modèle économique n’est plus OTHER.

  99. 2026-08 (fin de mois)

    Filtres d’analyse à valeurs multiples (v1.34.0). collection_id, country_code, language_code et prompt_type acceptent 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 /sentiments accepte aussi plusieurs valeurs analysis. 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.

  100. 2026-08 (fin de mois)

    Récupération des rapports GEO techniques (v1.33.0). GET /technical_geo_reports liste les rapports par project_id et report_type, tandis que GET /technical_geo_reports/:id renvoie le statut actuel et, une fois le rapport terminé, l’intégralité de result_data. Les nouveaux outils MCP list_technical_geo_reports et get_technical_geo_report offrent le même accès, et create_technical_geo_report renvoie 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.

  101. 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 de GET /answers et GET /answers/:id comportent désormais un booléen no_result, et GET /answers (ainsi que l’outil MCP list_answers) accepte un filtre facultatif no_result : false = uniquement les vraies réponses (recommandé pour calculer vos propres métriques), true = uniquement les sentinelles, omis = les deux (format historique inchangé).

  102. 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/:id met à 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_products et matching_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 renvoie ERR_INVALID_PARAM. Modifier matching_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 de brand_name ne s’applique qu’aux exécutions futures. POST /api/v1/projects (et l’outil MCP create_project) accepte désormais business_model, target_audience, brand_voice, goals et primary_products dès la création. L’outil MCP existant update_project et 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.

  103. 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) et status (discussions Reddit) sont bien transmis à la requête au lieu d’être écartés : store=app_store et status=archived ne renvoient plus de lignes non filtrées. owned=true s’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’indicateur yours que toutes les autres plateformes renvoyaient déjà. Sur cette même plateforme, total correspond 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=desc s’applique désormais aux tris textuels de GET /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ètre view propre à un endpoint peut enfin être combiné avec output=flat ou output=csv (par exemple ?view=merchants&output=csv), alors que cela renvoyait ERR_INVALID_PARAM, et les réponses flat reprennent view, provider et store. GET /account indique 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 bloc subscription est 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.

  104. 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/shopping et GET /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) et GET /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/:id et GET /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 charge output=flat et output=csv.

  105. 2026-08

    Query Fan Out dans l’API et le MCP (v1.28.0). Le nouvel endpoint GET /api/v1/dimensions/query_fan_outs expose 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=prompt renvoie 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 que query (recherche de sous-chaîne), order, direction et output pour le format flat ou CSV ; une valeur de order qui ne correspond pas à la vue choisie renvoie ERR_INVALID_PARAM. L’outil MCP correspondant est list_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 des from/to explicites. Comme la page de l’application, l’API et le MCP dépendent de l’autorisation Query Fan Out des membres de l’équipe.

  106. 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/account renvoie 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é renvoie limit et remaining à null, avec unlimited: 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 est get_account_usage, disponible sur tous les forfaits. Chaque réponse /api/v1 comporte désormais X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset (la réponse 429 ERR_RATE_LIMITED les inclut en plus de Retry-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 ressource llmpulse://glossary qui 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é.

  107. 2026-08

    La préparation aux agents d’IA rejoint le lot GEO technique (v1.26.0). POST /technical_geo_reports crée désormais aussi un rapport agent_readiness qui évalue dans quelle mesure le domaine est prêt pour les agents d’IA : created_reports et report_ids incluent donc la nouvelle clé agent_readiness (9 rapports par exécution au lieu de 8). L’outil MCP create_technical_geo_report crée le même lot. Les clés existantes et les structures de réponse sont inchangées.

  108. 2026-08

    Suivi hebdomadaire de Grok et DeepSeek. Les valeurs grok et deepseek du filtre model renvoient 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 volontairement citations: 0 et 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.

  109. 2026-08

    Carte serveur MCP publique. Le nouvel endpoint GET /api/v1/mcp/server-card renvoie 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édia application/mcp-server-card+json et 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.

  110. 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 machine llms.txt et 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 /projects et l’assistant /project_drafts, jusqu’ici absents de llms.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é.

  111. 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_rufus dans le filtre model et dans chaque réponse, et l’historique des données n’est pas modifié. Aucune action requise.

  112. 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.

  113. 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 /annotations et par l’outil MCP list_annotations incluent origin : manual, automation, geo_test ou platform. 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.

  114. 2026-08

    Share of Voice : taille d’échantillon et regroupement par modèle (v1.22.0). GET /metrics/sov renvoie désormais un tableau periods qui indique, pour chaque intervalle, le total de mentions sur 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 indicateur partial qui signale les intervalles encore en cours de collecte ou tronqués par la fenêtre demandée. Chaque ligne current contient aussi des écarts précalculés : previous_share (dernier intervalle complet) et avg_share (moyenne des intervalles complets avec données, intervalles partiels exclus). Les champs existants sont inchangés. L’outil MCP get_sov gagne group_by=model, qui renvoie par appel une comparaison compacte des parts par modèle (ajoutez include_series=true pour les séries d’évolution par modèle). Chaque outil MCP lié à un projet accepte désormais dans project_id le 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 lien app_url vers 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).

  115. 2026-07 (fin de mois)

    Correction de la réponse à la création de projet (v1.21.1). POST /projects et POST /project_drafts/:id/finalize renvoient désormais competitors.processing: false, car la configuration des concurrents se termine dans la transaction du projet. Les réponses précédentes indiquaient à tort true. Une URL de site web de projet renvoie désormais ERR_INVALID_PARAM si 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 (famille ERR_INVALID_PARAM) au lieu de ERR_PROJECT_NOT_FOUND.

  116. 2026-07 (fin de mois)

    Filtres de mentions et de citations (v1.21.0). GET /answers, GET /dimensions/prompt_executions et GET /dimensions/sources acceptent mention_filter et (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 sont mentions_you, not_mentions_you, mentions_competitor, not_mentions_competitor, you_and_competitor, competitor_not_you, you_not_competitor et no_brands (aucune marque suivie n’apparaît), avec les variantes de citation cites_you, not_cites_you, cites_competitor, not_cites_competitor et cites_no_brands. Associez l’un ou l’autre filtre à competitors pour 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 renvoient ERR_INVALID_PARAM. Les mêmes arguments sont disponibles dans les outils MCP list_answers, list_prompt_executions et list_sources.

  117. 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=flat renvoie les mêmes métadonnées ainsi que des columns et rows rectangulaires, et output=csv renvoie ces lignes au format text/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/sov accepte aussi view=over_time|current|breakdown. Sans output, 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êtes X-Total-Count, X-Page et X-Per-Page, et la sortie tabulaire est plafonnée à 200 000 lignes.

  118. 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.

  119. 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 (MCP launch_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/:id et 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é API read_write et respectent la matrice d’autorisations des membres de l’équipe.

  120. 2026-07

    Amélioration de la qualité du MCP (à la suite de l’audit d’un agent externe). Les valeurs de model inconnues et les fenêtres from/to inversées renvoient désormais ERR_INVALID_PARAM au lieu d’être ignorées sans avertissement. GET /metrics/agent_traffic renvoie le nouveau code ERR_AGENT_TRAFFIC_NOT_CONNECTED lorsqu’aucune source de trafic des agents n’est connectée. Dans GET /metrics/top_sources, avg_visibility correspond désormais au pourcentage de réponses qui citent le domaine (entre 0 et 100). Les champs duration_ms sont désormais réellement exprimés en millisecondes. Champs ajoutés : url_sha256 + created_at sur les lignes de sources, matching_names sur les lignes de la liste des concurrents, score sur les catégories de sentiment, created_at sur les annotations créées, data_through sur les réponses Search Console (GSC publie ses données avec 2 à 3 jours de décalage). Outils MCP : les outils de liste acceptent range, list_answers tronque par défaut les réponses à 1 500 caractères (full_text=true pour davantage), la vue par URL de list_citation_groups reste compacte sauf avec include_page_details=true, les outils d’URL citées acceptent une url brute en alternative à url_sha256, get_sov inclut par défaut tous les concurrents configurés, list_prompts gagne un paramètre de recherche query, et les erreurs de type « introuvable » reprennent l’identifiant demandé.

  121. 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).

  122. 2026-07 (fin de mois)

    Visibilité corrigée pour les sources les plus citées. Dans GET /metrics/top_sources, avg_visibility (et son alias avg_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_responses est inchangé.

  123. 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 filtre model des endpoints de métriques, de dimensions, de réponses et de sentiments accepte amazon_rufus. Comme pour les autres modèles en option, les données n’apparaissent que pour les comptes où le modèle est activé.

  124. 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_drafts lance un brouillon et suggère un nom, une description et un secteur d’activité pour l’URL, PATCH /project_drafts/:id envoie chaque étape (détails, prompts, concurrents, médias propriétaires) avec une progression strictement séquentielle et renvoie des suggestions pour l’étape suivante, GET lit l’état (suggestions servies uniquement depuis le cache, pour un polling sans risque) et POST .../finalize crée le projet avec exactement les mêmes effets que le mode rapide, de façon idempotente. Nouveaux codes d’erreur ERR_DRAFT_NOT_FOUND et ERR_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_draft et finalize_project_draft, qui utilisent exactement les mêmes services que l’API REST.

  125. 2026-07 (fin de mois)

    API de création de projet (v1.16.0). Le nouvel endpoint POST /projects cré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 via external_identifier (comptes avec l’intégration iframe activée) renvoient le projet existant avec idempotent: true. L’option execute_prompts_immediately: false reporte 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).

  126. 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_brand pour 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 filtres brand_kind et prompt_type sont ajoutés aux trois endpoints GET /reports/ai_model_insights/* et à leurs outils MCP (get_ai_model_summary, get_ai_model_position_distribution, get_ai_overview_results) ; les valeurs invalides renvoient ERR_INVALID_PARAM. GET /dimensions/projects/:id (et l’outil MCP get_project_details) incluent désormais stats.prompts_by_brand_kind ainsi qu’un bloc data_coverage qui 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.

  127. 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_position et 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.

  128. 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.

  129. 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.

  130. 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_kind sur get_prompt_summary, get_top_sources et les outils de liste, ainsi que source_type sur list_sources (dont les lignes incluent désormais source_type et des indicateurs de liens vers les boutiques d’applications, comme en REST). La validation des entrées MCP s’aligne sur REST : les identifiants collection_id / prompt inconnus, 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 de list_prompts incluent désormais collection_ids, et les lignes de résumé REST incluent le champ metric que 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 avec 0.0.

  131. 2026-07

    Établissements locaux dans le détail des réponses. GET /answers/:id (et l’outil MCP get_answer) incluent désormais un tableau local_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 via is_owned / competitor_id.

  132. 2026-07

    Corrections de bugs. Les outils MCP get_timeseries et get_summary renvoient désormais de vraies valeurs pour net_sentiment, les cinq ventilations sentiment_* et avg_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_mentions et GET /dimensions/all_citations effectuent désormais la pagination dans la base de données, avec un ordre déterministe en cas d’égalité sur created_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).

  133. 2026-06 (fin de mois)

    API Trafic IA (Scale+). Le nouvel endpoint GET /metrics/ai_traffic expose 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 code ERR_AI_TRAFFIC_NOT_CONNECTED (404).

  134. 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 par country/device), GET /search_console/timeseries (séries par jour, semaine ou mois), GET /search_console/queries et GET /search_console/pages (principales requêtes et pages classées par impressions, clics, CTR ou position, avec pagination). ctr est une fraction comprise entre 0 et 1 et position la 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 code ERR_SEARCH_CONSOLE_NOT_CONNECTED (404).

  135. 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 MCP get_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_sources et GET /citation_intelligence/groups (et leurs outils MCP) acceptent désormais un tableau domains (liste blanche de domaines exacts) et un tableau collection_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.

  136. 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+).

  137. 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 champ total correspond 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 champ aggregation ("sum" ou "average") qui indique comment total a été calculé. La même correction s’applique à l’outil MCP get_summary, qui ne renvoie plus la series complète avec le résumé (appelez get_timeseries pour les séries) et accepte un nouvel argument group_by (model ou collection) qui renvoie un résumé par groupe en un seul appel. GET /answers (et l’outil MCP list_answers) acceptent un nouveau paramètre query pour la recherche plein texte, insensible à la casse, dans le texte des réponses de l’IA : total devient le nombre exact de correspondances et les lignes contiennent un snippet et un match_count au lieu du texte complet de la réponse.

  138. 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 /prompts et l’outil MCP create_prompts renvoient 403 ERR_INSUFFICIENT_SCOPE pour 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 /prompts et create_prompts renvoient ERR_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.

  139. 2026-06 (fin de mois)

    Nouvel outil MCP get_webhook_sample (Scale+), l’équivalent MCP de GET /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 REST GET /dimensions/agent_bots est désormais réservé aux forfaits à partir de Scale (ERR_PLAN_REQUIRED en dessous), tandis que l’outil MCP list_agent_bots devient disponible sur tous les forfaits.

  140. 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 scope read_write. Nouveaux outils MCP : create_webhook_subscription, list_webhook_subscriptions, delete_webhook_subscription. Les webhooks alimentent les nouveaux connecteurs Zapier, Make et n8n.

  141. 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.

  142. 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’URL https://api.llmpulse.ai/api/v1/mcp dans 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 de tools/list pour 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/*.

  143. 2026-05 (fin de mois)

    Nouveau type de recommandation : Sentiment et réputation (Scale+). recommendation_type sur GET /recommendations (et l’outil MCP launch_recommendations) accepte désormais sentiment_reputation en plus de ai_visibility, social_community et brand_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çoivent ERR_INVALID_PARAM ou une erreur de forfait.

  144. 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 par brand_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_sources et /dimensions/prompts (qui renvoie aussi désormais ces deux champs pour chaque prompt). Les valeurs non valides renvoient ERR_INVALID_PARAM. Les mêmes filtres sont disponibles via les arguments prompt_type / brand_kind des outils MCP get_timeseries, get_summary, get_sov et list_prompts.

  145. 2026-05 (mi-mois)

    Endpoints d’écriture pour agents (v1.5). Les clés API exposent désormais un scope (read ou read_write) ; pour les clés existantes, full est traité comme synonyme de read_write. Les endpoints de modification (POST/PATCH/PUT/DELETE) exigent désormais une clé de scope read_write et renvoient sinon 403 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.

  146. 2026-05

    Les projets exposent désormais brand_name séparément de name dans les payloads de l’API et du MCP. brand_name est le libellé de marque envoyé aux LLM et affiché dans les graphiques destinés aux clients ; name reste le libellé interne du projet. name est toujours renvoyé pour la rétrocompatibilité. mention_rate est accepté comme synonyme de visibility dans 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 fuseau Europe/Madrid pour les regroupements quotidiens, hebdomadaires et mensuels, ce qui corrige les lignes décalées d’un jour autour de minuit UTC.

  147. 2026-04 (fin de mois)

    API Agent Analytics (Scale+, bêta) : GET /metrics/agent_traffic et GET /dimensions/agent_bots exposent 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. Le tools/list du 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 proprement ERR_PLAN_REQUIRED au 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.

  148. 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, /occurrences et /content pour le détail par URL. API des rapports d’analyse des modèles d’IA : GET /reports/ai_model_insights/summary, /position_distribution et /ai_overview_results. API Recommandations : GET /recommendations et GET /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 pour view, order, direction, granularity, model, source_type, sentiment, content_gap, recommendation_type et status : les valeurs inconnues renvoient désormais ERR_INVALID_PARAM au lieu d’être ignorées sans avertissement. Le filtre source_type accepte owned, competitor et third_party en plus des listes de classification. Les résultats Google AI Overviews sont regroupés par executed_at (et non par created_at), si bien que les lignes relancées ou rattrapées sont rattachées au bon jour.

  149. 2026-04

    Nouvel endpoint POST /prompts pour créer des prompts en masse (jusqu’à 100 par requête). Nouvelle API Content Intelligence : POST /intelligence_tasks pour créer des tâches, GET /intelligence_tasks pour les lister avec des filtres, GET /intelligence_tasks/:id pour 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).

  150. 2026-03

    Nouvel endpoint GET /metrics/prompt_summary pour obtenir en une seule requête les métriques paginées par prompt (réponses, mentions, citations, taux de mention, taux de citation)

  151. 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étrique responses (nombre d’exécutions de prompts) et de la métrique citation_rate (citations / réponses x 100). Limite de requêtes de l’API relevée de 100 à 300 requêtes par minute. Ajout du filtre prompt à tous les endpoints de métriques et de dimensions.

  152. 2026-01

    Ajout de l’endpoint MCP (Model Context Protocol) pour les intégrations IA avec Claude, ChatGPT et d’autres assistants IA

  153. 2025-12

    Ajout des métriques de sentiment à /metrics/timeseries (sentiment_very_positive/positive/neutral/negative/very_negative) et documentation de leur sémantique

  154. 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 query dans Top Sources, notes sur le cache, téléchargement Postman et section sur les environnements

  155. 2025-08

    Première documentation publique de l’API (v1)