概要
Claude Enterprise Analytics APIは、Enterprise組織内のClaudeおよびClaude Codeの使用に関するエンゲージメントデータへのプログラマティックアクセスを提供します。ユーザーアクティビティの内部ダッシュボードを構築する場合でも、プロジェクトの採用を追跡する場合でも、このAPIは必要な集計メトリクスを提供します。
データ集計
すべてのデータは組織ごと、1日ごとに集計されます。各エンドポイントは、指定した単一の日付のスナップショットを返します。日(N-1)のデータは日Nの10:00:00 UTC時刻に実行され、データの正確性を確保するために集計から3日後に照会可能になります。
上記のタイムライン内でデータが利用できない場合、これは通常、当社のチームが内部で調査する必要があるデータパイプラインの障害を示しています。通常、このような問題は認識していますが、確認が必要な場合やその他の問題が疑われる場合は、CSMに報告してください。
アクセスの有効化
新しい分析APIキーを生成するには、Enterprise組織内のプライマリオーナーである必要があります。claude.ai/analytics/api-keysに移動することで実行できます。
役立つ可能性のある詳細情報：
いつでも公開APIへのアクセスを有効/無効にできます。スイッチをオフにしてアクセスを無効にすると、すべてのリクエストが拒否されます。
APIにアクセスするには、
read:analyticsスコープを持つキーが必要です。組織用に複数のキーを作成できますが、レート制限はキーレベルではなく組織レベルで適用されます。以下の「レート制限」セクションを参照してください。いつものように、APIキーを安全に処理することを強くお勧めします：これらのキーを公開で共有しないでください。これらはシークレットであり、安全に共有する必要があります。
ベースURL
すべてのリクエストは以下に送信されます：
https://api.anthropic.com/v1/organizations/analytics/
認証
すべてのリクエストには、x-api-keyヘッダーで渡されるAPIキーが必要です。APIキーはread:analyticsスコープを持つ必要があります。APIキーはclaude.ai管理設定のAPIキーセクションから作成および管理できます。
リクエストヘッダーの例：
x-api-key: $YOUR_API_KEY
ページネーション
複数のエンドポイントはページネーション結果を返します。ページネーションはカーソルベースのアプローチを使用し、レスポンスには次のリクエストで渡すnext_pageトークンが含まれ、結果の次のページを取得します。
2つのオプションパラメータがページネーションを制御します：
limit（整数）：ページあたりのレコード数。/usersエンドポイントのデフォルトは20、その他すべてのエンドポイントのデフォルトは100です。最大値は1000です。
page（文字列）：前のレスポンスのnext_pageフィールドからの不透明なカーソルトークン。最初のリクエストではこれを省略します。
結果がなくなると、レスポンスのnext_pageはnullになります。
エラーレスポンス
すべてのエンドポイントは標準HTTPエラーコードを返します：
コード | 意味 |
400 | クエリパラメータが無効です。一般的な原因には、無効な日付、1/1/26より前の日付（最初の利用可能日）、または今日以降の日付が含まれます。データの利用可能性は3日遅延しています。 |
404 | APIキーが見つからない、無効である、または |
429 | レート制限を超過しました。リクエストが多すぎます。 |
503 | 一時的な障害です。再試行してください。 |
レート制限
デフォルトのレート制限が設定されています。ユースケースに十分でない場合は、その理由を理解したいと思います。必要に応じて、組織のレート制限を調整できます。CSMにお問い合わせください。
エンドポイント
1. ユーザーアクティビティのリスト
GET /v1/organizations/analytics/users
単一の日付のユーザーごとのエンゲージメントメトリクスを返します。レスポンス内の各項目は1人のユーザーを表し、ClaudeおよびClaude Code全体のアクティビティカウントを含みます。
クエリパラメータ
フィールド | タイプ | 必須 | 説明 |
| 文字列 | はい | メトリクスを取得する日付（YYYY-MM-DD形式）。 |
| 整数 | いいえ | ページあたりのレコード数（デフォルト：20、最大：1000）。 |
| 文字列 | いいえ | 前のレスポンスの |
レスポンスフィールド（ユーザーごと）
フィールド | 説明 |
| ユーザーの一意の識別子。 |
| ユーザーのメールアドレス。 |
| 個別の会話数（特にClaude.ai内）。 |
| 送信されたメッセージの総数（特にClaude.ai内）。 |
| 作成されたプロジェクト数（特にClaude.ai内）。 |
| 使用された個別プロジェクト数（特にClaude.ai内）。 |
| アップロードされたファイル数（特にClaude.ai内）。 |
| 作成されたアーティファクト数（特にClaude.ai内）。 |
| 思考（拡張）メッセージの数（特にClaude.ai内）。 |
| 使用された個別スキル数（特にClaude.ai内）。 |
| 呼び出されたコネクタの総数（特にClaude.ai内）。 |
| Claude Codeを介して行われたgitコミット数。 |
| Claude Codeを介して作成されたプルリクエスト数。 |
| 追加されたコード行の総数。 |
| 削除されたコード行の総数。 |
| 個別のClaude Codeセッション数。 |
| 編集ツールの受け入れ数と拒否数。 |
| マルチ編集ツールの受け入れ数と拒否数。 |
| 書き込みツールの受け入れ数と拒否数。 |
| ノートブック編集ツールの受け入れ数と拒否数。 |
| ウェブ検索ツール呼び出しの総数。これは、組織内のclaude.aiとclaude codeの使用の両方に適用されます。 |
リクエストの例
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. アクティビティサマリー
GET /v1/organizations/analytics/summaries
指定された日付範囲の組織の1日ごとのエンゲージメントとシート利用率の高レベルサマリーを返します。レスポンスは、日付範囲内の集計カウントを含む日のリストです。ending_dateとstarting_dateの最大差は31日である必要があり、データの利用可能性に3日の遅延があります。これは、日次アクティブユーザー、週次および月次トレンド、シート割り当てを一目で追跡するのに役立ちます。
「アクティブ」の定義：以下のいずれかが当てはまる場合：
ユーザーがClaude（チャット）で少なくとも1つのチャットメッセージを送信した。
ユーザーがC4E組織に関連付けられたClaude Code（ローカルまたはリモート）セッションを少なくとも1つ持ち、ツール使用/gitアクティビティがある。
クエリパラメータ
フィールド | タイプ | 必須 | 説明 |
| 文字列 | はい | データを取得する開始日（YYYY-MM-DD形式）。データの利用可能性に3日の遅延があるため、アクセスできる最新のデータは3日前のものです。 |
| 文字列 | いいえ | データを取得するオプションの終了日（YYYY-MM-DD形式）。これは排他的です。 |
レスポンスフィールド
フィールド | 説明 |
| メトリクスが集計される最初の日（UTC日付として解釈）。データの利用可能性に3日の遅延があるため、アクセスできる最新のデータは3日前のものです。 |
| メトリクスが集計される最後の日（排他的、UTC日付として解釈）。 |
| 指定された日付にアクティブなユーザー数（トークン消費に基づく）。 |
| 指定された日付で終了する7日間のローリングウィンドウ内でアクティブなユーザー数。 |
| 指定された日付で終了する30日間のローリングウィンドウ内でアクティブなユーザー数。 |
| 組織内で現在割り当てられているシートの総数。 |
| まだ受け入れられていない保留中の招待数。 |
注：週次および月次カウントのローリングウィンドウは、指定された日付から後方を見ます（包括的）。ウィンドウ内の一部の日のデータが不完全な場合（たとえば、日付が過去30日未満の場合）、月次カウントはアクティビティを過小計上する可能性があります。
リクエストの例
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/summaries?starting_date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
3. チャットプロジェクト使用状況
GET /v1/organizations/analytics/apps/chat/projects
指定された日付のチャットプロジェクト別に分類された使用データを返します。プロジェクトはClaude（チャット）に固有であるため、このエンドポイントはそのサーフェスに焦点を当てています。各項目は、プロジェクト名、それと相互作用したユニークユーザー数、およびそのプロジェクトで行われた会話の総数を示します。
クエリパラメータ
フィールド | タイプ | 必須 | 説明 |
| 文字列 | はい | メトリクスを取得する日付（YYYY-MM-DD形式）。データの利用可能性に3日の遅延があるため、アクセスできる最新のデータは3日前のものです。 |
| 整数 | いいえ | ページあたりのレコード数（デフォルト：100、最大：1000）。 |
| 文字列 | いいえ | 前のレスポンスの |
レスポンスフィールド（プロジェクトごと）
フィールド | 説明 |
| プロジェクトの名前。 |
| タグ付きプロジェクトID（例：「claude_proj_{ID}」）。 |
| 指定された日付にこのプロジェクトを使用したユニークユーザー数。 |
| 指定された日付のこのプロジェクト内の会話数。 |
| 指定された日付にこのプロジェクト内で送信されたメッセージの総数。 |
リクエストの例
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. スキル使用状況
GET /v1/organizations/analytics/skills
指定された日付の組織内のClaude（チャット）とClaude Code全体のスキル使用データを返します。各項目はスキルを表し、それを使用したユニークユーザー数を示します。
クエリパラメータ
フィールド | タイプ | 必須 | 説明 |
| 文字列 |