AdministrationSurveillance

API d'analytique

Copy page



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 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 ?

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 il s'agit d'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.

1. 1

   Créer une clé Admin API

   Suivez les étapes décrites dans Créer une clé Admin API.

2. 2

   Appeler l'API

   Transmettez la clé dans l'en-tête x-api-key :

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

1. 1

   Se connecter en tant que propriétaire principal

   Seul le propriétaire principal de l'organisation peut activer l'accès à l'API et créer des clés Analytics API.

2. 2

   Activer l'accès à l'API et créer une clé

   Accédez à claude.ai > Organization settings > API 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.

3. 3

   Appeler l'API

   Transmettez la clé dans l'en-tête x-api-key. 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.

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 les 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 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 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. 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, synthèses, projets, skills, connecteurs) renvoient un instantané par jour pour la date que vous spécifiez. Les données d'un jour donné sont agrégées à 10:00 UTC le jour suivant et sont généralement disponibles avec un décalage d'un jour. La fraîcheur exacte varie selon la requête ; plutôt que de supposer un décalage 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û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 cela peut prendre jusqu'à 24 heures. Les valeurs d'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 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.

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 toutes à zéro plutôt que 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 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.

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