---
title: Analytics API
url: https://platform.claude.com/docs/ja/manage-claude/analytics-api
description: 組織に必要なアナリティクスAPIとAPIキーを理解し、Claude Codeの生産性メトリクスまたはClaude Enterpriseのエンゲージメントおよび導入データへのアクセスをプロビジョニングします。
---
Anthropicは2つのアナリティクスAPIを提供しており、どちらを使用するかは、組織が管理しているClaude製品によって決まります。
* **Claude Code Analytics API**は、Claude Platformを使用する組織向けに、日次のClaude Code生産性メトリクスをレポートします。これは[Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)の一部であり、Admin APIキーを使用します。
* **Claude Enterprise Analytics API**は、Claude Enterprise組織向けに、Claude製品（チャット、プロジェクト、Claude Codeなど）全体にわたる組織全体のエンゲージメント、導入、コストデータをレポートします。これはclaude.aiで作成されたAnalytics APIキーを使用します。
この2つのAPIは、異なる場所で異なるロールによって作成される、異なる種類のキーを使用します。このページでは、どのAPIが組織に適しているか、および適切なキーの作成方法について説明します。
## どのAPIが必要ですか？
| API | キーの種類 | 作成場所 | 作成できるユーザー | 対象範囲 |
| ----------------------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------- |
| **Claude Code Analytics API** | Admin APIキー（`sk-ant-admin01-...`） | Claude Consoleの[Admin keys](https://platform.claude.com/settings/admin-keys)ページ（`platform.claude.com/settings/admin-keys`） | 組織管理者 | ユーザーごとの日次Claude Codeメトリクス：セッション、コード行数、コミット、プルリクエスト、ツール承認、モデル別の推定コスト |
| **Claude Enterprise Analytics API** | Analytics APIキー | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | プライマリオーナー | 組織全体のエンゲージメントと導入（ユーザーアクティビティ、アクティブユーザーのサマリー、プロジェクト、スキル、コネクターの使用状況）、およびコストと使用状況のレポート |
これらのキーの種類は互換性がありません。Admin APIキーではClaude Enterprise Analytics APIを呼び出すことはできず、Analytics APIキーではAdmin APIを呼び出すことはできません。どちらのAPIも[Admin APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization)に掲載されていますが、それぞれ別のキーの種類を持つ別個のAPIです。組織がClaude PlatformとClaude Enterpriseの両方を使用している場合は、両方のキーをプロビジョニングし、それぞれのAPIをそれぞれのデータに使用できます。
製品アナリティクスではなく、APIの使用状況とコストデータをお探しですか？
[Usage and Cost API](https://platform.claude.com/docs/ja/manage-claude/usage-cost-api)
を参照してください。Claude Console組織とClaude Enterprise組織の両方に適した方法を説明しています。
エンゲージメントと導入データをプログラムからではなく製品内で確認したい場合は、claude.aiの[アナリティクスダッシュボード](https://claude.ai/analytics/activity)を使用してください。ガバナンスおよび監査のユースケース（個々のユーザーアクション、生のアクティビティイベント、会話内容）については、[Compliance API](https://platform.claude.com/docs/ja/manage-claude/compliance-api-access)を参照してください。
## Claude Code Analytics APIへのアクセスを取得する
Claude Code Analytics APIは、[Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)にアクセスできるすべての組織で利用でき、無料で使用できます。
[Admin APIキーを作成する](https://platform.claude.com/docs/ja/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization)の手順に従ってください。
`x-api-key`ヘッダーにキーを渡します。
```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"
```
利用可能なメトリクス、リクエストパラメータ、レスポンススキーマについては、[Claude Code Analytics APIガイド](https://platform.claude.com/docs/ja/manage-claude/claude-code-analytics-api)および[APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization/usage_report/retrieve_claude_code)を参照してください。
## Claude Enterprise Analytics APIへのアクセスを取得する
Claude Enterprise Analytics APIは、Claude Enterprise組織で利用できます。エンゲージメントと導入データは、すべてのEnterpriseプランで利用できます。コストと使用状況のエンドポイントは、使用量ベースのEnterpriseプランに適用されます。シートベースのEnterpriseプランでは、使用クレジットのみが反映されます。
APIアクセスを有効にしてAnalytics APIキーを作成できるのは、組織のプライマリオーナーのみです。
[claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access)に移動してパブリックAPIアクセスを有効にし、Analytics APIキーを作成します。キーには`read:analytics`スコープが付与されます。表示されたシークレットをコピーし、シークレットマネージャーに保存してください。
`x-api-key`ヘッダーでキーを渡し、すべてのリクエストに[`anthropic-version`](https://platform.claude.com/docs/ja/api/versioning)ヘッダーを含めます。エンドポイントは`https://api.anthropic.com/v1/organizations/analytics/`の下にあります。リクエストの例、パラメータ、レスポンススキーマについては、[Claude Enterprise Analytics APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization/analytics)を参照してください。
Claude Enterprise Analytics APIは以下を提供します。
* **ユーザーアクティビティ：** チャット（会話、メッセージ、プロジェクト、ファイル、アーティファクト）、Claude Code（セッション、コミット、プルリクエスト、コード行数、ツールアクション）、Chat and Cowork unified（チャットアクティビティとCoworkセッション）、およびその他のClaude製品にわたるユーザーごとの日次メトリクス
* **アクティビティサマリー：** 組織レベルの日次、週次、月次のアクティブユーザー、シート数、保留中の招待
* **プロジェクト、スキル、コネクターの使用状況：** チャットプロジェクト、スキル、コネクターの導入状況の内訳
* **コストと使用状況のレポート：** ユーザーごとおよび組織レベルのトークン使用量とコストの時系列推移（使用量ベースのEnterpriseプラン）
エンドポイントの詳細、パラメータ、レスポンススキーマについては、[Claude Enterprise Analytics APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization/analytics)を参照してください。以下のセクションでは、これらのエンドポイント全体に適用されるデータの鮮度、メトリクスの定義、運用上のガイダンスについて説明します。
## データの可用性と鮮度
Claude Enterprise Analytics APIのデータは、2026年1月1日以降の日付について利用できます。
**エンゲージメントと導入状況のエンドポイント**（ユーザーアクティビティ、サマリー、プロジェクト、スキル、コネクタ）は、指定した日付の1日単位のスナップショットを返します。ある日のデータは通常、翌日のUTC 13:00～13:30頃までに利用可能になります（1日の遅延）。それまでは、利用可能な最新の日付は通常、現在のUTC日付の2日前です。上流のデータパイプラインの処理が遅れた日はデータの到着も遅くなり、正確な鮮度はクエリによって異なります。そのため、固定の時刻を前提とせず、エラーレスポンスを確認してください。まだ利用できない日付をリクエストすると、利用可能な最新の日付を示す400エラーが返されます。通常の遅延を大幅に過ぎてもデータが利用できない場合は、通常、Anthropic側のデータパイプラインの障害を示しています。この状態が続く場合はサポートにお問い合わせください。
**コストと使用状況のエンドポイント**は、異なる鮮度モデルに従います。データは通常、基となる使用から4時間以内に利用可能になりますが、最大24時間かかる場合があります。遅れて到着するイベントや照合処理の実行に伴い、値は暦月の終了後約7日まで修正される可能性があります。たとえば、10月1日の値は11月7日頃まで変更される可能性があります。請求書レベルの正確な合計値が必要な場合は、終了から少なくとも7日が経過した月のみをクエリしてください。
コストと使用状況のレスポンスには`data_refreshed_at`タイムスタンプが含まれます。`ending_at`を省略した場合（デフォルトは現在時刻）、レスポンスには`data_refreshed_at`以降の不完全なデータの末尾部分が含まれます。繰り返しの呼び出しで安定した結果を得るには、`ending_at`を以前に返された`data_refreshed_at`以前の値に設定してください。
## メトリクスの定義方法
**アクティブユーザー。** ユーザーは、次のいずれかに該当する場合、その日のアクティブユーザーとしてカウントされます。Claudeで少なくとも1件のチャットメッセージを送信した場合、Claude Enterprise組織に関連付けられた、「tool use」（ツール使用）またはgitアクティビティを含むClaude Codeセッション（ローカルまたはリモート）が少なくとも1件あった場合、またはツール使用もしくはメッセージアクティビティを含むCoworkセッションが少なくとも1件あった場合です。
**Chat and Cowork unified（ベータ）。** Chat and Cowork unifiedは、Coworkの機能をclaude.aiのチャットに取り込むものです。Chat and Cowork unifiedでのアクティビティのほとんどは、`chat`や`cowork`ではなく、`chat_cowork_unified`という製品値でレポートされます。
ユーザーアクティビティ、およびスキル、コネクター、プラグインの使用状況では、この使用量は`chat_cowork_unified_metrics`オブジェクトに表示されます。アクティビティサマリーでは、`chat_cowork_unified_daily_active_user_count`、`chat_cowork_unified_weekly_active_user_count`、`chat_cowork_unified_monthly_active_user_count`でカウントされます。
Chat and Cowork unifiedを使い始めるユーザーが増えるにつれて、使用量はチャットおよびCoworkの数値からこれらの新しい数値へと移行します。ユーザーがChat and Cowork unifiedを使い始める前の日の使用量は、チャットまたはCoworkの下に残ります。総トークン使用量、総コスト、全体のアクティブユーザー数などの組織全体の数値は変わりません。製品でフィルタリングしたコストと使用状況のレポートでは、`products[]`に`chat_cowork_unified`が含まれていない限り、Chat and Cowork unifiedの使用量は除外されます。
Chat and Cowork unifiedのユーザーによる一部のアクティビティ（音声モードなど）は、引き続きチャットまたはCoworkの下でレポートされる場合があります。また、ユーザーがChat and Cowork unifiedを使い始めた日には、そのユーザーのアクティビティが製品間で分割される場合があります。そのユーザーに対して無効化された日も同様です。アクティビティがどのように分割されるかは保証されません。
ユーザーは、チャットまたはCoworkのカウントと、Chat and Cowork unifiedのカウントの両方に表示される場合があります。これは、ユーザーがChat and Cowork unifiedを使用した日に、そのアクティビティの一部が引き続きチャットまたはCoworkの下でレポートされた場合に起こり得ます。週次および月次のカウントでは、期間内に両方の種類のアクティビティがある場合、たとえ別々の日であっても、そのユーザーが両方に含まれることがあります。たとえば、期間がChat and Cowork unifiedを使い始める前と後の日にまたがる場合などです。
ユーザーアクティビティをプロジェクトでフィルタリングする場合、各日のプロジェクトアクティビティは1か所でのみカウントされます。ユーザーがその日にChat and Cowork unifiedでチャットメッセージを送信した場合、そのユーザーのプロジェクトアクティビティはすべて`chat_cowork_unified_metrics.chat`でカウントされます。それ以外の場合は、`chat_metrics`でカウントされます。
**製品ごとのメトリクスブロック。** 製品ごとのメトリクスオブジェクト（たとえば、ユーザーアクティビティレコード上のOffice AgentやCoworkのメトリクス）は、すべてのレコードに常に存在します。その製品を使用していない組織では、`null`ではなくすべてゼロの値が表示されます。例外はChat and Cowork unifiedで、これを提供していないデプロイメントでは、そのフィールドはレスポンスから除外されます。
**コネクター名。** コネクター名はソース間で正規化されます。たとえば、`Atlassian MCP server`、`mcp-atlassian`、`atlassian_MCP`はすべて、コネクター使用状況エンドポイントでは`atlassian`として表示されます。
## APIの操作
**ページネーションカーソルは、それを発行したクエリに紐付けられています。** コストと使用状況のエンドポイントでは、シーケンスの途中でクエリパラメータを変更しないでください。`products[]`、`group_by[]`、`order_by`、日付範囲、またはいずれかのフィルターを変更して古いカーソルを渡すと、リクエストは400エラーを返します。パラメータを変更するには、カーソルなしで最初のページからやり直してください。
**リストパラメータはブラケット記法を使用します。** 値ごとにパラメータを繰り返します。たとえば`products[]=chat&products[]=claude_code`のようにします。
**金額フィールドはセント単位の10進数文字列です。** 通貨金額は`"41280.000000"`（$412.80を表します）のような10進数文字列として返されます。ドルに変換するには、10進数として解析して100で割ります。数百万ドルを超える可能性のある値については、2進浮動小数点数による解析を避けてください。
**「rate limit」（レート制限）は組織レベルで適用され**、キーごとではありません。このAPIのすべてのエンドポイント全体で、デフォルトは1分あたり60リクエストです。ユースケースに対して十分でない場合は、Anthropicのアカウントチームに連絡して制限の調整についてご相談ください。
## バージョニング
すべてのリクエストで`anthropic-version`ヘッダーを送信してください。利用可能なバージョンについては、[APIバージョン](https://platform.claude.com/docs/ja/api/versioning)を参照してください。
## 既知の制限事項
組織がAmazon Bedrock経由でClaude Codeを使用している場合、Claude Enterprise Analytics APIはその使用分のClaude Codeアクティビティを返しません。
## 次のステップ
Admin APIキーを使用して、Claude Codeのセッション、コード変更、ツール使用状況を追跡します。
組織のAPIトークン使用量とコストを追跡します。
エンゲージメント、導入、コストデータのエンドポイントリファレンス。
監査およびコンプライアンスデータには独自のキーの種類を使用します。