L'API Analytics fornisce ai Proprietari Primari dei piani Enterprise accesso programmatico ai dati di coinvolgimento, adozione, utilizzo e costi della loro organizzazione. Utilizzala per creare dashboard interne, tracciare le tendenze di adozione, riconciliare la spesa rispetto alla tua fattura mensile e alimentare i dati di Claude nei tuoi strumenti di reporting esistenti.
L'API Analytics è disponibile sui piani Enterprise. I Proprietari Primari possono generare chiavi API per iniziare.
In che modo questo è diverso dal dashboard di analytics e dall'API Compliance?
Tutte e tre le opzioni ti offrono diverse visualizzazioni dei dati della tua organizzazione:
Il dashboard Analytics (accessibile tramite Analytics) mostra i dati di utilizzo visualizzati nel prodotto. È lo strumento giusto per il monitoraggio quotidiano quando non hai bisogno di integrare i dati altrove.
L'API Analytics restituisce le stesse metriche aggregate, ma a livello programmatico — quindi puoi estrarle in strumenti BI, mapparle rispetto agli organigrammi, automatizzare i flussi di lavoro di reporting e riconciliare i dati di costo rispetto ai record interni. I dati di coinvolgimento e adozione sono aggregati per organizzazione, per giorno. I dati di utilizzo e costo sono disponibili con suddivisioni più granulari per utente e raggruppamenti temporali.
L'API Compliance è per i casi d'uso di governance e audit. Ti dà accesso alle azioni dei singoli utenti, agli eventi di attività grezzi e al contenuto delle conversazioni. Se hai bisogno di metriche di coinvolgimento aggregate per i dashboard, piuttosto che di eventi grezzi per l'audit, utilizza l'API Analytics.
Iniziare
Per accedere all'API Analytics, hai bisogno dell'accesso Proprietario Primario alla tua organizzazione Enterprise.
Segui questi passaggi:
Vai a Analytics > API keys.
Trova l'interruttore Access sotto Analytics API e attivalo.
Fai clic su "+ Create key" per generare una nuova chiave API. Mantieni questa chiave privata—trattala come una password.
Utilizza la chiave con l'intestazione
x-api-keynelle tue richieste.
Per i dettagli di autenticazione completi, i riferimenti degli endpoint e gli esempi di codice, consulta la nostra guida di riferimento dell'API Claude Enterprise Analytics.
Quali dati sono disponibili?
L'API Analytics include nove endpoint in due categorie.
Coinvolgimento e adozione
Questi endpoint restituiscono metriche di coinvolgimento aggregate, per organizzazione, per giorno. I dati sono disponibili fino agli ultimi 90 giorni (non prima del 1° gennaio 2026).
Attività utente: Metriche di coinvolgimento per utente su tutte le superfici Claude. Include conteggi di conversazioni, messaggi inviati, progetti creati, file caricati, artefatti creati, competenze utilizzate, connettori utilizzati, metriche di Claude Code come commit, pull request e righe di codice, e metriche di Cowork come sessioni avviate, azioni degli strumenti, turni di dispatch e invocazioni di competenze e connettori.
Riepilogo attività: Conteggi di utenti attivi giornalieri, settimanali e mensili a livello di organizzazione su Claude, Claude Code e Cowork, insieme all'utilizzo dei posti e ai conteggi degli inviti in sospeso. Supporta intervalli di date fino a 31 giorni per richiesta.
Utilizzo del progetto chat: Conteggi di conversazioni e utenti suddivisi per progetto, per i progetti Claude.
Utilizzo delle competenze: Quanti utenti stanno utilizzando ogni competenza, con suddivisioni per sessioni Claude, Claude Code e Cowork separatamente.
Utilizzo dei connettori: Quali connettori sta utilizzando la tua organizzazione e quanti utenti univoci hanno utilizzato ciascuno, con suddivisioni per sessioni Claude, Claude Code e Cowork separatamente.
Utilizzo e costo
Nota: Gli endpoint di costo e utilizzo si applicano ai piani Enterprise basati sull'utilizzo. Per i piani Enterprise basati su posti, questi endpoint rifletteranno solo l'utilizzo aggiuntivo.
Questi endpoint (disponibili ora in beta) restituiscono dati di utilizzo dei token e costi in USD su tutte le superfici Claude. Utilizzali per tracciare l'utilizzo tra le fatture mensili, riconciliare la fatturazione Anthropic rispetto ai centri di costo interni e informare i limiti di spesa in base al comportamento effettivo dell'utente.
Utilizzo dei token per utente: Utenti classificati per utilizzo di token in un intervallo di date, con suddivisioni facoltative per prodotto, modello, finestra di contesto, regione di inferenza o velocità.
Costo per utente: Utenti classificati per spesa in USD in un intervallo di date, con suddivisioni facoltative per prodotto, modello, tipo di costo (token, ricerca web, esecuzione del codice) o tipo di token.
Utilizzo dei token nel tempo: Utilizzo dei token raggruppato per minuto, ora o giorno, facoltativamente suddiviso per prodotto, modello, finestra di contesto, regione di inferenza o velocità.
Costo nel tempo: Costo in USD raggruppato per minuto, ora o giorno, con le stesse opzioni di raggruppamento più tipo di costo e tipo di token.
I dati vengono aggiornati ogni quattro ore e possono richiedere fino a 24 ore. I valori possono essere rivisti per un massimo di 30 giorni mentre gli eventi tardivi si riconciliano, quindi per i totali di qualità fatturazione, interroga date almeno 30 giorni nel passato.
Limiti dei dati
Gli endpoint di coinvolgimento e adozione restituiscono dati per una singola data o intervallo di date. I dati sono disponibili solo dopo il 1° gennaio 2026 e per date più di tre giorni fa.
Gli endpoint di utilizzo e costo ti consentono di interrogare una finestra di 31 giorni, risalendo fino a 365 giorni da oggi. Per i totali di qualità fatturazione, interroga date almeno 30 giorni nel passato in modo che gli eventi tardivi abbiano tempo di riconciliarsi.
L'API ha un limite di velocità predefinito di 60 richieste al minuto. Se questo non soddisfa le esigenze della tua organizzazione, contatta il tuo Contatto Anthropic o il nostro team di vendita.
Importante: Se stai utilizzando Claude Code tramite Amazon Bedrock, l'API Analytics non restituirà dati relativi a Claude Code.