--- title: API d'analytique url: https://platform.claude.com/docs/fr/manage-claude/analytics-api description: Comprenez quelle API d'analytique et quelle clé API votre organisation doit utiliser, puis provisionnez l'accès aux métriques de productivité Claude Code ou aux données d'engagement et d'adoption Claude Enterprise. --- Anthropic fournit deux API d’analytique produit, et celle que vous utilisez dépend du produit Claude que votre organisation gère : * La **Claude Code Analytics API** fournit des métriques quotidiennes de productivité Claude Code pour les organisations qui utilisent la Claude Platform. Elle fait partie de l’[Admin API](https://platform.claude.com/docs/fr/manage-claude/admin-api) et utilise une clé Admin API. * La **Claude Enterprise Analytics API** fournit des données d’engagement, d’adoption et de coût à l’échelle de l’organisation pour l’ensemble des produits Claude (chat, projets, Claude Code, et plus encore) pour les organisations Claude Enterprise. Elle utilise une clé Analytics API créée dans claude.ai. Les deux API utilisent des types de clés différents, créés à des endroits différents par des rôles différents. Cette page décrit quelle API convient à votre organisation et comment créer la bonne clé. ## De quelle API avez-vous besoin ? | API | Type de clé | Créée dans | Qui peut la créer | Ce qu’elle couvre | | ----------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **API Claude Code Analytics** | Clé Admin API (`sk-ant-admin01-...`) | Page [Clés d’administration](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) dans la Claude Console | Administrateur de l’organisation | Métriques Claude Code quotidiennes par utilisateur : sessions, lignes de code, commits, pull requests, acceptation des outils et coût estimé par modèle | | **API Claude Enterprise Analytics** | Clé Analytics API | [claude.ai > Paramètres de l’organisation > API](https://claude.ai/admin-settings/api-access) | Propriétaire principal | Engagement et adoption à l’échelle de l’organisation (activité des utilisateurs, synthèses des utilisateurs actifs, utilisation des projets, des skills et des connecteurs), ainsi que des rapports de coût et d’utilisation | Les types de clés ne sont pas interchangeables : une clé Admin API ne peut pas appeler la Claude Enterprise Analytics API, et une clé Analytics API ne peut pas appeler l’Admin API. La seule exception est l’[API Usage and Cost Analytics](https://platform.claude.com/docs/fr/manage-claude/usage-cost-analytics-api), que les organisations Claude Enterprise appellent avec leur clé Analytics API. Les deux API d’analytique produit apparaissent dans la [référence de l’Admin API](https://platform.claude.com/docs/fr/api/beta/organization), mais ce sont des API distinctes avec des types de clés distincts. Si votre organisation utilise à la fois la Claude Platform et Claude Enterprise, vous pouvez provisionner les deux clés et utiliser chaque API pour ses propres données. Vous recherchez des données d’utilisation des tokens et de coût plutôt que des analyses de produit ? Consultez l’[API Usage and Cost Analytics](https://platform.claude.com/docs/fr/manage-claude/usage-cost-analytics-api), qui s’adresse à la fois aux organisations Claude Console et Claude Enterprise. Si vous souhaitez consulter les données d’engagement et d’adoption dans le produit plutôt que par programmation, utilisez le [tableau de bord Analytics](https://claude.ai/analytics/activity) dans claude.ai. Pour les cas d’usage de gouvernance et d’audit (actions individuelles des utilisateurs, événements d’activité bruts, contenu des conversations), consultez la [Compliance API](https://platform.claude.com/docs/fr/manage-claude/compliance-api-access). ## Obtenir l’accès à la Claude Code Analytics API La Claude Code Analytics API est disponible pour toute organisation ayant accès à l’[Admin API](https://platform.claude.com/docs/fr/manage-claude/admin-api), et son utilisation est gratuite. Suivez les étapes décrites dans [Créer une clé Admin API](https://platform.claude.com/docs/fr/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization). Transmettez la clé dans l’en-tête `x-api-key` : ```bash curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08" \ -H "anthropic-version: 2026-10-21" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Pour les métriques disponibles, les paramètres de requête et le schéma de réponse, consultez le guide de l’[API Claude Code Analytics](https://platform.claude.com/docs/fr/manage-claude/claude-code-analytics-api) et la [référence de l’API](https://platform.claude.com/docs/fr/api/beta/organization/usage_report/retrieve_claude_code). ## Obtenir l’accès à la Claude Enterprise Analytics API La Claude Enterprise Analytics API est disponible pour les organisations Claude Enterprise. Les données d’engagement et d’adoption sont disponibles sur tous les forfaits Enterprise. Les points de terminaison de coût et d’utilisation s’appliquent aux forfaits Enterprise basés sur l’utilisation ; pour les forfaits Enterprise basés sur les sièges, ils reflètent uniquement les crédits d’utilisation. Seul le propriétaire principal de l’organisation peut activer l’accès à l’API et créer des clés Analytics API. Accédez à [claude.ai > Paramètres de l’organisation > API](https://claude.ai/admin-settings/api-access) et activez l’accès public à l’API, puis créez une clé Analytics API. Les clés portent la portée `read:analytics`. Copiez le secret affiché et stockez-le dans votre gestionnaire de secrets. Transmettez la clé dans l’en-tête `x-api-key` et incluez l’en-tête [`anthropic-version`](https://platform.claude.com/docs/fr/api/versioning) dans chaque requête. Les points de terminaison se trouvent sous `https://api.anthropic.com/v1/organizations/analytics/`. Pour des exemples de requêtes, les paramètres et les schémas de réponse, consultez la [référence de la Claude Enterprise Analytics API](https://platform.claude.com/docs/fr/api/beta/organization/analytics). La Claude Enterprise Analytics API fournit : * **Activité des utilisateurs :** métriques quotidiennes par utilisateur pour le chat (conversations, messages, projets, fichiers, artifacts), Claude Code (sessions, commits, pull requests, lignes de code, actions d’outils), Chat and Cowork unified (activité de chat et sessions Cowork) et d’autres produits Claude * **Synthèses d’activité :** utilisateurs actifs quotidiens, hebdomadaires et mensuels au niveau de l’organisation, nombre de sièges et invitations en attente * **Utilisation des projets, des skills et des connecteurs :** répartitions de l’adoption pour les projets de chat, les skills et les connecteurs * **Rapports de coûts et d’utilisation :** utilisation des tokens et coûts par utilisateur et au niveau de l’organisation au fil du temps (forfaits Enterprise basés sur l’utilisation). Les points de terminaison des rapports de coûts et d’utilisation sous `/v1/organizations/analytics/` (`usage_report`, `cost_report`, `user_usage_report` et `user_cost_report`) sont hérités et restent pris en charge. Pour les nouvelles intégrations, utilisez l’[API Usage and Cost Analytics](https://platform.claude.com/docs/fr/manage-claude/usage-cost-analytics-api). Pour migrer une intégration existante, consultez [Migrer depuis les rapports de coûts et d’utilisation de Claude Enterprise](https://platform.claude.com/docs/fr/manage-claude/usage-cost-analytics-api#migrate-from-enterprise-analytics-reports). Les autres points de terminaison de l’API Claude Enterprise Analytics ne sont pas hérités. Pour le détail des points de terminaison, les paramètres et les schémas de réponse, consultez la [référence de la Claude Enterprise Analytics API](https://platform.claude.com/docs/fr/api/beta/organization/analytics). Les sections suivantes traitent de la fraîcheur des données, des définitions des métriques et des recommandations opérationnelles qui s’appliquent à l’ensemble de ces points de terminaison. ## Disponibilité et fraîcheur des données Les données de la Claude Enterprise Analytics API sont disponibles pour les dates à partir du 1er janvier 2026. **Les points de terminaison d’engagement et d’adoption** (activité des utilisateurs, résumés, projets, skills, connecteurs) renvoient un instantané par jour pour la date que vous spécifiez. Les données d’un jour donné sont généralement disponibles vers 13 h 00–13 h 30 UTC le jour suivant (un décalage d’un jour). D’ici là, le jour disponible le plus récent est généralement 2 jours avant la date UTC actuelle. Les données arrivent plus tard les jours où un pipeline de données en amont prend du retard, et la fraîcheur exacte varie selon la requête. Plutôt que de supposer une heure fixe, vérifiez donc la réponse d’erreur : demander une date qui n’est pas encore disponible renvoie une erreur 400 indiquant le jour disponible le plus récent. Si les données ne sont pas disponibles bien au-delà du décalage habituel, cela indique généralement une défaillance du pipeline de données du côté d’Anthropic ; contactez le support si l’écart persiste. **Les points de terminaison de coûts et d’utilisation** suivent un modèle de fraîcheur différent. Les données sont généralement disponibles dans les 4 heures suivant l’utilisation sous-jacente, mais peuvent prendre jusqu’à 24 heures. Les valeurs peuvent être révisées à mesure que des événements tardifs arrivent et que des rapprochements sont effectués, jusqu’à environ 7 jours après la fin du mois civil. Par exemple, les valeurs du 1er octobre peuvent changer jusqu’à environ le 7 novembre. Pour des totaux de qualité facturation, interrogez uniquement les mois terminés depuis au moins 7 jours. Les réponses de coût et d’utilisation incluent un horodatage `data_refreshed_at`. Si vous omettez `ending_at`, sa valeur par défaut est 31 jours après `starting_at` ou l’heure actuelle, selon ce qui est le plus tôt. Cette plage peut s’étendre au-delà de `data_refreshed_at`, et les données postérieures à ce moment sont incomplètes. Pour obtenir des résultats stables entre des appels répétés, définissez `ending_at` sur une valeur égale ou antérieure à un `data_refreshed_at` précédemment renvoyé. ## Comment les métriques sont définies **Utilisateurs actifs.** Un utilisateur est considéré comme actif pour un jour si l’une des conditions suivantes est remplie : * Il a envoyé au moins un message de chat dans Claude. * Il a eu au moins une session Claude Code (locale ou distante) associée à votre organisation Claude Enterprise comprenant une utilisation d’outils ou une activité git. * Il a eu au moins une session Cowork comprenant une utilisation d’outils ou une activité de messages. **Chat and Cowork unified.** Chat and Cowork unified intègre les fonctionnalités de Cowork dans le chat de claude.ai. La majeure partie de l’activité dans Chat and Cowork unified est signalée sous la valeur de produit `chat_cowork_unified`, et non sous `chat` ou `cowork`. Dans l’activité des utilisateurs et dans l’utilisation des skills, des connecteurs et des plugins, cette utilisation apparaît dans l’objet `chat_cowork_unified_metrics`. Dans les synthèses d’activité, elle est comptabilisée dans `chat_cowork_unified_daily_active_user_count`, `chat_cowork_unified_weekly_active_user_count` et `chat_cowork_unified_monthly_active_user_count`. Lorsqu’un utilisateur commence à utiliser Chat and Cowork unified, son utilisation quitte vos chiffres de chat et de Cowork pour rejoindre les chiffres de Chat and Cowork unified. L’utilisation des jours précédant le moment où un utilisateur commence à utiliser Chat and Cowork unified reste comptabilisée sous chat ou Cowork. Les chiffres à l’échelle de l’organisation, tels que l’utilisation totale des tokens, le coût total et le nombre global d’utilisateurs actifs, ne changent pas. Les rapports de coût et d’utilisation filtrés par produit excluent l’utilisation de Chat and Cowork unified, sauf si `products[]` inclut `chat_cowork_unified`. Une partie de l’activité des utilisateurs de Chat and Cowork unified, comme le mode vocal, peut encore être comptabilisée sous chat ou Cowork. L’activité d’un utilisateur peut également être répartie entre plusieurs produits le jour où il commence à utiliser Chat and Cowork unified. Il en va de même le jour où cette fonctionnalité est désactivée pour lui. La manière dont l’activité est répartie n’est pas garantie. Un utilisateur peut apparaître à la fois dans les décomptes de chat ou de Cowork et dans les décomptes de Chat and Cowork unified. Cela peut se produire un jour où il utilise Chat and Cowork unified et où une partie de son activité est encore signalée sous chat ou Cowork. Les décomptes hebdomadaires et mensuels peuvent l’inclure dans les deux lorsque la fenêtre comporte une activité des deux types, même à des jours différents. Par exemple, la fenêtre peut couvrir des jours avant et après le moment où il a commencé à utiliser Chat and Cowork unified. Lorsque vous filtrez l’activité des utilisateurs par projet, l’activité de projet de chaque jour n’est comptabilisée qu’à un seul endroit. Si un utilisateur a envoyé un message de chat dans Chat and Cowork unified ce jour-là, toute son activité de projet est comptabilisée dans `chat_cowork_unified_metrics.chat`. Sinon, elle est comptabilisée dans `chat_metrics`. **Blocs de métriques par produit.** Les objets de métriques par produit (par exemple, les métriques Office Agent ou Cowork dans un enregistrement d’activité utilisateur) sont toujours présents dans chaque enregistrement. Les organisations qui n’utilisent pas ce produit voient des décomptes à zéro plutôt qu’un objet `null`. Chat and Cowork unified fait exception : sur les déploiements qui ne le proposent pas, ses champs sont omis de la réponse. Les champs individuels à l’intérieur de ces objets peuvent être `null`, ce qui signifie que la valeur n’est pas disponible. Par exemple, lorsque vous filtrez l’activité des utilisateurs par projet, `distinct_skills_used_count` dans `chat_metrics` est `null`. La [référence de la Claude Enterprise Analytics API](https://platform.claude.com/docs/fr/api/beta/organization/analytics) indique quels champs peuvent être `null`. **Noms des connecteurs.** Les noms des connecteurs sont normalisés entre les sources. Par exemple, `Atlassian MCP server`, `mcp-atlassian` et `atlassian_MCP` apparaissent tous sous la forme `atlassian` dans le point de terminaison d’utilisation des connecteurs. ## Travailler avec l’API **Les curseurs de pagination sont liés à la requête qui les a émis.** Sur les points de terminaison de coût et d’utilisation, ne modifiez pas les paramètres de requête en cours de séquence : si vous modifiez `products[]`, `group_by[]`, `order_by`, la plage de dates ou tout filtre et que vous transmettez un ancien curseur, la requête renvoie une erreur 400. Pour modifier les paramètres, recommencez depuis la première page sans curseur. **Les paramètres de liste utilisent la notation entre crochets.** Répétez le paramètre pour chaque valeur, par exemple `products[]=chat&products[]=claude_code`. **Les champs de montant sont des chaînes décimales en cents.** Les montants en devise sont renvoyés sous forme de chaînes décimales telles que `"41280.000000"` (qui représente 412,80 $ USD). Pour convertir en dollars, analysez la valeur comme un nombre décimal et divisez-la par 100. Évitez l’analyse en virgule flottante binaire pour les valeurs susceptibles de dépasser plusieurs millions de dollars. **Les « rate limits » (limites de débit) s’appliquent au niveau de l’organisation**, et non pour chaque clé, avec une valeur par défaut de 60 requêtes par minute pour l’ensemble des points de terminaison de cette API. Si cela ne suffit pas pour votre cas d’usage, contactez l’équipe chargée de votre compte Anthropic pour discuter d’un ajustement de la limite. ## Gestion des versions Envoyez l’en-tête `anthropic-version` dans chaque requête ; consultez [Versions](https://platform.claude.com/docs/fr/api/versioning) pour connaître les versions disponibles. ## Limitations connues ### Claude Code via Amazon Bedrock Si votre organisation utilise Claude Code via Amazon Bedrock, la Claude Enterprise Analytics API ne renvoie pas l’activité Claude Code correspondant à cette utilisation. ### Claude Code et Cowork avec des clés de chiffrement gérées par le client Si votre organisation utilise des [clés de chiffrement gérées par le client](https://platform.claude.com/docs/fr/manage-claude/cmek), Anthropic exclut certains détails de l’utilisation de Claude Code et de Cowork de ses analyses d’utilisation, afin de protéger vos données. Par conséquent, n’utilisez pas les chiffres suivants de l’API Claude Enterprise Analytics pour mesurer l’utilisation de Claude Code ou de Cowork par votre organisation. Ils peuvent être à zéro ou inférieurs à l’utilisation réelle : * **Modifications de code :** dans l’activité des utilisateurs, ces champs de `claude_code_metrics.core_metrics` peuvent être à zéro : `lines_of_code` (lignes ajoutées et supprimées) et `commit_count`. Le champ `pull_request_count` peut être inférieur au nombre réel de pull requests. * **Skills lancés avec une commande slash :** si un utilisateur lance un skill dans Claude Code ou Cowork en tapant une commande slash, telle que `/skill-name`, cette utilisation n’est pas comptabilisée. Cela s’applique à l’utilisation des skills, ainsi qu’aux décomptes de skills Cowork dans l’activité des utilisateurs. Les skills que Claude invoque sans commande slash sont toujours comptabilisés. Pour les autres changements d’analyse liés aux clés de chiffrement gérées par le client, consultez [Ce que couvre CMEK sur Claude Enterprise](https://platform.claude.com/docs/fr/manage-claude/cmek-coverage-claude-enterprise#turned-off-or-changed). ## Étapes suivantes Suivez les sessions Claude Code, les modifications de code et l’utilisation d’outils avec une clé Admin API. Suivez l’utilisation des tokens et les coûts de votre organisation. Référence des points de terminaison pour les données d’engagement, d’adoption et de coût. Les données d’audit et de conformité utilisent leurs propres types de clés.