--- 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, 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 | | ----------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Claude Code Analytics API** | Clé Admin API (`sk-ant-admin01-...`) | Page [Admin keys](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 | | **Claude Enterprise Analytics API** | Clé Analytics API | [claude.ai > Organization settings > 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. Les deux API 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 et de coût de l'API plutôt que des analyses produit ? Consultez l' [API d'utilisation et de coût](https://platform.claude.com/docs/fr/manage-claude/usage-cost-api) , qui explique la bonne démarche pour les organisations Claude Console comme pour les organisations 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" \ --header "anthropic-version: 2023-06-01" \ --header "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Pour connaître les métriques disponibles, les paramètres de requête et le schéma de réponse, consultez le [guide de la Claude Code Analytics API](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 > Organization settings > 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ût et d'utilisation :** utilisation des tokens et coût par utilisateur et au niveau de l'organisation au fil du temps (forfaits Enterprise basés sur l'utilisation) 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 endpoints d'engagement et d'adoption** (activité des utilisateurs, synthèses, projets, skills, connecteurs) renvoient un instantané quotidien pour la date que vous spécifiez. Les données d'une journée donnée sont généralement disponibles vers 13 h 00–13 h 30 UTC le lendemain (un décalage d'un jour) ; d'ici là, le jour disponible le plus récent est généralement celui situé deux 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 toujours pas disponibles bien au-delà du décalage habituel, cela indique généralement une défaillance d'un pipeline de données du côté d'Anthropic ; contactez le support si le problème persiste. **Les points de terminaison de coût et d'utilisation** suivent un modèle de fraîcheur différent. Les données sont généralement disponibles dans les quatre 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 calendaire. Par exemple, les valeurs du 1er octobre peuvent changer jusqu'au 7 novembre environ. 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`. Lorsque `ending_at` est omis (la valeur par défaut est l'heure actuelle), la réponse inclut une portion finale de données postérieures à `data_refreshed_at` qui est incomplète. 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 comptabilisé 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 « tool use » (utilisation d'outils) ou une activité git, ou il a eu au moins une session Cowork avec utilisation d'outils ou activité de messages. **Chat and Cowork unified (bêta).** 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 comptabilisé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`. À mesure que davantage d'utilisateurs commencent à utiliser Chat and Cowork unified, l'utilisation quitte vos chiffres de chat et de Cowork pour rejoindre ces nouveaux chiffres. 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 comptabilisée sous chat ou Cowork. Les décomptes hebdomadaires et mensuels peuvent l'inclure dans les deux lorsque la période comporte une activité des deux types, même sur des jours différents. Par exemple, la période 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 valeurs toutes à zéro plutôt que `null`. Chat and Cowork unified fait exception : sur les déploiements qui ne le proposent pas, ses champs sont omis de la réponse. **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 exprimées en cents.** Les montants monétaires sont renvoyés sous forme de chaînes décimales telles que `"41280.000000"` (ce qui représente 412,80 $). Pour convertir en dollars, analysez la valeur comme un nombre décimal et divisez 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 par 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 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 de l'API](https://platform.claude.com/docs/fr/api/versioning) pour connaître les versions disponibles. ## Limitations connues Si votre organisation utilise Claude Code via Amazon Bedrock, la Claude Enterprise Analytics API ne renvoie pas l'activité Claude Code correspondant à cette utilisation. ## Étapes suivantes Suivez les sessions Claude Code, les modifications de code et l'utilisation d'outils avec une clé Admin API. Suivez l'utilisation de tokens de l'API et les coûts pour 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.