L'API Analytics donne aux propriétaires principaux des plans Enterprise un accès programmatique aux données d'engagement, d'adoption, d'utilisation et de coûts de leur organisation. Utilisez-la pour créer des tableaux de bord internes, suivre les tendances d'adoption, rapprocher les dépenses avec votre facture mensuelle et intégrer les données Claude dans vos outils de reporting existants.
L'API Analytics est disponible sur les plans Enterprise. Les propriétaires principaux peuvent générer des clés API pour commencer.
En quoi cela diffère-t-il du tableau de bord analytics et de l'API Compliance ?
Ces trois options vous offrent différentes perspectives sur les données de votre organisation :
Le tableau de bord Analytics (accessible via Analytics) affiche les données d'utilisation visualisées dans le produit. C'est l'outil idéal pour la surveillance quotidienne lorsque vous n'avez pas besoin d'intégrer les données ailleurs.
L'API Analytics retourne les mêmes métriques agrégées, mais de manière programmatique — vous pouvez donc les extraire dans des outils BI, les mapper par rapport aux organigrammes, automatiser les workflows de reporting et rapprocher les données de coûts avec les enregistrements internes. Les données d'engagement et d'adoption sont agrégées par organisation et par jour. Les données d'utilisation et de coûts sont disponibles avec des ventilations plus granulaires par utilisateur et par périodes.
L'API Compliance est destinée aux cas d'usage de gouvernance et d'audit. Elle vous donne accès aux actions individuelles des utilisateurs, aux événements d'activité bruts et au contenu des conversations. Si vous avez besoin de métriques d'engagement agrégées pour les tableaux de bord, plutôt que d'événements bruts pour l'audit, utilisez l'API Analytics.
Commencer
Pour accéder à l'API Analytics, vous devez avoir un accès de propriétaire principal à votre organisation Enterprise.
Suivez ces étapes :
Accédez à Analytics > Clés API.
Trouvez le bouton bascule Accès sous API Analytics et activez-le.
Cliquez sur « + Créer une clé » pour générer une nouvelle clé API. Gardez cette clé privée — traitez-la comme un mot de passe.
Utilisez la clé avec l'en-tête
x-api-keydans vos requêtes.
Pour les détails complets d'authentification, les références des points de terminaison et les exemples de code, consultez notre guide de référence de l'API Claude Enterprise Analytics.
Quelles données sont disponibles ?
L'API Analytics comprend neuf points de terminaison répartis en deux catégories.
Engagement et adoption
Ces points de terminaison retournent des métriques d'engagement agrégées, par organisation et par jour. Les données sont disponibles pour les 90 derniers jours (pas avant le 1er janvier 2026).
Activité utilisateur : Métriques d'engagement par utilisateur sur les surfaces Claude. Inclut les comptages de conversations, les messages envoyés, les projets créés, les fichiers téléchargés, les artefacts créés, les compétences utilisées, les connecteurs utilisés, les métriques Claude Code comme les commits, les demandes de tirage et les lignes de code, et les métriques Cowork comme les sessions démarrées, les actions d'outils, les tours de dispatch et les invocations de compétences et de connecteurs.
Résumé d'activité : Comptages quotidiens, hebdomadaires et mensuels des utilisateurs actifs à l'échelle de l'organisation sur Claude, Claude Code et Cowork, ainsi que l'utilisation des sièges et les comptages des invitations en attente. Supporte les plages de dates jusqu'à 31 jours par requête.
Utilisation des projets de chat : Comptages des conversations et des utilisateurs ventilés par projet, pour les projets Claude.
Utilisation des compétences : Nombre d'utilisateurs utilisant chaque compétence, avec des ventilations pour les sessions Claude, Claude Code et Cowork séparément.
Utilisation des connecteurs : Quels connecteurs votre organisation utilise et combien d'utilisateurs uniques ont utilisé chacun, avec des ventilations pour les sessions Claude, Claude Code et Cowork séparément.
Utilisation et coûts
Remarque : Les points de terminaison de coûts et d'utilisation s'appliquent aux plans Enterprise basés sur l'utilisation. Pour les plans Enterprise basés sur les sièges, ces points de terminaison ne refléteront que l'utilisation supplémentaire.
Ces points de terminaison (actuellement disponibles en bêta) retournent les données d'utilisation des jetons et de coûts en USD sur les surfaces Claude. Utilisez-les pour suivre l'utilisation entre les factures mensuelles, rapprocher la facturation Anthropic avec les centres de coûts internes et informer les limites de dépenses en fonction du comportement réel des utilisateurs.
Utilisation des jetons par utilisateur : Utilisateurs classés par utilisation de jetons sur une plage de dates, avec des ventilations optionnelles par produit, modèle, fenêtre de contexte, région d'inférence ou vitesse.
Coût par utilisateur : Utilisateurs classés par dépense en USD sur une plage de dates, avec des ventilations optionnelles par produit, modèle, type de coût (jetons, recherche web, exécution de code) ou type de jeton.
Utilisation des jetons au fil du temps : Utilisation des jetons regroupée par minute, heure ou jour, optionnellement ventilée par produit, modèle, fenêtre de contexte, région d'inférence ou vitesse.
Coût au fil du temps : Coût en USD regroupé par minute, heure ou jour, avec les mêmes options de regroupement plus le type de coût et le type de jeton.
Les données sont actualisées toutes les quatre heures et peuvent prendre jusqu'à 24 heures. Les valeurs peuvent être révisées pendant jusqu'à 30 jours à mesure que les événements tardifs se rapprochent, donc pour les totaux de qualité de facturation, interrogez les dates d'au moins 30 jours dans le passé.
Limites de données
Les points de terminaison d'engagement et d'adoption retournent les données pour une date unique ou une plage de dates. Les données ne sont disponibles qu'après le 1er janvier 2026, et pour les dates de plus de trois jours.
Les points de terminaison d'utilisation et de coûts vous permettent d'interroger une fenêtre de 31 jours, remontant jusqu'à 365 jours à partir d'aujourd'hui. Pour les totaux de qualité de facturation, interrogez les dates d'au moins 30 jours dans le passé afin que les événements tardifs aient le temps de se rapprocher.
L'API a une limite de débit par défaut de 60 requêtes par minute. Si cela ne répond pas aux besoins de votre organisation, contactez votre contact Anthropic ou notre équipe commerciale.
Important : Si vous utilisez Claude Code via Amazon Bedrock, l'API Analytics ne retournera pas les données liées à Claude Code.