Panoramica
L'API Claude Enterprise Analytics fornisce alla tua organizzazione l'accesso programmatico ai dati di engagement per l'utilizzo di Claude e Claude Code all'interno della tua organizzazione Enterprise. Che tu stia creando dashboard interni per l'attività degli utenti o tracciando l'adozione di progetti, questa API fornisce le metriche aggregate di cui hai bisogno.
Aggregazione dei dati
Tutti i dati sono aggregati per organizzazione, per giorno. Ogni endpoint restituisce uno snapshot per una singola data che specifichi. I dati per il giorno (N-1) vengono elaborati alle 10:00:00 UTC nel giorno N, e sono disponibili per le query tre giorni dopo l'aggregazione, per garantire l'accuratezza dei dati.
Se i dati non sono disponibili entro la timeline sopra indicata, questo di solito indica un errore della pipeline di dati che il nostro team dovrà investigare internamente. Siamo solitamente consapevoli di tali problemi, ma ti preghiamo di segnalarlo al tuo CSM se desideri una verifica, o se sospetti qualcos'altro.
Abilitazione dell'accesso
Per creare nuove chiavi API di analytics, devi essere un Primary Owner all'interno della tua organizzazione Enterprise. Puoi farlo navigando a claude.ai/analytics/api-keys.
Alcuni dettagli aggiuntivi che potrebbero essere utili:
Puoi abilitare/disabilitare l'accesso all'API pubblica in qualsiasi momento. Se disabiliti l'accesso attivando l'interruttore, tutte le richieste verranno negate.
Avrai bisogno di una chiave con lo scope
read:analyticsper accedere all'API. Puoi creare più chiavi per la tua organizzazione, ma i limiti di velocità si applicano a livello di organizzazione , non a livello di chiave . Vedi la sezione "Rate limiting" di seguito.Come sempre, ti consigliamo vivamente di gestire le chiavi API in modo sicuro: non condividere mai queste chiavi pubblicamente - sono segrete e dovrebbero essere condivise in modo sicuro.
URL di base
Tutte le richieste vengono inviate a:
https://api.anthropic.com/v1/organizations/analytics/
Autenticazione
Ogni richiesta richiede una chiave API passata nell'header x-api-key. La tua chiave API deve avere lo scope read:analytics. Puoi creare e gestire le chiavi API dalle impostazioni admin di claude.ai nella sezione API Keys.
Esempio di header di richiesta:
x-api-key: $YOUR_API_KEY
Paginazione
Diversi endpoint restituiscono risultati paginati. La paginazione utilizza un approccio basato su cursore, dove la risposta include un token next_page che passi di nuovo nella tua prossima richiesta per recuperare la pagina successiva di risultati.
Due parametri opzionali controllano la paginazione:
limit (integer): Numero di record per pagina. Il valore predefinito è 20 per l'endpoint /users e 100 per tutti gli altri endpoint. Il massimo è 1000.
page (string): Il token cursore opaco dal campo next_page della risposta precedente. Ometti questo nella tua prima richiesta.
Quando non ci sono più risultati, next_page sarà null nella risposta.
Risposte di errore
Tutti gli endpoint restituiscono codici di errore HTTP standard:
Codice | Significato |
400 | Un parametro di query non è valido. Le cause comuni includono una data non valida, una data precedente a 1/1/26 (prima disponibilità), o una data che è oggi o nel futuro. La disponibilità dei dati è ritardata di tre giorni. |
404 | La chiave API è mancante, non valida, o non ha lo scope |
429 | Limite di velocità superato. Troppe richieste. |
503 | Errore transitorio, per favore riprova. |
Rate limiting
Abbiamo dei limiti di velocità predefiniti in atto. Se questo non è sufficiente per il tuo caso d'uso, ci piacerebbe capire il perché. Se necessario, possiamo regolare i limiti di velocità per la tua organizzazione—per favore contatta il tuo CSM.
Endpoint
1. Elenco attività utente
GET /v1/organizations/analytics/users
Restituisce metriche di engagement per utente per un singolo giorno. Ogni elemento nella risposta rappresenta un utente e include i conteggi della loro attività su Claude (chat) e Claude Code.
Parametri di query
Campo | Tipo | Obbligatorio | Descrizione |
| string | Sì | La data per cui recuperare le metriche, nel formato YYYY-MM-DD. |
| integer | No | Numero di record per pagina (predefinito: 20, massimo: 1000). |
| string | No | Token cursore dalla risposta precedente del campo |
Campi di risposta (per utente)
Campo | Descrizione |
| Identificatore univoco per l'utente. |
| L'indirizzo email dell'utente. |
| Numero di conversazioni distinte, specificamente all'interno di Claude.ai. |
| Numero totale di messaggi inviati, specificamente all'interno di Claude.ai. |
| Numero di progetti creati, specificamente all'interno di Claude.ai. |
| Numero di progetti distinti utilizzati, specificamente all'interno di Claude.ai. |
| Numero di file caricati, specificamente all'interno di Claude.ai. |
| Numero di artifact creati, specificamente all'interno di Claude.ai. |
| Numero di messaggi di thinking (estesi), specificamente all'interno di Claude.ai. |
| Numero di skill distinte utilizzate, specificamente all'interno di Claude.ai. |
| Numero totale di connector invocati, specificamente all'interno di Claude.ai. |
| Numero di commit git effettuati tramite Claude Code. |
| Numero di pull request create tramite Claude Code. |
| Numero totale di righe di codice aggiunte. |
| Numero totale di righe di codice rimosse. |
| Numero di sessioni Claude Code distinte. |
| Conteggi accettati e rifiutati per lo strumento Edit. |
| Conteggi accettati e rifiutati per lo strumento Multi-Edit. |
| Conteggi accettati e rifiutati per lo strumento Write. |
| Conteggi accettati e rifiutati per lo strumento Notebook Edit. |
| Totale delle invocazioni dello strumento di ricerca web. Questo si applica sia all'utilizzo di claude.ai che di claude code all'interno della tua organizzazione. |
Esempio di richiesta
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. Riepilogo attività
GET /v1/organizations/analytics/summaries
Restituisce un riepilogo di alto livello dell'engagement e dell'utilizzo dei posti per giorno per la tua organizzazione per un intervallo di date specificato. La risposta è un elenco di giorni con conteggi aggregati all'interno dell'intervallo di date. Nota che la differenza massima tra ending_date e starting_date deve essere 31 giorni, e c'è un ritardo di tre giorni nella disponibilità dei dati. Questo è utile per tracciare gli utenti attivi giornalieri, le tendenze settimanali e mensili, e l'allocazione dei posti a colpo d'occhio.
Definiamo "attivo" se una qualsiasi delle seguenti è vera:
L'utente ha inviato almeno un messaggio di chat su Claude (chat).
L'utente ha avuto almeno una sessione Claude Code (locale o remota) associata all'organizzazione C4E, con utilizzo di strumenti/attività git
Parametri di query
Campo | Tipo | Obbligatorio | Descrizione |
| string | Sì | La data di inizio per cui recuperare i dati, nel formato YYYY-MM-DD. C'è un ritardo di tre giorni nella disponibilità dei dati, quindi i dati più recenti a cui puoi accedere sono da tre giorni fa. |
| string | No | La data di fine opzionale per cui recuperare i dati, nel formato YYYY-MM-DD. Questo è esclusivo. |
Campi di risposta
Campo | Descrizione |
| Primo giorno per il quale le metriche sono aggregate, interpretato come una data UTC. C'è un ritardo di tre giorni nella disponibilità dei dati, quindi i dati più recenti a cui puoi accedere sono da tre giorni fa. |
| Ultimo giorno (esclusivo) per il quale le metriche sono aggregate, interpretato come una data UTC |
| Numero di utenti attivi nella data specificata (basato sul consumo di token). |
| Numero di utenti attivi entro la finestra mobile di 7 giorni che termina nella data specificata. |
| Numero di utenti attivi entro la finestra mobile di 30 giorni che termina nella data specificata. |
| Numero totale di posti attualmente assegnati nella tua organizzazione. |
| Numero di inviti in sospeso che non sono ancora stati accettati. |
Nota: Le finestre mobili per i conteggi settimanali e mensili guardano indietro dalla data specificata (inclusa). Se i dati sono incompleti per alcuni giorni all'interno della finestra (ad esempio, se la data è meno di 30 giorni nel passato), il conteggio mensile potrebbe sottovalutare l'attività.
Esempio di richiesta
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/summaries?starting_date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
3. Utilizzo del progetto chat
GET /v1/organizations/analytics/apps/chat/projects
Restituisce i dati di utilizzo suddivisi per progetto chat per una data specificata. I progetti sono specifici di Claude (chat), quindi questo endpoint si concentra su quella superficie. Ogni elemento mostra il nome del progetto, quanti utenti univoci hanno interagito con esso, e il numero totale di conversazioni tenute in quel progetto.
Parametri di query
Campo | Tipo | Obbligatorio | Descrizione |
| string | Sì | La data per cui recuperare le metriche, nel formato YYYY-MM-DD. C'è un ritardo di tre giorni nella disponibilità dei dati, quindi i dati più recenti a cui puoi accedere sono da tre giorni fa. |
| integer | No | Numero di record per pagina (predefinito: 100, massimo: 1000). |
| string | No | Token cursore dalla risposta precedente del campo |
Campi di risposta (per progetto)
Campo | Descrizione |
| Il nome del progetto. |
| L'id del progetto taggato, ad es. "claude_proj_{ID}" |
| Numero di utenti univoci che hanno utilizzato questo progetto nella data specificata. |
| Numero di conversazioni in questo progetto nella data specificata. |
| Numero totale di messaggi inviati all'interno di questo progetto nella data specificata. |
Esempio di richiesta
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. Utilizzo delle skill
GET /v1/organizations/analytics/skills
Restituisce i dati di utilizzo delle skill su Claude (chat) e Claude Code all'interno della tua organizzazione per una data specificata. Ogni elemento rappresenta una skill e mostra quanti utenti univoci l'hanno utilizzata.
Parametri di query
Campo | Tipo | Obbligatorio | Descrizione |
| string | Sì | La data per cui recuperare le metriche, nel formato YYYY-MM-DD. C'è un ritardo di tre giorni nella disponibilità dei dati, quindi i dati più recenti a cui puoi accedere sono da tre giorni fa. |
| integer | No | Numero di record per pagina (predefinito: 100, massimo: 1000). |
| string | No | Token cursore dalla risposta precedente del campo |
Campi di risposta (per skill)
Campo | Descrizione |
| Il nome della skill. |
| Numero di utenti univoci che hanno utilizzato questa skill nella data specificata. |
| Numero di conversazioni distinte in cui la skill è stata utilizzata almeno una volta, in chat. |
|