AdministraçãoMonitoramento

APIs de Analytics

Copy page



Entenda qual API de analytics e qual chave de API sua organização precisa e, em seguida, provisione acesso às métricas de produtividade do Claude Code ou aos dados de engajamento e adoção do Claude Enterprise.

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 em todos os 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.

De 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.

Obtenha acesso à Claude Code Analytics API

A Claude Code Analytics API está disponível para toda organização com acesso à Admin API e é gratuita.

1. 1

   Crie uma chave de Admin API

   Siga as etapas em Criar uma chave de Admin API.

2. 2

   Chame a API

   Passe a chave no cabeçalho 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: $ANTHROPIC_ADMIN_KEY"

   

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.

Obtenha acesso à Claude Enterprise Analytics API

A Claude Enterprise Analytics API está disponível para organizações Claude Enterprise. Os 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.

1. 1

   Faça login como proprietário principal

   Somente o proprietário principal da organização pode habilitar o acesso à API e criar chaves de Analytics API.

2. 2

   Habilite o acesso à API e crie uma chave

   Acesse claude.ai > Organization settings > API e habilite o acesso público à API; em seguida, crie uma chave de Analytics API. As chaves possuem o escopo read:analytics. Copie o segredo exibido e armazene-o no seu gerenciador de segredos.

3. 3

   Chame a API

   Passe a chave no cabeçalho x-api-key e inclua o cabeçalho anthropic-version em todas as requisições. Os endpoints ficam em https://api.anthropic.com/v1/organizations/analytics/. Para exemplos de requisição, parâmetros e esquemas de resposta, consulte a referência da Claude Enterprise Analytics API.

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, contagens 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 ao longo do tempo por usuário e no nível da organização (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 abordam a atualidade dos dados, definições de métricas e orientações operacionais que se aplicam a todos esses endpoints.

Disponibilidade e atualidade dos dados

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

Os endpoints de engajamento e adoção (atividade de usuários, resumos, projetos, skills, conectores) retornam um snapshot diário para a data que você especificar. Os dados de um determinado dia normalmente ficam disponíveis a partir de cerca de 17:00 UTC do dia seguinte (um atraso de 1 dia); até lá, o dia mais recente disponível geralmente é dois dias antes da data UTC atual. Ocasionalmente, os dados chegam mais tarde, e a atualização exata varia conforme a consulta; portanto, em vez de presumir um horário fixo, verifique a resposta de erro: solicitar uma data que ainda não está disponível retorna um erro 400 indicando o dia mais recente disponível. Se os dados não estiverem disponíveis muito depois do atraso típico, isso geralmente indica uma falha no pipeline de dados do lado da Anthropic; entre em contato com o suporte se a lacuna persistir.

Endpoints de custo e uso seguem um modelo de atualidade diferente. Os dados normalmente 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 tardios chegam e a reconciliação é executada. Para totais com precisão de faturamento, consulte datas com 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 "tool use" (uso de ferramentas) ou atividade 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 daquele 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

Os 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, recomece 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 monetário são strings decimais em centavos. Valores monetários são retornados como strings decimais, como "41280.000000" (que representa $412,80). Para converter em dólares, faça o parse como decimal e divida por 100. Evite o parse em ponto flutuante binário para valores que possam exceder vários milhões de dólares.

Os 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 o seu caso de uso, entre em contato com a equipe de conta da Anthropic para discutir o ajuste do limite.

Versionamento

Envie o cabeçalho anthropic-version em todas as requisições; consulte Versões da API para ver as versões disponíveis.

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