Claude Enterprise Analytics API リファレンスガイド

概要

Claude Enterprise Analytics APIは、Enterprise組織内のClaudeおよびClaude Codeの使用に関するエンゲージメントデータへのプログラマティックアクセスを提供します。ユーザーアクティビティの内部ダッシュボードを構築する場合でも、プロジェクトの採用状況を追跡する場合でも、このAPIは必要な集計メトリクスを提供します。

データ集計

すべてのデータは組織ごと、日ごとに集計されます。各エンドポイントは、指定した単一の日付のスナップショットを返します。日(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キーが見つからない、無効である、または`read:analytics`スコープを持っていません。
429	レート制限を超過しました。リクエストが多すぎます。
503	一時的な障害です。もう一度お試しください。

レート制限

デフォルトのレート制限が設定されています。ユースケースに十分でない場合は、その理由を理解したいと思います。必要に応じて、組織のレート制限を調整できます。CSMにお問い合わせください。

エンドポイント

1. ユーザーアクティビティをリストする

GET /v1/organizations/analytics/users

単一の日のユーザーごとのエンゲージメントメトリクスを返します。レスポンス内の各項目は1人のユーザーを表し、Claude（チャット）とClaude Code全体のアクティビティカウントを含みます。

クエリパラメータ

フィールド	タイプ	必須	説明
`date`	文字列	はい	メトリクスを取得する日付（YYYY-MM-DD形式）。
`limit`	整数	いいえ	ページあたりのレコード数（デフォルト：20、最大：1000）。
`page`	文字列	いいえ	前のレスポンスの`next_page`フィールドからのカーソルトークン（次のページを取得するため）。

レスポンスフィールド（ユーザーごと）

フィールド	説明
`user.id`	ユーザーの一意の識別子。
`user.email_address`	ユーザーのメールアドレス。
`chat_metrics.distinct_conversation_count`	個別の会話数（Claude.ai内）。
`chat_metrics.message_count`	送信されたメッセージの総数（Claude.ai内）。
`chat_metrics.distinct_projects_created_count`	作成されたプロジェクト数（Claude.ai内）。
`chat_metrics.distinct_projects_used_count`	使用された個別プロジェクト数（Claude.ai内）。
`chat_metrics.distinct_files_uploaded_count`	アップロードされたファイル数（Claude.ai内）。
`chat_metrics.distinct_artifacts_created_count`	作成されたアーティファクト数（Claude.ai内）。
`chat_metrics.thinking_message_count`	思考（拡張）メッセージ数（Claude.ai内）。
`chat_metrics.distinct_skills_used_count`	使用された個別スキル数（Claude.ai内）。
`chat_metrics.connectors_used_count`	呼び出されたコネクタの総数（Claude.ai内）。
`claude_code_metrics.core_metrics.commit_count`	Claude Codeを介して行われたgitコミット数。
`claude_code_metrics.core_metrics.pull_request_count`	Claude Codeを介して作成されたプルリクエスト数。
`claude_code_metrics.core_metrics.lines_of_code.added_count`	追加されたコード行の総数。
`claude_code_metrics.core_metrics.lines_of_code.removed_count`	削除されたコード行の総数。
`claude_code_metrics.core_metrics.distinct_session_count`	個別のClaude Codeセッション数。
`claude_code_metrics.tool_actions.edit_tool`	Editツールの承認および却下カウント。
`claude_code_metrics.tool_actions.multi_edit_tool`	Multi-Editツールの承認および却下カウント。
`claude_code_metrics.tool_actions.write_tool`	Writeツールの承認および却下カウント。
`claude_code_metrics.tool_actions.notebook_edit_tool`	ノートブック編集ツールの受け入れ数と拒否数。
`web_search_count`	ウェブ検索ツール呼び出しの合計。これはclaude.aiと組織内のClaudeコード使用の両方に適用されます。

Office Agentメトリクス（ユーザーあたり）

各ユーザーレコードには、ExcelとPowerPointの製品別内訳を含むoffice_metricsオブジェクトも含まれます。このブロックはすべてのレコードに常に存在します。Office Agent使用がない組織では、nullではなくすべてゼロ値が表示されます。

office_metricsオブジェクトには、excelとpowerpointの2つのキーが含まれています。

各キーには同じ6つのフィールドが含まれています。

フィールド	説明
`office_metrics.[product].distinct_session_count*`	個別のOffice Agentセッション数。
`office_metrics.[product].message_count`	送信されたメッセージ数（完了したエージェントターンごとに1つ）。
`office_metrics.[product].skills_used_count`	スキル呼び出しの合計。1つのスキルが5回使用された場合は5としてカウントされます。
`office_metrics.[product].distinct_skills_used_count`	使用された個別スキルの数。
`office_metrics.[product].connectors_used_count`	コネクタ呼び出しの合計。1つのコネクタが3回使用された場合は3としてカウントされます。
`office_metrics.[product].distinct_connectors_used_count`	使用された個別コネクタの数。

*注： [product]はexcelまたはpowerpointのいずれかです。

リクエスト例

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

指定された日付範囲について、組織の日ごとのエンゲージメントとシート利用率の高レベルサマリーを返します。レスポンスは、日付範囲内の集計カウントを含む日のリストです。ending_dateとstarting_dateの最大差は31日である必要があり、データ利用可能性に3日の遅延があることに注意してください。これは、日次アクティブユーザー、週次および月次トレンド、シート割り当てを一目で追跡するのに役立ちます。

「アクティブ」の定義以下のいずれかが当てはまる場合：

ユーザーがClaudeで少なくとも1つのチャットメッセージを送信した（チャット）。
ユーザーがC4E組織に関連付けられたClaudeコード（ローカルまたはリモート）セッションを少なくとも1つ持っていて、ツール使用/gitアクティビティがある。

クエリパラメータ

フィールド	タイプ	必須	説明
`starting_date`	文字列	はい	データを取得する開始日（YYYY-MM-DD形式）。データ利用可能性に3日の遅延があるため、アクセスできる最新データは3日前のものです。
`ending_date`	文字列	いいえ	データを取得するオプションの終了日（YYYY-MM-DD形式）。これは排他的です。

レスポンスフィールド

フィールド	説明
`starting_date`	メトリクスが集計される最初の日（UTC日付として解釈）。データ利用可能性に3日の遅延があるため、アクセスできる最新データは3日前のものです。
`ending_date`	メトリクスが集計される最後の日（排他的、UTC日付として解釈）
`daily_active_user_count`	指定された日付でアクティブなユーザー数（トークン消費に基づく）。
`weekly_active_user_count`	指定された日付で終了する7日間のローリングウィンドウ内でアクティブなユーザー数。
`monthly_active_user_count`	指定された日付で終了する30日間のローリングウィンドウ内でアクティブなユーザー数。
`assigned_seat_count`	組織内で現在割り当てられているシート総数。
`pending_invite_count`	まだ受け入れられていない保留中の招待数。

注：週次および月次カウントのローリングウィンドウは、指定された日付から遡ります（その日を含む）。ウィンドウ内の一部の日のデータが不完全な場合（例えば、日付が過去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（チャット）に固有であるため、このエンドポイントはそのサーフェスに焦点を当てています。各項目は、プロジェクト名、それと相互作用したユニークユーザー数、およびそのプロジェクトで行われた会話の総数を表示します。

クエリパラメータ

フィールド	タイプ	必須	説明
`date`	文字列	はい	メトリクスを取得する日付（YYYY-MM-DD形式）。データの可用性には3日間の遅延があるため、アクセスできる最新データは3日前のものです。
`limit`	整数	いいえ	ページあたりのレコード数（デフォルト：100、最大：1000）。
`page`	文字列	いいえ	前のレスポンスの`next_page`フィールドからのカーソルトークン（次のページを取得するため）。

レスポンスフィールド（プロジェクトごと）

フィールド	説明
`project_name`	プロジェクトの名前。
`project_id`	タグ付きプロジェクトID（例："claude_proj_{ID}"）。
`distinct_user_count`	指定された日付にこのプロジェクトを使用したユニークユーザー数。
`distinct_conversation_count`	指定された日付にこのプロジェクト内の会話数。
`message_count`	指定された日付にこのプロジェクト内で送信されたメッセージの総数。
`created_at`	プロジェクト作成のタイムスタンプ。
`created_by`	プロジェクトを作成したユーザーの`{id, email_address}`。

リクエスト例

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両方におけるスキル使用データを指定日付について返します。各項目はスキルを表し、それを使用した一意のユーザー数を示します。

クエリパラメータ

フィールド	タイプ	必須	説明
`date`	string	はい	メトリクスを取得する日付。YYYY-MM-DD形式です。データの利用可能性には3日間の遅延があるため、アクセスできる最新データは3日前のものです。
`limit`	integer	いいえ	ページあたりのレコード数（デフォルト：100、最大：1000）。
`page`	string	いいえ	前のレスポンスの`next_page`フィールドからのカーソルトークン。次のページを取得するために使用します。

レスポンスフィールド（スキルごと）

フィールド	説明
`skill_name`	スキルの名前。
`distinct_user_count`	指定日付にこのスキルを使用した一意のユーザー数。
`chat_metrics.distinct_conversation_skill_used_count`	チャットでスキルが少なくとも1回使用された個別の会話数。
`claude_code_metrics.distinct_session_skill_used_count`	Claude Codeでスキルが少なくとも1回使用された個別のリモートセッション数。

Office Agentメトリクス（スキルごと）

各スキルレコードには、Office Agentセッションがスキルを使用した数を製品別に分類して報告するoffice_metricsオブジェクトも含まれます。このブロックは常に存在します。Office Agent使用がない組織は、すべてゼロの値を表示します。

フィールド	説明
`office_metrics.excel.distinct_session_skill_used_count`	このスキルが使用されたExcelのOffice Agentセッションの個別数。
`office_metrics.powerpoint.distinct_session_skill_used_count`	このスキルが使用されたPowerPointのOffice Agentセッションの個別数。

リクエスト例

curl -X GET "https://api.anthropic.com/v1/organizations/analytics/skills?date=2025-01-01"
   --header "x-api-key: $YOUR_API_KEY"

5. コネクタ使用

GET /v1/organizations/analytics/connectors

組織内のClaude（チャット）とClaude Code両方におけるMCP/コネクタ使用データを指定日付について返します。各項目はコネクタを表し、それを使用した一意のユーザー数を示します。コネクタ名はさまざまなソースから正規化されます。たとえば、「Atlassian MCP server」「mcp-atlassian」「atlassian_MCP」はすべて「atlassian」として表示されます。

クエリパラメータ

フィールド	タイプ	必須	説明
`date`	string	はい	メトリクスを取得する日付（YYYY-MM-DD形式）。データの利用可能性には3日間の遅延があるため、アクセスできる最新データは3日前のものです。
`limit`	整数	いいえ	ページあたりのレコード数（デフォルト：100、最大：1000）。
`page`	文字列	いいえ	前のレスポンスの`next_page`フィールドからのカーソルトークン（次のページを取得するため）。

レスポンスフィールド（コネクタごと）

フィールド	説明
`connector_name`	コネクタの正規化された名前。
`distinct_user_count`	指定された日付にこのコネクタを使用した一意のユーザー数。
`chat_metrics.distinct_conversation_connector_used_count`	チャットでコネクタが少なくとも1回使用された個別の会話数。
`claude_code_metrics.distinct_session_connector_used_count`	Claude Codeでスキルが少なくとも1回使用された個別のリモートセッション数。

Office Agentメトリクス（コネクタごと）

各コネクタレコードには、Office Agentセッションがコネクタを使用した回数を製品別に報告するoffice_metricsオブジェクトも含まれます。このブロックは常に存在します。Office Agent使用がない組織では、すべてのゼロ値が表示されます。

フィールド	説明
`office_metrics.excel.distinct_session_connector_used_count`	このコネクタが使用されたExcelのOffice Agentセッションの個別数。
`office_metrics.powerpoint.distinct_session_connector_used_count`	このコネクタが使用されたPowerPointのOffice Agentセッションの個別数。

リクエスト例

curl -X GET "https://api.anthropic.com/v1/organizations/analytics/connectors?date=2025-01-01"
   --header "x-api-key: $YOUR_API_KEY"

Slack で Claude を始める

ExcelでClaudeを使用する

Claude for PowerPoint を使用する

Analytics APIでエンゲージメントと導入データにアクセスする

サードパーティプラットフォームでExcelおよびPowerPointのClaudeを使用する