--- title: Analytics APIs url: https://platform.claude.com/docs/de/manage-claude/analytics-api description: 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](https://platform.claude.com/docs/de/manage-claude/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? | API | Key-Typ | Erstellt in | Wer kann ihn erstellen | Was sie abdeckt | | ----------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Claude Code Analytics API** | Admin API-Key (`sk-ant-admin01-...`) | Seite [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) in der Claude Console | Organisationsadmin | Tägliche Claude Code-Metriken pro Benutzer: Sitzungen, Codezeilen, Commits, Pull Requests, Tool-Akzeptanz und geschätzte Kosten nach Modell | | **Claude Enterprise Analytics API** | Analytics API-Key | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Primärer Eigentümer | Organisationsweites Engagement und Adoption (Benutzeraktivität, Zusammenfassungen aktiver Benutzer, Projekt-, Skill- und Connector-Nutzung) sowie Kosten- und Nutzungsberichte | 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 in der [Admin API-Referenz](https://platform.claude.com/docs/de/api/beta/organization), 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. Suchst du nach API-Nutzungs- und Kostendaten statt nach Produktanalysen? Siehe die [Usage and Cost API](https://platform.claude.com/docs/de/manage-claude/usage-cost-api) , die den richtigen Weg sowohl für Claude Console- als auch für Claude Enterprise-Organisationen erklärt. Wenn du Engagement- und Adoptionsdaten im Produkt statt programmatisch ansehen möchtest, verwende das [Analytics-Dashboard](https://claude.ai/analytics/activity) in claude.ai. Für Governance- und Auditing-Anwendungsfälle (einzelne Benutzeraktionen, rohe Aktivitätsereignisse, Gesprächsinhalte) siehe die [Compliance API](https://platform.claude.com/docs/de/manage-claude/compliance-api-access). ## Zugriff auf die Claude Code Analytics API erhalten Die Claude Code Analytics API steht jeder Organisation mit Zugriff auf die [Admin API](https://platform.claude.com/docs/de/manage-claude/admin-api) zur Verfügung und ist kostenlos nutzbar. Folge den Schritten unter [Einen Admin API-Key erstellen](https://platform.claude.com/docs/de/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization). Übergib den Key im `x-api-key`-Header: ```bash 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](https://platform.claude.com/docs/de/manage-claude/claude-code-analytics-api) und in der [API-Referenz](https://platform.claude.com/docs/de/api/beta/organization/usage_report/retrieve_claude_code). ## 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. Nur der primäre Eigentümer der Organisation kann den API-Zugriff aktivieren und Analytics API-Keys erstellen. Gehe zu [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) 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. Übergib den Key im `x-api-key`-Header und füge bei jeder Anfrage den [`anthropic-version`](https://platform.claude.com/docs/de/api/versioning)-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](https://platform.claude.com/docs/de/api/beta/organization/analytics). Die Claude Enterprise Analytics API bietet: * **Benutzeraktivität:** tägliche Metriken pro Benutzer für Chat (Gespräche, Nachrichten, Projekte, Dateien, Artifacts), Claude Code (Sitzungen, Commits, Pull Requests, Codezeilen, Tool-Aktionen), Chat and Cowork unified (Chat-Aktivität und Cowork-Sitzungen) und andere Claude-Produkte * **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 pro Benutzer und auf Organisationsebene im Zeitverlauf (nutzungsbasierte Enterprise-Pläne) Endpunktdetails, Parameter und Antwortschemata findest du in der [Claude Enterprise Analytics API-Referenz](https://platform.claude.com/docs/de/api/beta/organization/analytics). 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 Adoptions-Endpunkte** (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 am folgenden Tag gegen etwa 13:00–13:30 UTC verfügbar (eine Verzögerung von 1 Tag); bis dahin ist der neueste verfügbare Tag normalerweise zwei Tage vor dem aktuellen UTC-Datum. An Tagen, an denen eine vorgelagerte Datenpipeline verspätet läuft, treffen die Daten später ein, und die genaue Aktualität variiert je nach Abfrage. Statt von einer festen Uhrzeit auszugehen, prüfe daher die Fehlerantwort: Die Anfrage eines noch nicht verfügbaren Datums 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 einer 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 in der Regel innerhalb von vier Stunden nach der zugrunde liegenden Nutzung verfügbar, können aber bis zu 24 Stunden benötigen. Werte können revidiert werden, wenn verspätete Ereignisse eintreffen und Abgleiche laufen, und zwar bis etwa 7 Tage nach Ende des Kalendermonats. Beispielsweise können sich Werte für den 1. Oktober bis etwa zum 7. November ändern. Für abrechnungstaugliche Gesamtsummen frage nur Monate ab, die vor mindestens 7 Tagen geendet haben. Kosten- und Nutzungsantworten enthalten einen `data_refreshed_at`-Zeitstempel. Wenn `ending_at` weggelassen wird (der Standardwert ist die aktuelle Zeit), enthält die Antwort einen Datenabschnitt nach `data_refreshed_at`, der unvollständig ist. Für stabile Ergebnisse über wiederholte Aufrufe hinweg setze `ending_at` auf einen Wert, der einem zuvor zurückgegebenen `data_refreshed_at` entspricht oder davor liegt. ## 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. **Chat and Cowork unified (Beta).** Chat and Cowork unified bringt die Funktionen von Cowork in den Chat von claude.ai. Die meisten Aktivitäten in Chat and Cowork unified werden unter dem Produktwert `chat_cowork_unified` gemeldet, nicht unter `chat` oder `cowork`. In der Benutzeraktivität sowie in der Skill-, Connector- und Plugin-Nutzung erscheint diese Nutzung im Objekt `chat_cowork_unified_metrics`. In Aktivitätszusammenfassungen wird sie in `chat_cowork_unified_daily_active_user_count`, `chat_cowork_unified_weekly_active_user_count` und `chat_cowork_unified_monthly_active_user_count` gezählt. Je mehr Benutzer Chat and Cowork unified verwenden, desto mehr Nutzung wandert aus deinen Chat- und Cowork-Zahlen in diese neuen Zahlen. Nutzung an Tagen, bevor ein Benutzer Chat and Cowork unified zu verwenden beginnt, bleibt unter Chat oder Cowork. Organisationsweite Zahlen wie die gesamte Token-Nutzung, die Gesamtkosten und die Gesamtzahl aktiver Benutzer ändern sich nicht. Nach Produkt gefilterte Kosten- und Nutzungsberichte lassen die Nutzung von Chat and Cowork unified aus, sofern `products[]` nicht `chat_cowork_unified` enthält. Einige Aktivitäten von Benutzern von Chat and Cowork unified, etwa der Sprachmodus, können weiterhin unter Chat oder Cowork gemeldet werden. Die Aktivität eines Benutzers kann außerdem an dem Tag, an dem er Chat and Cowork unified zu verwenden beginnt, auf mehrere Produkte aufgeteilt werden. Dasselbe gilt für den Tag, an dem es für ihn deaktiviert wird. Wie sich die Aktivität aufteilt, ist nicht garantiert. Ein Benutzer kann sowohl in den Chat- oder Cowork-Zahlen als auch in den Zahlen für Chat and Cowork unified erscheinen. Das kann an einem Tag passieren, an dem er Chat and Cowork unified verwendet und ein Teil seiner Aktivität weiterhin unter Chat oder Cowork gemeldet wird. Wöchentliche und monatliche Zahlen können ihn in beiden enthalten, wenn das Zeitfenster Aktivität beider Arten aufweist, selbst an unterschiedlichen Tagen. Beispielsweise könnte das Zeitfenster Tage vor und nach dem Beginn seiner Nutzung von Chat and Cowork unified umfassen. Wenn du die Benutzeraktivität nach Projekt filterst, wird die Projektaktivität jedes Tages nur an einer Stelle gezählt. Wenn ein Benutzer an diesem Tag eine Chat-Nachricht in Chat and Cowork unified gesendet hat, wird seine gesamte Projektaktivität in `chat_cowork_unified_metrics.chat` gezählt. Andernfalls wird sie in `chat_metrics` gezählt. **Metrikblöcke pro Produkt.** Metrikobjekte pro Produkt (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`. Die Ausnahme ist Chat and Cowork unified: Bei Bereitstellungen, die es nicht anbieten, werden seine Felder in der Antwort weggelassen. **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](https://platform.claude.com/docs/de/api/versioning). ## 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 Verfolge Claude Code-Sitzungen, Codeänderungen und Tool-Nutzung mit einem Admin API-Key. Verfolge API-Token-Nutzung und Kosten für deine Organisation. Endpunktreferenz für Engagement-, Adoptions- und Kostendaten. Audit- und Compliance-Daten verwenden eigene Key-Typen.