---
title: API Analitik
url: https://platform.claude.com/docs/id/manage-claude/analytics-api
description: Pahami API analitik dan kunci API mana yang dibutuhkan organisasi Anda, lalu sediakan akses ke metrik produktivitas Claude Code atau data keterlibatan dan adopsi Claude Enterprise.
---
Anthropic menyediakan dua API analitik, dan API mana yang Anda gunakan bergantung pada produk Claude mana yang dikelola organisasi Anda:
* **Claude Code Analytics API** melaporkan metrik produktivitas Claude Code harian untuk organisasi yang menggunakan Claude Platform. API ini merupakan bagian dari [Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api) dan menggunakan kunci Admin API.
* **Claude Enterprise Analytics API** melaporkan data keterlibatan, adopsi, dan biaya di seluruh organisasi untuk berbagai produk Claude (chat, proyek, Claude Code, dan lainnya) bagi organisasi Claude Enterprise. API ini menggunakan kunci Analytics API yang dibuat di claude.ai.
Kedua API tersebut menggunakan jenis kunci yang berbeda, yang dibuat di tempat berbeda oleh peran yang berbeda. Halaman ini menjelaskan API mana yang sesuai untuk organisasi Anda dan cara membuat kunci yang tepat.
## API mana yang Anda butuhkan?
| API | Jenis kunci | Dibuat di | Siapa yang dapat membuatnya | Cakupan |
| ----------------------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Claude Code Analytics API** | Kunci Admin API (`sk-ant-admin01-...`) | Halaman [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) di Claude Console | Admin organisasi | Metrik Claude Code harian per pengguna: sesi, baris kode, commit, pull request, penerimaan alat, dan estimasi biaya per model |
| **Claude Enterprise Analytics API** | Kunci Analytics API | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Pemilik utama | Keterlibatan dan adopsi di seluruh organisasi (aktivitas pengguna, ringkasan pengguna aktif, penggunaan proyek, skill, dan konektor), ditambah laporan biaya dan penggunaan |
Jenis kunci ini tidak dapat dipertukarkan: kunci Admin API tidak dapat memanggil Claude Enterprise Analytics API, dan kunci Analytics API tidak dapat memanggil Admin API. Kedua API muncul di bawah [referensi Admin API](https://platform.claude.com/docs/id/api/beta/organization), tetapi keduanya adalah API terpisah dengan jenis kunci terpisah. Jika organisasi Anda menggunakan Claude Platform dan Claude Enterprise sekaligus, Anda dapat menyediakan kedua kunci dan menggunakan masing-masing API untuk datanya sendiri.
Mencari data penggunaan dan biaya API alih-alih analitik produk? Lihat
[Usage and Cost API](https://platform.claude.com/docs/id/manage-claude/usage-cost-api)
, yang menjelaskan jalur yang tepat untuk organisasi Claude Console maupun Claude Enterprise.
Jika Anda ingin melihat data keterlibatan dan adopsi di dalam produk alih-alih secara terprogram, gunakan [dasbor Analytics](https://claude.ai/analytics/activity) di claude.ai. Untuk kasus penggunaan tata kelola dan audit (tindakan pengguna individual, peristiwa aktivitas mentah, konten percakapan), lihat [Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-api-access).
## Mendapatkan akses ke Claude Code Analytics API
Claude Code Analytics API tersedia untuk setiap organisasi yang memiliki akses ke [Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api), dan gratis untuk digunakan.
Ikuti langkah-langkah di [Membuat kunci Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization).
Teruskan kunci di header `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"
```
Untuk metrik yang tersedia, parameter permintaan, dan skema respons, lihat [panduan Claude Code Analytics API](https://platform.claude.com/docs/id/manage-claude/claude-code-analytics-api) dan [referensi API](https://platform.claude.com/docs/id/api/beta/organization/usage_report/retrieve_claude_code).
## Mendapatkan akses ke Claude Enterprise Analytics API
Claude Enterprise Analytics API tersedia untuk organisasi Claude Enterprise. Data keterlibatan dan adopsi tersedia di semua paket Enterprise. Endpoint biaya dan penggunaan berlaku untuk paket Enterprise berbasis penggunaan; untuk paket Enterprise berbasis seat, endpoint tersebut hanya mencerminkan kredit penggunaan.
Hanya pemilik utama (primary owner) organisasi yang dapat mengaktifkan akses API dan membuat kunci Analytics API.
Buka [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) dan aktifkan akses API publik, lalu buat kunci Analytics API. Kunci membawa scope `read:analytics`. Salin secret yang ditampilkan dan simpan di pengelola secret Anda.
Teruskan kunci di header `x-api-key` dan sertakan header [`anthropic-version`](https://platform.claude.com/docs/id/api/versioning) pada setiap permintaan. Endpoint berada di bawah `https://api.anthropic.com/v1/organizations/analytics/`. Untuk contoh permintaan, parameter, dan skema respons, lihat [referensi Claude Enterprise Analytics API](https://platform.claude.com/docs/id/api/beta/organization/analytics).
Claude Enterprise Analytics API menyediakan:
* **Aktivitas pengguna:** metrik harian per pengguna di seluruh chat (percakapan, pesan, proyek, file, artifact), Claude Code (sesi, commit, pull request, baris kode, tindakan alat), Chat and Cowork unified (aktivitas chat dan sesi Cowork), serta produk Claude lainnya
* **Ringkasan aktivitas:** pengguna aktif harian, mingguan, dan bulanan tingkat organisasi, jumlah seat, dan undangan yang tertunda
* **Penggunaan proyek, skill, dan konektor:** rincian adopsi untuk proyek chat, skill, dan konektor
* **Laporan biaya dan penggunaan:** penggunaan token dan biaya per pengguna dan tingkat organisasi dari waktu ke waktu (paket Enterprise berbasis penggunaan)
Untuk detail endpoint, parameter, dan skema respons, lihat [referensi Claude Enterprise Analytics API](https://platform.claude.com/docs/id/api/beta/organization/analytics). Bagian-bagian berikut membahas kesegaran data, definisi metrik, dan panduan operasional yang berlaku di seluruh endpoint tersebut.
## Ketersediaan dan kesegaran data
Data Claude Enterprise Analytics API tersedia untuk tanggal pada atau setelah 1 Januari 2026.
**Endpoint keterlibatan dan adopsi** (aktivitas pengguna, ringkasan, proyek, skill, konektor) mengembalikan snapshot per hari untuk tanggal yang Anda tentukan. Data untuk hari tertentu biasanya tersedia sekitar pukul 13:00–13:30 UTC pada hari berikutnya (jeda 1 hari). Sebelum itu, hari terbaru yang tersedia biasanya adalah dua hari sebelum tanggal UTC saat ini. Data tiba lebih lambat pada hari-hari ketika pipeline data hulu berjalan terlambat, dan kesegaran pastinya bervariasi per kueri. Jadi, alih-alih mengasumsikan waktu yang tetap, periksa respons error: meminta tanggal yang belum tersedia akan mengembalikan error 400 yang menyebutkan hari terbaru yang tersedia. Jika data belum tersedia jauh melewati jeda yang biasa, hal ini biasanya menandakan kegagalan pipeline data di sisi Anthropic. Hubungi dukungan jika kesenjangan tersebut berlanjut.
**Endpoint biaya dan penggunaan** mengikuti model kesegaran yang berbeda. Data biasanya tersedia dalam empat jam setelah penggunaan yang mendasarinya tetapi dapat memakan waktu hingga 24 jam. Nilai dapat direvisi seiring datangnya peristiwa yang terlambat dan berjalannya rekonsiliasi, hingga sekitar 7 hari setelah akhir bulan kalender. Misalnya, nilai untuk 1 Oktober dapat berubah hingga sekitar 7 November. Untuk total setingkat penagihan, kueri hanya bulan-bulan yang berakhir setidaknya 7 hari yang lalu.
Respons biaya dan penggunaan menyertakan timestamp `data_refreshed_at`. Ketika `ending_at` dihilangkan (default-nya adalah waktu saat ini), respons menyertakan ekor data setelah `data_refreshed_at` yang belum lengkap. Untuk hasil yang stabil di seluruh panggilan berulang, atur `ending_at` ke nilai pada atau sebelum `data_refreshed_at` yang dikembalikan sebelumnya.
## Bagaimana metrik didefinisikan
**Pengguna aktif.** Seorang pengguna dihitung aktif untuk suatu hari jika salah satu dari hal berikut benar: mereka mengirim setidaknya satu pesan chat di Claude, mereka memiliki setidaknya satu sesi Claude Code (lokal atau jarak jauh) yang terkait dengan organisasi Claude Enterprise Anda yang mencakup penggunaan alat atau aktivitas git, atau mereka memiliki setidaknya satu sesi Cowork dengan penggunaan alat atau aktivitas pesan.
**Chat and Cowork unified (beta).** Chat and Cowork unified membawa fitur-fitur Cowork ke dalam chat claude.ai. Sebagian besar aktivitas di Chat and Cowork unified dilaporkan di bawah nilai produk `chat_cowork_unified`, bukan `chat` atau `cowork`.
Dalam aktivitas pengguna serta dalam penggunaan skill, konektor, dan plugin, penggunaan ini muncul di objek `chat_cowork_unified_metrics`. Dalam ringkasan aktivitas, penggunaan ini dihitung dalam `chat_cowork_unified_daily_active_user_count`, `chat_cowork_unified_weekly_active_user_count`, dan `chat_cowork_unified_monthly_active_user_count`.
Seiring semakin banyak pengguna mulai menggunakan Chat and Cowork unified, penggunaan berpindah dari angka chat dan Cowork Anda ke angka-angka baru ini. Penggunaan dari hari-hari sebelum seorang pengguna mulai menggunakan Chat and Cowork unified tetap berada di bawah chat atau Cowork. Angka di seluruh organisasi, seperti total penggunaan token, total biaya, dan jumlah pengguna aktif keseluruhan, tidak berubah. Laporan biaya dan penggunaan yang difilter berdasarkan produk tidak menyertakan penggunaan Chat and Cowork unified kecuali `products[]` menyertakan `chat_cowork_unified`.
Sebagian aktivitas dari pengguna Chat and Cowork unified, seperti mode suara, masih dapat dilaporkan di bawah chat atau Cowork. Aktivitas seorang pengguna juga dapat terbagi antar produk pada hari mereka mulai menggunakan Chat and Cowork unified. Hal yang sama berlaku pada hari fitur tersebut dinonaktifkan untuk mereka. Cara pembagian aktivitas tidak dijamin.
Seorang pengguna dapat muncul baik dalam hitungan chat atau Cowork maupun dalam hitungan Chat and Cowork unified. Hal ini dapat terjadi pada hari ketika mereka menggunakan Chat and Cowork unified dan sebagian aktivitas mereka masih dilaporkan di bawah chat atau Cowork. Hitungan mingguan dan bulanan dapat menyertakan mereka di keduanya ketika jendela waktu memiliki aktivitas dari kedua jenis, bahkan pada hari yang berbeda. Misalnya, jendela waktu tersebut mungkin mencakup hari-hari sebelum dan sesudah mereka mulai menggunakan Chat and Cowork unified.
Ketika Anda memfilter aktivitas pengguna berdasarkan proyek, aktivitas proyek setiap hari hanya dihitung di satu tempat. Jika seorang pengguna mengirim pesan chat di Chat and Cowork unified pada hari itu, semua aktivitas proyek mereka dihitung dalam `chat_cowork_unified_metrics.chat`. Jika tidak, aktivitas tersebut dihitung dalam `chat_metrics`.
**Blok metrik per produk.** Objek metrik per produk (misalnya, metrik Office Agent atau Cowork pada catatan aktivitas pengguna) selalu ada di setiap catatan. Organisasi tanpa penggunaan produk tersebut akan melihat nilai yang semuanya nol, bukan `null`. Pengecualiannya adalah Chat and Cowork unified: pada deployment yang tidak menawarkannya, field-nya dihilangkan dari respons.
**Nama konektor.** Nama konektor dinormalisasi di seluruh sumber. Misalnya, `Atlassian MCP server`, `mcp-atlassian`, dan `atlassian_MCP` semuanya muncul sebagai `atlassian` di endpoint penggunaan konektor.
## Bekerja dengan API
**Cursor paginasi terikat pada kueri yang menerbitkannya.** Pada endpoint biaya dan penggunaan, jangan mengubah parameter kueri di tengah urutan: jika Anda mengubah `products[]`, `group_by[]`, `order_by`, rentang tanggal, atau filter apa pun dan meneruskan cursor lama, permintaan akan mengembalikan error 400. Untuk mengubah parameter, mulai ulang dari halaman pertama tanpa cursor.
**Parameter daftar menggunakan notasi kurung siku.** Ulangi parameter untuk setiap nilai, misalnya `products[]=chat&products[]=claude_code`.
**Field jumlah adalah string desimal dalam sen.** Jumlah mata uang dikembalikan sebagai string desimal seperti `"41280.000000"` (yang merepresentasikan $412,80). Untuk mengonversi ke dolar, parse sebagai desimal dan bagi dengan 100. Hindari parsing floating-point biner untuk nilai yang mungkin melebihi beberapa juta dolar.
**Batas laju (rate limit) berlaku di tingkat organisasi**, bukan per kunci, dengan default 60 permintaan per menit di seluruh endpoint dalam API ini. Jika itu tidak mencukupi untuk kasus penggunaan Anda, hubungi tim akun Anthropic Anda untuk mendiskusikan penyesuaian batas tersebut.
## Pembuatan versi
Kirim header `anthropic-version` pada setiap permintaan; lihat [versi API](https://platform.claude.com/docs/id/api/versioning) untuk versi yang tersedia.
## Keterbatasan yang diketahui
Jika organisasi Anda menggunakan Claude Code melalui Amazon Bedrock, Claude Enterprise Analytics API tidak mengembalikan aktivitas Claude Code untuk penggunaan tersebut.
## Langkah selanjutnya
Lacak sesi Claude Code, perubahan kode, dan penggunaan alat dengan kunci Admin API.
Lacak penggunaan token API dan biaya untuk organisasi Anda.
Referensi endpoint untuk data keterlibatan, adopsi, dan biaya.
Data audit dan kepatuhan menggunakan jenis kuncinya sendiri.