--- 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 Produkt-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-Schlüssel](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 > Organisationseinstellungen > API](https://claude.ai/admin-settings/api-access) | Haupteigentü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. Die einzige Ausnahme ist die [Usage and Cost Analytics API](https://platform.claude.com/docs/de/manage-claude/usage-cost-analytics-api), die Claude Enterprise-Organisationen mit ihrem Analytics API-Key aufrufen. Beide Produkt-Analytics-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 eher nach Token-Nutzungs- und Kostendaten als nach Produktanalysen? Sieh dir die [Usage and Cost Analytics API](https://platform.claude.com/docs/de/manage-claude/usage-cost-analytics-api) an, die sowohl Claude Console- als auch Claude Enterprise-Organisationen bedient. 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" \ -H "anthropic-version: 2026-10-21" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Für die verfügbaren Metriken, Anfrageparameter und das Antwortschema siehe den Leitfaden zur [Claude Code Analytics API](https://platform.claude.com/docs/de/manage-claude/claude-code-analytics-api) und die [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 > Organisationseinstellungen > 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) Die Kosten- und Nutzungsberichtsendpunkte unter `/v1/organizations/analytics/` (`usage_report`, `cost_report`, `user_usage_report` und `user_cost_report`) sind veraltet und werden weiterhin unterstützt. Verwende für neue Integrationen die [Usage and Cost Analytics API](https://platform.claude.com/docs/de/manage-claude/usage-cost-analytics-api). Um eine bestehende Integration umzustellen, siehe [Migration von den Claude Enterprise-Nutzungs- und Kostenberichten](https://platform.claude.com/docs/de/manage-claude/usage-cost-analytics-api#migrate-from-enterprise-analytics-reports). Die anderen Endpunkte der Claude Enterprise Analytics API sind nicht veraltet. 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 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 bis etwa 13:00–13:30 UTC am folgenden Tag verfügbar (1 Tag Verzögerung). Bis dahin ist der neueste verfügbare Tag normalerweise 2 Tage vor dem aktuellen UTC-Datum. An Tagen, an denen eine vorgelagerte Datenpipeline verspätet läuft, kommen die Daten später an, 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 über die übliche Verzögerung hinaus nicht verfügbar sind, deutet dies in der Regel auf einen Fehler 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 in der Regel innerhalb von 4 Stunden nach der zugrunde liegenden Nutzung verfügbar, können aber bis zu 24 Stunden dauern. Werte können überarbeitet werden, wenn verspätete Ereignisse eintreffen und Abgleiche laufen, 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 rechnungstaugliche Summen frage nur Monate ab, die vor mindestens 7 Tagen geendet haben. Kosten- und Nutzungsantworten enthalten einen `data_refreshed_at`-Zeitstempel. Wenn du `ending_at` weglässt, ist der Standardwert 31 Tage nach `starting_at` oder die aktuelle Zeit, je nachdem, was früher liegt. Dieser Bereich kann über `data_refreshed_at` hinausreichen, und Daten nach diesem Zeitpunkt sind unvollständig. 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 gilt 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 beinhaltete. * Er hatte mindestens eine Cowork-Sitzung mit Tool-Nutzung oder Nachrichtenaktivität. **Chat and Cowork unified.** Chat and Cowork unified bringt die Funktionen von Cowork in den claude.ai-Chat. Die meiste Aktivität in Chat and Cowork unified wird 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. Wenn ein Benutzer Chat and Cowork unified zu verwenden beginnt, wandert seine Nutzung aus deinen Chat- und Cowork-Zahlen in die Zahlen für Chat and Cowork unified. 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 von Chat and Cowork unified erscheinen. Dies kann an einem Tag vorkommen, 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 kann 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 Zählwerte von 0 statt eines `null`-Objekts. Die Ausnahme ist Chat and Cowork unified: Bei Bereitstellungen, die es nicht anbieten, werden seine Felder in der Antwort weggelassen. Einzelne Felder innerhalb dieser Objekte können `null` sein, was bedeutet, dass der Wert nicht verfügbar ist. Wenn du beispielsweise die Benutzeraktivität nach Projekt filterst, ist `distinct_skills_used_count` in `chat_metrics` `null`. Die [Claude Enterprise Analytics API-Referenz](https://platform.claude.com/docs/de/api/beta/organization/analytics) zeigt, welche Felder `null` sein können. **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 Dezimalzeichenfolgen in Cent.** Währungsbeträge werden als Dezimalzeichenfolgen wie `"41280.000000"` zurückgegeben (was 412,80 $ USD entspricht). Um in Dollar umzurechnen, parse den Wert als Dezimalzahl und teile ihn durch 100. Vermeide binäres Gleitkomma-Parsing für Werte, die mehrere Millionen Dollar überschreiten könnten. **Ratenlimits gelten auf Organisationsebene**, nicht pro Key, mit einem Standard von 60 Anfragen pro Minute über alle Endpunkte dieser API. Wenn das für deinen Anwendungsfall nicht ausreicht, wende dich an 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 [Versionen](https://platform.claude.com/docs/de/api/versioning). ## Bekannte Einschränkungen ### Claude Code über Amazon Bedrock 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. ### Claude Code und Cowork mit kundenverwalteten Verschlüsselungsschlüsseln Wenn deine Organisation [kundenverwaltete Verschlüsselungsschlüssel](https://platform.claude.com/docs/de/manage-claude/cmek) verwendet, lässt Anthropic zum Schutz deiner Daten einige Details der Claude Code- und Cowork-Nutzung aus seinen Nutzungsanalysen weg. Verwende daher die folgenden Zahlen der Claude Enterprise Analytics API nicht, um zu messen, wie stark deine Organisation Claude Code oder Cowork nutzt. Sie können 0 oder niedriger als die tatsächliche Nutzung sein: * **Codeänderungen:** In der Benutzeraktivität können diese Felder in `claude_code_metrics.core_metrics` 0 sein: `lines_of_code` (hinzugefügte und entfernte Zeilen) und `commit_count`. Das Feld `pull_request_count` kann niedriger sein als die tatsächliche Anzahl der Pull Requests. * **Mit einem Slash-Befehl gestartete Skills:** Wenn ein Benutzer einen Skill in Claude Code oder Cowork durch Eingabe eines Slash-Befehls wie `/skill-name` startet, wird diese Nutzung nicht gezählt. Dies gilt für die Skill-Nutzung und für Cowork-Skill-Zahlen in der Benutzeraktivität. Skills, die Claude ohne Slash-Befehl aufruft, werden weiterhin gezählt. Für weitere Analyseänderungen mit kundenverwalteten Verschlüsselungsschlüsseln siehe [Was CMEK auf Claude Enterprise abdeckt](https://platform.claude.com/docs/de/manage-claude/cmek-coverage-claude-enterprise#turned-off-or-changed). ## Nächste Schritte Verfolge Claude Code-Sitzungen, Codeänderungen und Tool-Nutzung mit einem Admin API-Key. Verfolge Token-Nutzung und Kosten für deine Organisation. Endpunktreferenz für Engagement-, Adoptions- und Kostendaten. Audit- und Compliance-Daten verwenden eigene Key-Typen.