APIs de Analytics

A Anthropic fornece duas APIs de analytics, e qual delas você usa depende de qual produto Claude sua organização gerencia:

• A Claude Code Analytics API reporta métricas diárias de produtividade do Claude Code para organizações que usam a Claude Platform. Ela faz parte da Admin API e usa uma chave de Admin API.
• A Claude Enterprise Analytics API reporta dados de engajamento, adoção e custo de toda a organização nos produtos Claude (chat, projetos, Claude Code e mais) para organizações Claude Enterprise. Ela usa uma chave de Analytics API criada no claude.ai.

As duas APIs usam tipos de chave diferentes, criados em lugares diferentes por funções diferentes. Esta página descreve qual API se adequa à sua organização e como criar a chave correta.



Qual API você precisa?

Os tipos de chave não são intercambiáveis: uma chave de Admin API não pode chamar a Claude Enterprise Analytics API, e uma chave de Analytics API não pode chamar a Admin API. Ambas as APIs aparecem na referência da Admin API, mas são APIs separadas com tipos de chave separados. Se sua organização usa tanto a Claude Platform quanto o Claude Enterprise, você pode provisionar ambas as chaves e usar cada API para seus próprios dados.



Obter acesso à Claude Code Analytics API

A Claude Code Analytics API está disponível para todas as organizações com acesso à Admin API e é gratuita para uso.

Para as métricas disponíveis, parâmetros de requisição e esquema de resposta, consulte o guia da Claude Code Analytics API e a referência da API.



Obter acesso à Claude Enterprise Analytics API

A Claude Enterprise Analytics API está disponível para organizações Claude Enterprise. Dados de engajamento e adoção estão disponíveis em todos os planos Enterprise. Os endpoints de custo e uso se aplicam a planos Enterprise baseados em uso; para planos Enterprise baseados em assentos, eles refletem apenas créditos de uso.

A Claude Enterprise Analytics API fornece:

• Atividade de usuários: métricas diárias por usuário em chat (conversas, mensagens, projetos, arquivos, artifacts), Claude Code (sessões, commits, pull requests, linhas de código, ações de ferramentas) e outros produtos Claude
• Resumos de atividade: usuários ativos diários, semanais e mensais no nível da organização, contagem de assentos e convites pendentes
• Uso de projetos, skills e conectores: detalhamentos de adoção para projetos de chat, skills e conectores
• Relatórios de custo e uso: uso de tokens e custo por usuário e no nível da organização ao longo do tempo (planos Enterprise baseados em uso)

Para detalhes de endpoints, parâmetros e esquemas de resposta, consulte a referência da Claude Enterprise Analytics API. As seções a seguir cobrem atualização de dados, definições de métricas e orientações operacionais que se aplicam a todos esses endpoints.



Disponibilidade e atualização de dados

Os dados da Claude Enterprise Analytics API estão disponíveis para datas a partir de 1º de janeiro de 2026.

Endpoints de engajamento e adoção (atividade de usuários, resumos, projetos, skills, conectores) retornam um snapshot por dia para a data que você especificar. Os dados de um determinado dia são agregados às 10

Endpoints de custo e uso seguem um modelo de atualização diferente. Os dados geralmente ficam disponíveis dentro de quatro horas após o uso subjacente, mas podem levar até 24 horas. Os valores de uma determinada data podem ser revisados por até 30 dias à medida que eventos atrasados chegam e a reconciliação é executada. Para totais com qualidade de faturamento, consulte datas de pelo menos 30 dias no passado.



Como as métricas são definidas

Usuários ativos. Um usuário conta como ativo em um dia se qualquer uma das seguintes condições for verdadeira: ele enviou pelo menos uma mensagem de chat no Claude, teve pelo menos uma sessão do Claude Code (local ou remota) associada à sua organização Claude Enterprise que incluiu uso de ferramentas ou atividade de git, ou teve pelo menos uma sessão do Cowork com uso de ferramentas ou atividade de mensagens.

Blocos de métricas por produto. Objetos de métricas por produto (por exemplo, métricas do Office Agent ou do Cowork em um registro de atividade de usuário) estão sempre presentes em todos os registros. Organizações sem uso desse produto veem valores todos zerados em vez de null.

Nomes de conectores. Os nomes de conectores são normalizados entre as fontes. Por exemplo, Atlassian MCP server, mcp-atlassian e atlassian_MCP aparecem todos como atlassian no endpoint de uso de conectores.



Trabalhando com a API

Cursores de paginação estão vinculados à consulta que os emitiu. Nos endpoints de custo e uso, não altere parâmetros de consulta no meio da sequência: se você alterar products[], group_by[], order_by, o intervalo de datas ou qualquer filtro e passar um cursor antigo, a requisição retorna um erro 400. Para alterar parâmetros, reinicie a partir da primeira página sem um cursor.

Parâmetros de lista usam notação de colchetes. Repita o parâmetro para cada valor, por exemplo products[]=chat&products[]=claude_code.

Campos de valor são strings decimais em centavos. Valores monetários são retornados como strings decimais, como "41280.000000" (que representa US$ 412,80). Para converter para dólares, faça o parse como decimal e divida por 100. Evite parsing de ponto flutuante binário para valores que possam exceder vários milhões de dólares.

Limites de taxa se aplicam no nível da organização, não por chave, com um padrão de 60 requisições por minuto em todos os endpoints desta API. Se isso não for suficiente para seu caso de uso, entre em contato com sua equipe de conta da Anthropic para discutir o ajuste do limite.



Limitações conhecidas

Se sua organização usa o Claude Code por meio do Amazon Bedrock, a Claude Enterprise Analytics API não retorna atividade do Claude Code para esse uso.



Próximos passos