AdminMonitoring

Analytics APIs

Copy page



Verstehe, welche Analytics API und welchen API-Key deine Organisation benötigt, und richte dann den Zugriff auf Claude Code-Produktivitätsmetriken oder Claude Enterprise-Engagement- und Adoptionsdaten ein.

Anthropic stellt zwei Analytics APIs bereit, und welche du verwendest, hängt davon ab, welches Claude-Produkt deine Organisation verwaltet:

• Die Claude Code Analytics API liefert tägliche Claude Code-Produktivitätsmetriken für Organisationen, die die Claude Platform nutzen. Sie ist Teil der Admin API und verwendet einen Admin API-Key.
• Die Claude Enterprise Analytics API liefert organisationsweite Engagement-, Adoptions- und Kostendaten über Claude-Produkte hinweg (Chat, Projekte, Claude Code und mehr) für Claude Enterprise-Organisationen. Sie verwendet einen Analytics API-Key, der in claude.ai erstellt wird.

Die beiden APIs verwenden unterschiedliche Key-Typen, die an unterschiedlichen Orten von unterschiedlichen Rollen erstellt werden. Diese Seite beschreibt, welche API zu deiner Organisation passt und wie du den richtigen Key erstellst.

Welche API benötigst du?

Die Key-Typen sind nicht austauschbar: Ein Admin API-Key kann die Claude Enterprise Analytics API nicht aufrufen, und ein Analytics API-Key kann die Admin API nicht aufrufen. Beide APIs erscheinen unter der Admin API-Referenz, sind aber separate APIs mit separaten Key-Typen. Wenn deine Organisation sowohl die Claude Platform als auch Claude Enterprise nutzt, kannst du beide Keys einrichten und jede API für ihre eigenen Daten verwenden.

Zugriff auf die Claude Code Analytics API erhalten

Die Claude Code Analytics API steht jeder Organisation mit Zugriff auf die Admin API zur Verfügung und ist kostenlos nutzbar.

1. 1

   Einen Admin API-Key erstellen

   Folge den Schritten unter Einen Admin API-Key erstellen.

2. 2

   Die API aufrufen

   Übergib den Key im x-api-key-Header:

   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"

   

Die verfügbaren Metriken, Anfrageparameter und das Antwortschema findest du im Leitfaden zur Claude Code Analytics API und in der API-Referenz.

Zugriff auf die Claude Enterprise Analytics API erhalten

Die Claude Enterprise Analytics API steht Claude Enterprise-Organisationen zur Verfügung. Engagement- und Adoptionsdaten sind in allen Enterprise-Plänen verfügbar. Die Kosten- und Nutzungsendpunkte gelten für nutzungsbasierte Enterprise-Pläne; bei sitzplatzbasierten Enterprise-Plänen spiegeln sie nur Nutzungsguthaben wider.

1. 1

   Als primärer Eigentümer anmelden

   Nur der primäre Eigentümer der Organisation kann den API-Zugriff aktivieren und Analytics API-Keys erstellen.

2. 2

   API-Zugriff aktivieren und einen Key erstellen

   Gehe zu claude.ai > Organization settings > API und aktiviere den öffentlichen API-Zugriff, dann erstelle einen Analytics API-Key. Keys tragen den Scope read:analytics. Kopiere das angezeigte Secret und speichere es in deinem Secrets-Manager.

3. 3

   Die API aufrufen

   Übergib den Key im x-api-key-Header und füge bei jeder Anfrage den anthropic-version-Header hinzu. Die Endpunkte befinden sich unter https://api.anthropic.com/v1/organizations/analytics/. Anfragebeispiele, Parameter und Antwortschemas findest du in der Claude Enterprise Analytics API-Referenz.

Die Claude Enterprise Analytics API bietet:

• Benutzeraktivität: tägliche Metriken pro Benutzer über Chat (Gespräche, Nachrichten, Projekte, Dateien, Artifacts), Claude Code (Sitzungen, Commits, Pull Requests, Codezeilen, Tool-Aktionen) und andere Claude-Produkte hinweg
• Aktivitätszusammenfassungen: täglich, wöchentlich und monatlich aktive Benutzer auf Organisationsebene, Sitzplatzanzahlen und ausstehende Einladungen
• Projekt-, Skill- und Connector-Nutzung: Adoptionsaufschlüsselungen für Chat-Projekte, Skills und Connectors
• Kosten- und Nutzungsberichte: Token-Nutzung und Kosten im Zeitverlauf pro Benutzer und auf Organisationsebene (nutzungsbasierte Enterprise-Pläne)

Endpunktdetails, Parameter und Antwortschemata findest du in der Claude Enterprise Analytics API-Referenz. Die folgenden Abschnitte behandeln Datenaktualität, Metrikdefinitionen und betriebliche Hinweise, die für alle diese Endpunkte gelten.

Datenverfügbarkeit und -aktualität

Daten der Claude Enterprise Analytics API sind für Datumsangaben ab dem 1. Januar 2026 verfügbar.

Engagement- und Adoptionsendpunkte (Benutzeraktivität, Zusammenfassungen, Projekte, Skills, Connectors) geben einen Tages-Snapshot für das von dir angegebene Datum zurück. Daten für einen bestimmten Tag sind in der Regel ab etwa 17:00 UTC am Folgetag verfügbar (eine Verzögerung von 1 Tag); bis dahin ist der neueste verfügbare Tag normalerweise zwei Tage vor dem aktuellen UTC-Datum. Gelegentlich treffen Daten später ein, und die genaue „data freshness" (Datenaktualität) variiert je nach Abfrage. Statt von einer festen Uhrzeit auszugehen, prüfe daher die Fehlerantwort: Die Anfrage eines Datums, das noch nicht verfügbar ist, gibt einen 400-Fehler zurück, der den neuesten verfügbaren Tag nennt. Wenn Daten deutlich nach der üblichen Verzögerung noch nicht verfügbar sind, deutet dies in der Regel auf einen Fehler in der Datenpipeline auf Seiten von Anthropic hin; wende dich an den Support, wenn die Lücke bestehen bleibt.

Kosten- und Nutzungsendpunkte folgen einem anderen Aktualitätsmodell. Daten sind typischerweise innerhalb von vier Stunden nach der zugrunde liegenden Nutzung verfügbar, können aber bis zu 24 Stunden benötigen. Werte für ein bestimmtes Datum können bis zu 30 Tage lang revidiert werden, wenn verspätete Ereignisse eintreffen und Abgleiche laufen. Für abrechnungstaugliche Gesamtsummen frage Datumsangaben ab, die mindestens 30 Tage in der Vergangenheit liegen.

Wie Metriken definiert sind

Aktive Benutzer. Ein Benutzer zählt für einen Tag als aktiv, wenn eine der folgenden Bedingungen zutrifft: Er hat mindestens eine Chat-Nachricht in Claude gesendet, er hatte mindestens eine Claude Code-Sitzung (lokal oder remote), die deiner Claude Enterprise-Organisation zugeordnet ist und Tool-Nutzung oder Git-Aktivität umfasste, oder er hatte mindestens eine Cowork-Sitzung mit Tool-Nutzung oder Nachrichtenaktivität.

Produktspezifische Metrikblöcke. Produktspezifische Metrikobjekte (zum Beispiel Office Agent- oder Cowork-Metriken in einem Benutzeraktivitätsdatensatz) sind in jedem Datensatz immer vorhanden. Organisationen ohne Nutzung dieses Produkts sehen durchgehend Nullwerte statt null.

Connector-Namen. Connector-Namen werden über Quellen hinweg normalisiert. Zum Beispiel erscheinen Atlassian MCP server, mcp-atlassian und atlassian_MCP im Connector-Nutzungsendpunkt alle als atlassian.

Arbeiten mit der API

Paginierungs-Cursor sind an die Abfrage gebunden, die sie ausgegeben hat. Ändere bei den Kosten- und Nutzungsendpunkten die Abfrageparameter nicht mitten in einer Sequenz: Wenn du products[], group_by[], order_by, den Datumsbereich oder einen beliebigen Filter änderst und einen alten Cursor übergibst, gibt die Anfrage einen 400-Fehler zurück. Um Parameter zu ändern, beginne erneut bei der ersten Seite ohne Cursor.

Listenparameter verwenden Klammernotation. Wiederhole den Parameter für jeden Wert, zum Beispiel products[]=chat&products[]=claude_code.

Betragsfelder sind Dezimalstrings in Cent. Währungsbeträge werden als Dezimalstrings wie "41280.000000" zurückgegeben (was 412,80 $ entspricht). Um in Dollar umzurechnen, parse den Wert als Dezimalzahl und teile durch 100. Vermeide binäres Gleitkomma-Parsing für Werte, die mehrere Millionen Dollar überschreiten können.

Ratenlimits gelten auf Organisationsebene, nicht pro Key, mit einem Standardwert von 60 Anfragen pro Minute über alle Endpunkte dieser API hinweg. Wenn das für deinen Anwendungsfall nicht ausreicht, kontaktiere dein Anthropic-Account-Team, um eine Anpassung des Limits zu besprechen.

Versionierung

Sende bei jeder Anfrage den anthropic-version-Header; die verfügbaren Versionen findest du unter API-Versionen.

Bekannte Einschränkungen

Wenn deine Organisation Claude Code über Amazon Bedrock nutzt, gibt die Claude Enterprise Analytics API für diese Nutzung keine Claude Code-Aktivität zurück.

Nächste Schritte