API d'analytique

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 rapporte les métriques quotidiennes de productivité de Claude Code pour les organisations qui utilisent la Claude Platform. Elle fait partie de l'Admin API et utilise une clé Admin API.
• La Claude Enterprise Analytics API rapporte les 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 clé appropriée.



De quelle API avez-vous besoin ?

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



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, et son utilisation est gratuite.

Pour 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 et la référence de l'API.



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.

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) et autres produits Claude
• Résumés d'activité : utilisateurs actifs quotidiens, hebdomadaires et mensuels au niveau de l'organisation, nombre de sièges et invitations en attente
• Utilisation des projets, compétences et connecteurs : répartitions de l'adoption pour les projets de chat, les compétences et les connecteurs
• Rapports de coût et d'utilisation : utilisation de tokens et coût par utilisateur et au niveau de l'organisation au fil du temps (forfaits Enterprise basés sur l'utilisation)

Pour les détails 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. Les sections suivantes couvrent la fraîcheur des données, les définitions des métriques et les conseils opérationnels 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, compétences, connecteurs) renvoient un instantané quotidien pour la date que vous spécifiez. Les données d'un jour donné sont agrégées à 10

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 pour une date donnée peuvent être révisées pendant une période allant jusqu'à 30 jours, à mesure que des événements tardifs arrivent et que la réconciliation s'exécute. Pour des totaux de qualité facturation, interrogez des dates remontant à au moins 30 jours.



Comment les métriques sont définies

Utilisateurs actifs. Un utilisateur est considéré comme actif pour un jour donné si l'une des conditions suivantes est vraie : 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 incluant une utilisation d'outils ou une activité git, ou il a eu au moins une session Cowork avec une utilisation d'outils ou une activité de messages.

Blocs de métriques par produit. Les objets de métriques par produit (par exemple, les métriques Office Agent ou Cowork sur un enregistrement d'activité utilisateur) sont toujours présents sur chaque enregistrement. Les organisations sans utilisation de ce produit voient des valeurs entièrement à zéro plutôt que null.

Noms de connecteurs. Les noms de connecteurs sont normalisés entre les sources. Par exemple, Atlassian MCP server, mcp-atlassian et atlassian_MCP apparaissent tous comme 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 autre filtre et que vous passez 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 $). 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 pouvant dépasser plusieurs millions de dollars.

Les 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 n'est pas suffisant pour votre cas d'usage, contactez votre équipe de compte Anthropic pour discuter d'un ajustement de la limite.



Limitations connues

Si votre organisation utilise Claude Code via Amazon Bedrock, la Claude Enterprise Analytics API ne renvoie pas l'activité Claude Code pour cette utilisation.



Étapes suivantes