Ikhtisar
Claude Enterprise Analytics API memberikan organisasi Anda akses terprogram ke data keterlibatan untuk penggunaan Claude dan Claude Code dalam organisasi Enterprise Anda. Baik Anda membangun dasbor internal untuk aktivitas pengguna atau melacak adopsi proyek, API ini menyediakan metrik agregat yang Anda butuhkan.
Agregasi data
Semua data diagregasi per organisasi, per hari. Setiap endpoint mengembalikan snapshot untuk satu tanggal yang Anda tentukan. Data untuk hari (N-1) dijalankan pada pukul 10:00:00 UTC pada hari N, dan tersedia untuk dipertanyakan tiga hari setelah agregasi, untuk memastikan akurasi data.
Jika data tidak tersedia dalam jangka waktu di atas, ini biasanya menunjukkan kegagalan pipeline data yang perlu diselidiki tim kami secara internal. Kami biasanya menyadari masalah seperti itu, tetapi silakan sampaikan ini kepada CSM Anda jika Anda ingin pemeriksaan atau mencurigai sesuatu yang lain.
Mengaktifkan akses
Untuk membuat kunci API analitik baru, Anda harus menjadi Pemilik Utama dalam organisasi Enterprise Anda. Anda dapat melakukannya dengan menavigasi ke claude.ai/analytics/api-keys.
Beberapa detail lagi yang mungkin membantu:
Anda dapat mengaktifkan/menonaktifkan akses ke API publik kapan saja. Jika Anda menonaktifkan akses dengan mengalihkan sakelar, semua permintaan akan ditolak.
Anda memerlukan kunci dengan cakupan
read:analyticsuntuk mengakses API. Anda dapat membuat beberapa kunci untuk organisasi Anda, tetapi batas laju diterapkan pada tingkat organisasi , bukan tingkat kunci . Lihat bagian "Pembatasan laju" di bawah.Seperti biasa, kami sangat merekomendasikan menangani kunci API dengan aman: jangan pernah bagikan kunci ini secara publik - kunci ini rahasia, dan harus dibagikan dengan aman.
URL Dasar
Semua permintaan dikirim ke:
https://api.anthropic.com/v1/organizations/analytics/
Autentikasi
Setiap permintaan memerlukan kunci API yang diteruskan di header x-api-key. Kunci API Anda harus memiliki cakupan read:analytics. Anda dapat membuat dan mengelola kunci API dari pengaturan admin claude.ai di bagian Kunci API.
Contoh header permintaan:
x-api-key: $YOUR_API_KEY
Paginasi
Beberapa endpoint mengembalikan hasil yang dipaginasi. Paginasi menggunakan pendekatan berbasis kursor, di mana respons mencakup token next_page yang Anda teruskan kembali dalam permintaan berikutnya untuk mengambil halaman hasil berikutnya.
Dua parameter opsional mengontrol paginasi:
limit (integer): Jumlah catatan per halaman. Default ke 20 untuk endpoint /users dan 100 untuk semua endpoint lainnya. Maksimum adalah 1000.
page (string): Token kursor buram dari field next_page respons sebelumnya. Abaikan ini pada permintaan pertama Anda.
Ketika tidak ada lagi hasil, next_page akan menjadi null dalam respons.
Respons kesalahan
Semua endpoint mengembalikan kode kesalahan HTTP standar:
Kode | Arti |
400 | Parameter kueri tidak valid. Penyebab umum termasuk tanggal yang tidak valid, tanggal sebelum 1/1/26 (ketersediaan pertama), atau tanggal yang merupakan hari ini atau di masa depan. Ketersediaan data tertunda tiga hari. |
404 | Kunci API hilang, tidak valid, atau tidak memiliki cakupan |
429 | Batas laju terlampaui. Terlalu banyak permintaan. |
503 | Kegagalan sementara, silakan coba lagi. |
Pembatasan laju
Kami memiliki batas laju default. Jika itu tidak cukup untuk kasus penggunaan Anda, kami ingin memahami alasannya. Jika perlu, kami dapat menyesuaikan batas laju untuk organisasi Anda—silakan hubungi CSM Anda.
Endpoint
1. Daftar aktivitas pengguna
GET /v1/organizations/analytics/users
Mengembalikan metrik keterlibatan per pengguna untuk satu hari. Setiap item dalam respons mewakili satu pengguna dan mencakup jumlah aktivitas mereka di seluruh Claude (chat) dan Claude Code.
Parameter kueri
Field | Tipe | Diperlukan | Deskripsi |
| string | Ya | Tanggal untuk mengambil metrik, dalam format YYYY-MM-DD. |
| integer | Tidak | Jumlah catatan per halaman (default: 20, maks: 1000). |
| string | Tidak | Token kursor dari field |
Field respons (per pengguna)
Field | Deskripsi |
| Pengenal unik untuk pengguna. |
| Alamat email pengguna. |
| Jumlah percakapan yang berbeda, khususnya dalam Claude.ai. |
| Total pesan yang dikirim, khususnya dalam Claude.ai. |
| Jumlah proyek yang dibuat, khususnya dalam Claude.ai. |
| Jumlah proyek yang berbeda digunakan, khususnya dalam Claude.ai. |
| Jumlah file yang diunggah, khususnya dalam Claude.ai. |
| Jumlah artefak yang dibuat, khususnya dalam Claude.ai. |
| Jumlah pesan pemikiran (diperpanjang), khususnya dalam Claude.ai. |
| Jumlah keterampilan yang berbeda digunakan, khususnya dalam Claude.ai. |
| Jumlah total konektor yang dipanggil, khususnya dalam Claude.ai. |
| Jumlah komit git yang dibuat melalui Claude Code. |
| Jumlah permintaan tarik yang dibuat melalui Claude Code. |
| Total baris kode yang ditambahkan. |
| Total baris kode yang dihapus. |
| Jumlah sesi Claude Code yang berbeda. |
| Jumlah yang diterima dan ditolak untuk alat Edit. |
| Jumlah yang diterima dan ditolak untuk alat Multi-Edit. |
| Jumlah yang diterima dan ditolak untuk alat Tulis. |
| Jumlah yang diterima dan ditolak untuk alat Edit Notebook. |
| Total pemanggilan alat pencarian web. Ini berlaku untuk penggunaan claude.ai dan kode claude dalam organisasi Anda. |
Contoh permintaan
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. Ringkasan aktivitas
GET /v1/organizations/analytics/summaries
Mengembalikan ringkasan tingkat tinggi keterlibatan dan pemanfaatan kursi per hari untuk organisasi Anda untuk rentang tanggal tertentu. Respons adalah daftar hari dengan jumlah agregat dalam rentang tanggal. Perhatikan bahwa perbedaan maksimum antara ending_date dan starting_date harus 31 hari, dan ada penundaan tiga hari dalam ketersediaan data. Ini berguna untuk melacak pengguna aktif harian, tren mingguan dan bulanan, dan alokasi kursi sekilas.
Kami mendefinisikan "aktif" jika salah satu dari berikut ini benar:
Pengguna mengirim setidaknya satu pesan chat di Claude (chat).
Pengguna memiliki setidaknya satu sesi Claude Code (lokal atau jarak jauh) yang terkait dengan org C4E, dengan penggunaan alat/aktivitas git
Parameter kueri
Field | Tipe | Diperlukan | Deskripsi |
| string | Ya | Tanggal awal untuk mengambil data, dalam format YYYY-MM-DD. Ada penundaan tiga hari dalam ketersediaan data, jadi data terbaru yang dapat Anda akses adalah dari tiga hari yang lalu. |
| string | Tidak | Tanggal akhir opsional untuk mengambil data, dalam format YYYY-MM-DD. Ini eksklusif. |
Field respons
Field | Deskripsi |
| Hari pertama untuk metrik yang diagregasi, diinterpretasikan sebagai tanggal UTC. Ada penundaan tiga hari dalam ketersediaan data, jadi data terbaru yang dapat Anda akses adalah dari tiga hari yang lalu. |
| Hari terakhir (eksklusif) untuk metrik yang diagregasi, diinterpretasikan sebagai tanggal UTC |
| Jumlah pengguna aktif pada tanggal yang ditentukan (berdasarkan konsumsi token). |
| Jumlah pengguna aktif dalam jendela bergulir 7 hari yang berakhir pada tanggal yang ditentukan. |
| Jumlah pengguna aktif dalam jendela bergulir 30 hari yang berakhir pada tanggal yang ditentukan. |
| Jumlah total kursi yang saat ini ditugaskan dalam organisasi Anda. |
| Jumlah undangan yang tertunda dan belum diterima. |
Catatan: Jendela bergulir untuk jumlah mingguan dan bulanan melihat ke belakang dari tanggal yang ditentukan (inklusif). Jika data tidak lengkap untuk beberapa hari dalam jendela (misalnya, jika tanggalnya kurang dari 30 hari yang lalu), jumlah bulanan mungkin kurang menghitung aktivitas.
Contoh permintaan
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/summaries?starting_date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
3. Penggunaan proyek chat
GET /v1/organizations/analytics/apps/chat/projects
Mengembalikan data penggunaan yang dipecah menurut proyek chat untuk tanggal tertentu. Proyek khusus untuk Claude (chat), jadi endpoint ini berfokus pada permukaan itu. Setiap item menunjukkan nama proyek, berapa banyak pengguna unik yang berinteraksi dengannya, dan jumlah total percakapan yang diadakan dalam proyek itu.
Parameter kueri
Field | Tipe | Diperlukan | Deskripsi |
| string | Ya | Tanggal untuk mengambil metrik, dalam format YYYY-MM-DD. Ada penundaan tiga hari dalam ketersediaan data, jadi data terbaru yang dapat Anda akses adalah dari tiga hari yang lalu. |
| integer | Tidak | Jumlah catatan per halaman (default: 100, maks: 1000). |
| string | Tidak | Token kursor dari field |
Field respons (per proyek)
Field | Deskripsi |
| Nama proyek. |
| ID proyek yang ditandai, yaitu "claude_proj_{ID}" |
| Jumlah pengguna unik yang menggunakan proyek ini pada tanggal tertentu. |
| Jumlah percakapan dalam proyek ini pada tanggal tertentu. |
| Jumlah total pesan yang dikirim dalam proyek ini pada tanggal tertentu. |
Contoh permintaan
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. Penggunaan keterampilan
GET /v1/organizations/analytics/skills
Mengembalikan data penggunaan keterampilan di seluruh Claude (chat) dan Claude Code dalam organisasi Anda untuk tanggal tertentu. Setiap item mewakili keterampilan dan menunjukkan berapa banyak pengguna unik yang menggunakannya.
Parameter kueri
Field | Tipe | Diperlukan | Deskripsi |
| string | Ya | Tanggal untuk mengambil metrik, dalam format YYYY-MM-DD. Ada penundaan tiga hari dalam ketersediaan data, jadi data terbaru yang dapat Anda akses adalah dari tiga hari yang lalu. |
| integer | Tidak | Jumlah catatan per halaman (default: 100, maks: 1000). |
| string | Tidak | Token kursor dari field |
Field respons (per keterampilan)
Field | Deskripsi |
|