API d'analytique

Anthropic propose deux API d'analytique, et celle que vous utilisez dépend du produit Claude que votre organisation gère :

• L'API Claude Code Analytics fournit des métriques quotidiennes de productivité Claude Code pour les organisations qui utilisent la Claude Platform. Elle fait partie de l'Admin API et utilise une clé Admin API.
• L'API Claude Enterprise Analytics 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, etc.) destinées aux organisations Claude Enterprise. Elle utilise une clé API Analytics 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 l'API Claude Enterprise Analytics, et une clé API Analytics 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 à l'API Claude Code Analytics

L'API Claude Code Analytics est disponible pour toute organisation ayant accès à l'Admin API, et son utilisation est gratuite.

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



Obtenir l'accès à l'API Claude Enterprise Analytics

L'API Claude Enterprise Analytics 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.

L'API Claude Enterprise Analytics 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 les 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 l'API Claude Enterprise Analytics. 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 l'API Claude Enterprise Analytics 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

UTC le jour suivant et deviennent disponibles pour interrogation trois jours après l'agrégation. Si les données ne sont pas disponibles dans ce délai, 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û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 sous la forme atlassian dans le point de terminaison d'utilisation des connecteurs.



Utilisation de 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 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" (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 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, l'API Claude Enterprise Analytics ne renvoie pas l'activité Claude Code pour cette utilisation.



Étapes suivantes