Anthropic menyediakan dua API analytics, dan mana yang Anda gunakan bergantung pada produk Claude mana yang dikelola organisasi Anda:
Kedua API ini menggunakan jenis kunci yang berbeda, dibuat di tempat yang berbeda oleh peran yang berbeda. Halaman ini menjelaskan API mana yang sesuai untuk organisasi Anda dan cara membuat kunci yang tepat.
| API | Jenis kunci | Dibuat di | Siapa yang dapat membuatnya | Apa yang dicakup |
|---|---|---|---|---|
| Claude Code Analytics API | Kunci Admin API (sk-ant-admin01-...) | Claude Console > Settings > Admin keys | 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 | 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, tetapi keduanya adalah API terpisah dengan jenis kunci terpisah. Jika organisasi Anda menggunakan Claude Platform dan Claude Enterprise, 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, 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 di claude.ai. Untuk kasus penggunaan tata kelola dan audit (tindakan pengguna individual, peristiwa aktivitas mentah, konten percakapan), lihat Compliance API.
Claude Code Analytics API tersedia untuk setiap organisasi yang memiliki akses ke Admin API, dan gratis untuk digunakan.
Buat kunci Admin API
Ikuti langkah-langkah di Buat kunci Admin API.
Panggil API
Kirimkan kunci di header x-api-key:
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: $ADMIN_API_KEY"Untuk metrik yang tersedia, parameter permintaan, dan skema respons, lihat panduan Claude Code Analytics API dan referensi 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 kursi, endpoint tersebut hanya mencerminkan kredit penggunaan.
Masuk sebagai pemilik utama
Hanya pemilik utama organisasi yang dapat mengaktifkan akses API dan membuat kunci Analytics API.
Aktifkan akses API dan buat kunci
Buka claude.ai > Organization settings > API dan aktifkan akses API publik, lalu buat kunci Analytics API. Kunci memiliki cakupan read:analytics. Salin rahasia yang ditampilkan dan simpan di pengelola rahasia Anda.
Panggil API
Kirimkan kunci di header x-api-key. Endpoint berada di bawah https://api.anthropic.com/v1/organizations/analytics/. Untuk contoh permintaan, parameter, dan skema respons, lihat referensi Claude Enterprise Analytics API.
Claude Enterprise Analytics API menyediakan:
Untuk detail endpoint, parameter, dan skema respons, lihat referensi Claude Enterprise Analytics API. Bagian-bagian berikut membahas kesegaran data, definisi metrik, dan panduan operasional yang berlaku di seluruh endpoint tersebut.
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 diagregasi pada pukul 10
UTC hari berikutnya dan tersedia untuk kueri tiga hari setelah agregasi. Jika data tidak tersedia dalam rentang waktu tersebut, biasanya hal ini menunjukkan kegagalan pipeline data di sisi Anthropic; hubungi dukungan jika kesenjangan tersebut terus berlanjut.Endpoint biaya dan penggunaan mengikuti model kesegaran yang berbeda. Data biasanya tersedia dalam waktu empat jam setelah penggunaan yang mendasarinya tetapi dapat memakan waktu hingga 24 jam. Nilai untuk tanggal tertentu dapat direvisi hingga 30 hari seiring datangnya peristiwa yang terlambat dan berjalannya rekonsiliasi. Untuk total setingkat faktur, lakukan kueri untuk tanggal setidaknya 30 hari di masa lalu.
Respons biaya dan penggunaan menyertakan stempel waktu data_refreshed_at. Ketika ending_at dihilangkan (nilai default adalah waktu saat ini), respons menyertakan bagian akhir data setelah data_refreshed_at yang tidak lengkap. Untuk hasil yang stabil di seluruh panggilan berulang, atur ending_at ke nilai pada atau sebelum data_refreshed_at yang dikembalikan sebelumnya.
Pengguna aktif. Seorang pengguna dihitung sebagai 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.
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 nol semua alih-alih null.
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.
Kursor 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 kursor lama, permintaan akan mengembalikan error 400. Untuk mengubah parameter, mulai ulang dari halaman pertama tanpa kursor.
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 mewakili $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 berlaku di tingkat organisasi, bukan per kunci, dengan default 60 permintaan per menit di seluruh endpoint dalam API ini. Jika itu tidak cukup untuk kasus penggunaan Anda, hubungi tim akun Anthropic Anda untuk mendiskusikan penyesuaian batas tersebut.
Jika organisasi Anda menggunakan Claude Code melalui Amazon Bedrock, Claude Enterprise Analytics API tidak mengembalikan aktivitas Claude Code untuk penggunaan tersebut.
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.
Was this page helpful?