Übersicht
Die Claude Enterprise Analytics API bietet Ihrer Organisation programmgesteuerten Zugriff auf Engagement-Daten für Claude und Claude Code innerhalb Ihrer Enterprise-Organisation. Egal ob Sie interne Dashboards für Benutzeraktivitäten erstellen oder die Einführung von Projekten verfolgen – diese API bietet die aggregierten Metriken, die Sie benötigen.
Datenaggregation
Alle Daten werden pro Organisation und pro Tag aggregiert. Jeder Endpunkt gibt einen Snapshot für ein einzelnes Datum zurück, das Sie angeben. Daten für Tag (N-1) werden um 10:00:00 UTC-Zeit an Tag N verarbeitet und sind drei Tage nach der Aggregation zur Abfrage verfügbar, um die Genauigkeit der Daten zu gewährleisten.
Wenn Daten nicht innerhalb des oben genannten Zeitraums verfügbar sind, deutet dies normalerweise auf einen Fehler in der Datenpipeline hin, den unser Team intern untersuchen muss. Wir sind uns solcher Probleme normalerweise bewusst, aber bitte wenden Sie sich an Ihren CSM, wenn Sie eine Überprüfung wünschen oder etwas anderes vermuten.
Zugriff aktivieren
Um neue Analytics-API-Schlüssel zu erstellen, müssen Sie ein Primary Owner in Ihrer Enterprise-Organisation sein. Sie können dies tun, indem Sie zu claude.ai/analytics/api-keys navigieren.
Hier sind einige weitere Details, die hilfreich sein könnten:
Sie können den Zugriff auf die öffentliche API jederzeit aktivieren/deaktivieren. Wenn Sie den Zugriff durch Ausschalten des Schalters deaktivieren, werden alle Anfragen abgelehnt.
Sie benötigen einen Schlüssel mit dem Bereich
read:analytics, um auf die API zuzugreifen. Sie können mehrere Schlüssel für Ihre Organisation erstellen, aber Ratenlimits gelten auf Organisationsebene, nicht auf Schlüsselebene. Siehe den Abschnitt „Rate Limiting" unten."Wie immer empfehlen wir dringend, API-Schlüssel sicher zu handhaben: Geben Sie diese Schlüssel niemals öffentlich frei – sie sind geheim und sollten sicher weitergegeben werden.
Basis-URL
Alle Anfragen werden gesendet an:
https://api.anthropic.com/v1/organizations/analytics/
Authentifizierung
Jede Anfrage erfordert einen API-Schlüssel, der im Header x-api-key übergeben wird. Ihr API-Schlüssel muss den Bereich read:analytics haben. Sie können API-Schlüssel in den claude.ai-Administratoreinstellungen im Abschnitt API-Schlüssel erstellen und verwalten.
Beispiel-Anfrage-Header:
x-api-key: $YOUR_API_KEY
Paginierung
Mehrere Endpunkte geben paginierte Ergebnisse zurück. Die Paginierung verwendet einen cursor-basierten Ansatz, bei dem die Antwort ein Token next_page enthält, das Sie in Ihrer nächsten Anfrage übergeben, um die nächste Seite mit Ergebnissen abzurufen.
Zwei optionale Parameter steuern die Paginierung:
limit (integer): Anzahl der Datensätze pro Seite. Standardwert ist 20 für den Endpunkt /users und 100 für alle anderen Endpunkte. Das Maximum ist 1000.
page (string): Das undurchsichtige Cursor-Token aus dem Feld next_page der vorherigen Antwort. Lassen Sie dies bei Ihrer ersten Anfrage weg.
Wenn es keine weiteren Ergebnisse gibt, ist next_page in der Antwort null.
Fehlerantworten
Alle Endpunkte geben Standard-HTTP-Fehlercodes zurück:
Code | Bedeutung |
400 | Ein Abfrageparameter ist ungültig. Häufige Ursachen sind ein ungültiges Datum, ein Datum vor 1/1/26 (erste Verfügbarkeit) oder ein Datum, das heute oder in der Zukunft liegt. Die Datenverfügbarkeit ist um drei Tage verzögert. |
404 | Der API-Schlüssel fehlt, ist ungültig oder hat nicht den Bereich |
429 | Ratenlimit überschritten. Zu viele Anfragen. |
503 | Vorübergehender Fehler, bitte versuchen Sie es erneut. |
Rate Limiting
Wir haben Standardratenlimits eingerichtet. Wenn das für Ihren Anwendungsfall nicht ausreichend ist, würden wir gerne verstehen, warum. Falls erforderlich, können wir die Ratenlimits für Ihre Organisation anpassen – bitte wenden Sie sich an Ihren CSM.
Endpunkte
1. Benutzeraktivität auflisten
GET /v1/organizations/analytics/users
Gibt Engagement-Metriken pro Benutzer für einen einzelnen Tag zurück. Jedes Element in der Antwort stellt einen Benutzer dar und enthält seine Aktivitätszählungen für Claude (Chat) und Claude Code.
Abfrageparameter
Feld | Typ | Erforderlich | Beschreibung |
| string | Ja | Das Datum, für das Metriken abgerufen werden sollen, im Format YYYY-MM-DD. |
| integer | Nein | Anzahl der Datensätze pro Seite (Standard: 20, Maximum: 1000). |
| string | Nein | Cursor-Token aus dem Feld |
Antwortfelder (pro Benutzer)
Feld | Beschreibung |
| Eindeutige Kennung für den Benutzer. |
| Die E-Mail-Adresse des Benutzers. |
| Anzahl der unterschiedlichen Unterhaltungen, speziell innerhalb von Claude.ai. |
| Gesamtzahl der gesendeten Nachrichten, speziell innerhalb von Claude.ai. |
| Anzahl der erstellten Projekte, speziell innerhalb von Claude.ai. |
| Anzahl der verwendeten unterschiedlichen Projekte, speziell innerhalb von Claude.ai. |
| Anzahl der hochgeladenen Dateien, speziell innerhalb von Claude.ai. |
| Anzahl der erstellten Artefakte, speziell innerhalb von Claude.ai. |
| Anzahl der Denk- (erweiterten) Nachrichten, speziell innerhalb von Claude.ai. |
| Anzahl der verwendeten unterschiedlichen Fähigkeiten, speziell innerhalb von Claude.ai. |
| Gesamtzahl der aufgerufenen Konnektoren, speziell innerhalb von Claude.ai. |
| Anzahl der Git-Commits über Claude Code. |
| Anzahl der über Claude Code erstellten Pull Requests. |
| Gesamtzahl der hinzugefügten Codezeilen. |
| Gesamtzahl der entfernten Codezeilen. |
| Anzahl der unterschiedlichen Claude Code-Sitzungen. |
| Akzeptierte und abgelehnte Anzahl für das Edit-Tool. |
| Akzeptierte und abgelehnte Anzahl für das Multi-Edit-Tool. |
| Akzeptierte und abgelehnte Anzahl für das Write-Tool. |
| Akzeptierte und abgelehnte Zählungen für das Notebook Edit-Tool. |
| Gesamtzahl der Aufrufe des Web-Search-Tools. Dies gilt sowohl für claude.ai als auch für die Claude-Code-Nutzung in Ihrer Organisation. |
Office Agent-Metriken (pro Benutzer)
Jeder Benutzerdatensatz enthält auch ein office_metrics-Objekt mit produktspezifischen Aufschlüsselungen für Excel und PowerPoint. Dieser Block ist immer in jedem Datensatz vorhanden – Organisationen ohne Office Agent-Nutzung sehen Nullwerte statt null.
Das office_metrics-Objekt enthält zwei Schlüssel: excel und powerpoint.
Jeder Schlüssel enthält die gleichen sechs Felder:
Feld | Beschreibung |
| Anzahl der unterschiedlichen Office Agent-Sitzungen. |
| Anzahl der gesendeten Nachrichten (eine pro abgeschlossener Agent-Aktion). |
| Gesamtzahl der Skill-Aufrufe. Ein einzelner Skill, der fünfmal verwendet wird, zählt als fünf. |
| Anzahl der unterschiedlichen verwendeten Skills. |
| Gesamtzahl der Connector-Aufrufe. Ein einzelner Connector, der dreimal verwendet wird, zählt als drei. |
| Anzahl der unterschiedlichen verwendeten Connectors. |
*Hinweis: Wobei [product] entweder excel oder powerpoint ist.
Beispielanfrage
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/users?date=2025-01-01&limit=3"
--header "x-api-key: $YOUR_API_KEY"
2. Aktivitätszusammenfassung
GET /v1/organizations/analytics/summaries
Gibt eine allgemeine Zusammenfassung der Engagement- und Sitzplatzauslastung pro Tag für Ihre Organisation für einen bestimmten Datumsbereich zurück. Die Antwort ist eine Liste von Tagen mit aggregierten Zählungen innerhalb des Datumsbereichs. Beachten Sie, dass der maximale Unterschied zwischen ending_date und starting_date 31 Tage betragen muss, und es gibt eine dreitägige Verzögerung bei der Datenverfügbarkeit. Dies ist nützlich zum Verfolgen täglich aktiver Benutzer, wöchentlicher und monatlicher Trends sowie zur Sitzplatzvergabe auf einen Blick.
Wir definieren „aktiv" wenn eine der folgenden Bedingungen erfüllt ist:"
Der Benutzer hat mindestens eine Chat-Nachricht auf Claude (Chat) gesendet.
Der Benutzer hatte mindestens eine Claude Code-Sitzung (lokal oder remote), die mit der C4E-Organisation verknüpft ist, mit Tool-Nutzung/Git-Aktivität
Abfrageparameter
Feld | Typ | Erforderlich | Beschreibung |
| string | Ja | Das Startdatum zum Abrufen von Daten im Format YYYY-MM-DD. Es gibt eine dreitägige Verzögerung bei der Datenverfügbarkeit, daher sind die aktuellsten Daten, auf die Sie zugreifen können, von vor drei Tagen. |
| string | Nein | Das optionale Enddatum zum Abrufen von Daten im Format YYYY-MM-DD. Dies ist exklusiv. |
Antwortfelder
Feld | Beschreibung |
| Erster Tag, für den Metriken aggregiert werden, interpretiert als UTC-Datum. Es gibt eine dreitägige Verzögerung bei der Datenverfügbarkeit, daher sind die aktuellsten Daten, auf die Sie zugreifen können, von vor drei Tagen. |
| Letzter Tag (exklusiv), für den Metriken aggregiert werden, interpretiert als UTC-Datum |
| Anzahl der Benutzer, die am angegebenen Datum aktiv waren (basierend auf Token-Verbrauch). |
| Anzahl der Benutzer, die innerhalb des 7-Tage-Fensters aktiv waren, das am angegebenen Datum endet. |
| Anzahl der Benutzer, die innerhalb des 30-Tage-Fensters aktiv waren, das am angegebenen Datum endet. |
| Gesamtzahl der derzeit in Ihrer Organisation zugewiesenen Plätze. |
| Anzahl der ausstehenden Einladungen, die noch nicht akzeptiert wurden. |
Hinweis: Die rollierenden Fenster für wöchentliche und monatliche Zählungen blicken vom angegebenen Datum (einschließlich) zurück. Wenn die Daten für einige Tage innerhalb des Fensters unvollständig sind (z. B. wenn das Datum weniger als 30 Tage in der Vergangenheit liegt), kann die monatliche Zählung die Aktivität unterschätzen.
Beispielanfrage
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/summaries?starting_date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
3. Chat-Projektnutzung
GET /v1/organizations/analytics/apps/chat/projects
Gibt Nutzungsdaten nach Chat-Projekt für ein bestimmtes Datum zurück. Projekte sind spezifisch für Claude (Chat), daher konzentriert sich dieser Endpunkt auf diese Oberfläche. Jedes Element zeigt den Projektnamen, wie viele eindeutige Benutzer damit interagiert haben, und die Gesamtzahl der Konversationen in diesem Projekt.
Abfrageparameter
Feld | Typ | Erforderlich | Beschreibung |
| string | Ja | Das Datum, für das Metriken abgerufen werden sollen, im Format YYYY-MM-DD. Es gibt eine dreitägige Verzögerung bei der Datenverfügbarkeit, daher sind die aktuellsten Daten, auf die Sie zugreifen können, von vor drei Tagen. |
| integer | Nein | Anzahl der Datensätze pro Seite (Standard: 100, Maximum: 1000). |
| string | Nein | Cursor-Token aus dem Feld |
Antwortfelder (pro Projekt)
Feld | Beschreibung |
| Der Name des Projekts. |
| Die gekennzeichnete Projekt-ID, d. h. "claude_proj_{ID}" |
| Anzahl der eindeutigen Benutzer, die dieses Projekt am angegebenen Datum verwendet haben. |
| Anzahl der Konversationen in diesem Projekt am angegebenen Datum. |
| Gesamtzahl der Nachrichten, die am angegebenen Datum in diesem Projekt gesendet wurden. |
| Der Zeitstempel der Projekterstellung. |
|
|
Beispielanfrage
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/apps/chat/projects?date=2025-01-01&limit=50"
--header "x-api-key: $YOUR_API_KEY"
4. Skill-Nutzung
GET /v1/organizations/analytics/skills
Gibt Skill-Nutzungsdaten sowohl für Claude (Chat) als auch für Claude Code in Ihrer Organisation für ein bestimmtes Datum zurück. Jedes Element stellt einen Skill dar und zeigt, wie viele eindeutige Benutzer ihn verwendet haben.
Abfrageparameter
Feld | Typ | Erforderlich | Beschreibung |
| string | Ja | Das Datum, für das Metriken abgerufen werden sollen, im Format YYYY-MM-DD. Es gibt eine dreitägige Verzögerung bei der Datenverfügbarkeit, daher sind die aktuellsten Daten, auf die Sie zugreifen können, von vor drei Tagen. |
| integer | Nein | Anzahl der Datensätze pro Seite (Standard: 100, Maximum: 1000). |
| string | Nein | Cursor-Token aus dem Feld |
Antwortfelder (pro Skill)
Feld | Beschreibung |
| Der Name des Skills. |
| Anzahl der eindeutigen Benutzer, die diesen Skill am angegebenen Datum verwendet haben. |
| Anzahl der unterschiedlichen Unterhaltungen, in denen der Skill mindestens einmal verwendet wurde, im Chat. |
| Anzahl der unterschiedlichen Remote-Sitzungen, in denen der Skill mindestens einmal verwendet wurde, in Claude Code. |
Office Agent-Metriken (pro Skill)
Jeder Skill-Datensatz enthält auch ein office_metrics-Objekt, das anzeigt, wie viele Office Agent-Sitzungen den Skill verwendet haben, aufgeschlüsselt nach Produkt. Dieser Block ist immer vorhanden – Organisationen ohne Office Agent-Nutzung sehen Nullwerte.
Feld | Beschreibung |
| Anzahl der unterschiedlichen Office Agent-Sitzungen in Excel, in denen dieser Skill verwendet wurde. |
| Anzahl der unterschiedlichen Office Agent-Sitzungen in PowerPoint, in denen dieser Skill verwendet wurde. |
Beispielanfrage
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/skills?date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
5. Connector-Nutzung
GET /v1/organizations/analytics/connectors
Gibt MCP-/Connector-Nutzungsdaten sowohl für Claude (Chat) als auch für Claude Code in Ihrer Organisation für ein bestimmtes Datum zurück. Jedes Element stellt einen Connector dar und zeigt, wie viele eindeutige Benutzer ihn verwendet haben. Connector-Namen werden aus verschiedenen Quellen normalisiert – beispielsweise würden „Atlassian MCP server
Abfrageparameter
Feld | Typ | Erforderlich | Beschreibung |
| string | Ja | Das Datum, für das Metriken abgerufen werden sollen, im Format YYYY-MM-DD. Es gibt eine dreitägige Verzögerung bei der Datenverfügbarkeit, daher sind die aktuellsten Daten, auf die Sie zugreifen können, von vor drei Tagen. |
| Ganzzahl | Nein | Anzahl der Datensätze pro Seite (Standard: 100, Maximum: 1000). |
| Zeichenkette | Nein | Cursor-Token aus dem Feld |
Antwortfelder (pro Connector)
Feld | Beschreibung |
| Der normalisierte Name des Connectors. |
| Anzahl der eindeutigen Benutzer, die diesen Connector am angegebenen Datum verwendet haben. |
| Anzahl der unterschiedlichen Unterhaltungen, in denen der Connector mindestens einmal im Chat verwendet wurde. |
| Anzahl der unterschiedlichen Remote-Sitzungen, in denen die Fähigkeit mindestens einmal in Claude Code verwendet wurde. |
Office Agent-Metriken (pro Connector)
Jeder Connector-Datensatz enthält auch ein office_metrics-Objekt, das angibt, wie viele Office Agent-Sitzungen den Connector verwendet haben, aufgeschlüsselt nach Produkt. Dieser Block ist immer vorhanden – Organisationen ohne Office Agent-Nutzung sehen Nullwerte.
Feld | Beschreibung |
| Anzahl der unterschiedlichen Office Agent-Sitzungen in Excel, in denen dieser Connector verwendet wurde. |
| Anzahl der unterschiedlichen Office Agent-Sitzungen in PowerPoint, in denen dieser Connector verwendet wurde. |
Beispielanfrage
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/connectors?date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"