--- title: APIs de Analytics url: https://platform.claude.com/docs/pt-BR/manage-claude/analytics-api description: 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 de produto, e qual delas você usa depende de qual produto Claude sua organização gerencia: * A **API de Analytics do Claude Code** reporta métricas diárias de produtividade do Claude Code para organizações que usam a Claude Platform. Ela faz parte da [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/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? | API | Tipo de chave | Criada em | Quem pode criá-la | O que ela cobre | | ----------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **API de Analytics do Claude Code** | Chave de Admin API (`sk-ant-admin01-...`) | Página [Chaves de administrador](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) no Claude Console | Administrador da organização | Métricas diárias do Claude Code por usuário: sessões, linhas de código, commits, pull requests, aceitação de ferramentas e custo estimado por modelo | | **Claude Enterprise Analytics API** | Chave de Analytics API | [claude.ai > Configurações da organização > API](https://claude.ai/admin-settings/api-access) | Principal proprietário | Engajamento e adoção em toda a organização (atividade de usuários, resumos de usuários ativos, uso de projetos, skills e conectores), além de relatórios de custo e uso | 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. A única exceção é a [API de Análise de Uso e Custo](https://platform.claude.com/docs/pt-BR/manage-claude/usage-cost-analytics-api), que as organizações Claude Enterprise chamam com sua chave de Analytics API. Ambas as APIs de analytics de produto aparecem na [referência da Admin API](https://platform.claude.com/docs/pt-BR/api/beta/organization), 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. Procurando dados de uso de tokens e custo em vez de analytics de produto? Consulte a [API de Análise de Uso e Custo](https://platform.claude.com/docs/pt-BR/manage-claude/usage-cost-analytics-api), que atende tanto organizações do Claude Console quanto do Claude Enterprise. Se você quiser visualizar dados de engajamento e adoção no produto em vez de programaticamente, use o [painel de Analytics](https://claude.ai/analytics/activity) no claude.ai. Para casos de uso de governança e auditoria (ações individuais de usuários, eventos brutos de atividade, conteúdo de conversas), consulte a [Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access). ## Obtenha acesso à Claude Code Analytics API A Claude Code Analytics API está disponível para toda organização com acesso à [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api) e é gratuita. Siga as etapas em [Criar uma chave de Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization). Passe a chave no cabeçalho `x-api-key`: ```bash curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08" \ -H "anthropic-version: 2026-10-21" \ -H "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 [API de Analytics do Claude Code](https://platform.claude.com/docs/pt-BR/manage-claude/claude-code-analytics-api) e a [referência da API](https://platform.claude.com/docs/pt-BR/api/beta/organization/usage_report/retrieve_claude_code). ## 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. Somente o proprietário principal da organização pode habilitar o acesso à API e criar chaves de Analytics API. Acesse [claude.ai > Configurações da organização > API](https://claude.ai/admin-settings/api-access) 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. Passe a chave no cabeçalho `x-api-key` e inclua o cabeçalho [`anthropic-version`](https://platform.claude.com/docs/pt-BR/api/versioning) 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](https://platform.claude.com/docs/pt-BR/api/beta/organization/analytics). 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), Chat and Cowork unified (atividade de chat e sessões do Cowork) 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) Os endpoints de relatórios de custo e uso em `/v1/organizations/analytics/` (`usage_report`, `cost_report`, `user_usage_report` e `user_cost_report`) são “legacy” (legado) e continuam sendo suportados. Para novas integrações, use a [API de Análise de Uso e Custo](https://platform.claude.com/docs/pt-BR/manage-claude/usage-cost-analytics-api). Para migrar uma integração existente, consulte [Migrar dos relatórios de uso e custo do Claude Enterprise](https://platform.claude.com/docs/pt-BR/manage-claude/usage-cost-analytics-api#migrate-from-enterprise-analytics-reports). Os demais endpoints da Claude Enterprise Analytics API não são legados. Para detalhes de endpoints, parâmetros e esquemas de resposta, consulte a [referência da Claude Enterprise Analytics API](https://platform.claude.com/docs/pt-BR/api/beta/organization/analytics). 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. **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 por volta de 13:00–13:30 UTC do dia seguinte (um atraso de 1 dia). Até lá, o dia disponível mais recente geralmente é 2 dias antes da data UTC atual. Os dados chegam mais tarde em dias em que um pipeline de dados upstream atrasa, e a atualização exata varia conforme a consulta. 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 disponível mais recente. 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 atualização diferente. Os dados normalmente ficam disponíveis em até 4 horas após o uso subjacente, mas podem levar até 24 horas. Os valores podem ser revisados à medida que eventos atrasados chegam e a reconciliação é executada, até cerca de 7 dias após o fim do mês civil. Por exemplo, os valores de 1º de outubro podem mudar até cerca de 7 de novembro. Para totais adequados para faturamento, consulte apenas meses que terminaram há pelo menos 7 dias. As respostas de custo e uso incluem um timestamp `data_refreshed_at`. Se você omitir `ending_at`, o padrão é 31 dias após `starting_at` ou o horário atual, o que ocorrer primeiro. Esse intervalo pode ultrapassar `data_refreshed_at`, e os dados após esse momento estão incompletos. Para resultados estáveis em chamadas repetidas, defina `ending_at` com um valor igual ou anterior a um `data_refreshed_at` retornado anteriormente. ## Como as métricas são definidas **Usuários ativos.** Um usuário é contado como ativo em um dia se qualquer uma das seguintes condições for verdadeira: * Ele enviou pelo menos uma mensagem de chat no Claude. * Ele 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 no git. * Ele teve pelo menos uma sessão do Cowork com uso de ferramentas ou atividade de mensagens. **Chat and Cowork unified.** O Chat and Cowork unified traz os recursos do Cowork para o chat do claude.ai. A maior parte da atividade no Chat and Cowork unified é reportada sob o valor de produto `chat_cowork_unified`, e não `chat` ou `cowork`. Na atividade de usuários e no uso de skills, conectores e plugins, esse uso aparece no objeto `chat_cowork_unified_metrics`. Nos resumos de atividade, ele é contabilizado em `chat_cowork_unified_daily_active_user_count`, `chat_cowork_unified_weekly_active_user_count` e `chat_cowork_unified_monthly_active_user_count`. Quando um usuário começa a usar o Chat and Cowork unified, o uso dele sai dos seus números de chat e Cowork e passa para os números do Chat and Cowork unified. O uso dos dias anteriores ao momento em que um usuário começa a usar o Chat and Cowork unified permanece em chat ou Cowork. Os números de toda a organização, como uso total de tokens, custo total e contagens gerais de usuários ativos, não mudam. Relatórios de custo e uso filtrados por produto deixam de fora o uso do Chat and Cowork unified, a menos que `products[]` inclua `chat_cowork_unified`. Algumas atividades de usuários do Chat and Cowork unified, como o modo de voz, ainda podem ser informadas em chat ou Cowork. A atividade de um usuário também pode ser dividida entre produtos no dia em que ele começa a usar o Chat and Cowork unified. O mesmo vale para o dia em que o Chat and Cowork unified é desativado para esse usuário. A forma como a atividade é dividida não é garantida. Um usuário pode aparecer tanto nas contagens de chat ou Cowork quanto nas contagens do Chat and Cowork unified. Isso pode ocorrer em um dia em que ele usa o Chat and Cowork unified e parte de sua atividade ainda é reportada em chat ou Cowork. As contagens semanais e mensais podem incluí-lo em ambas quando a janela tem atividade dos dois tipos, mesmo em dias diferentes. Por exemplo, a janela pode abranger dias antes e depois de ele começar a usar o Chat and Cowork unified. Quando você filtra a atividade de usuários por projeto, a atividade de projeto de cada dia é contabilizada em apenas um lugar. Se um usuário enviou uma mensagem de chat no Chat and Cowork unified naquele dia, toda a sua atividade de projeto é contabilizada em `chat_cowork_unified_metrics.chat`. Caso contrário, ela é contabilizada em `chat_metrics`. **Blocos de métricas por produto.** Os 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 contagens zeradas em vez de um objeto `null`. A exceção é o Chat and Cowork unified: em implantações que não o oferecem, seus campos são omitidos da resposta. Campos individuais dentro desses objetos podem ser `null`, o que significa que o valor não está disponível. Por exemplo, quando você filtra a atividade de usuários por projeto, `distinct_skills_used_count` em `chat_metrics` é `null`. A [referência da Claude Enterprise Analytics API](https://platform.claude.com/docs/pt-BR/api/beta/organization/analytics) mostra quais campos podem ser `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 são strings decimais em centavos.** Os valores monetários são retornados como strings decimais, como `"41280.000000"` (que representa $412,80 USD). Para converter para dólares, analise como decimal e divida por 100. Evite a análise com ponto flutuante binário para valores que possam ultrapassar vários milhões de dólares. **Os “rate limits” (limites de taxa) se aplicam no nível da organização**, e 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 da sua conta Anthropic para discutir o ajuste do limite. ## Versionamento Envie o cabeçalho `anthropic-version` em todas as requisições; consulte [Versões](https://platform.claude.com/docs/pt-BR/api/versioning) para ver as versões disponíveis. ## Limitações conhecidas ### Claude Code por meio do Amazon Bedrock 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. ### Claude Code e Cowork com chaves de criptografia gerenciadas pelo cliente Se sua organização usa [chaves de criptografia gerenciadas pelo cliente](https://platform.claude.com/docs/pt-BR/manage-claude/cmek), a Anthropic omite alguns detalhes do uso do Claude Code e do Cowork de suas análises de uso, para proteger seus dados. Como resultado, não use os seguintes números da Claude Enterprise Analytics API para medir o quanto sua organização usa o Claude Code ou o Cowork. Eles podem ser zero ou menores do que o uso real: * **Alterações de código:** Na atividade de usuários, estes campos em `claude_code_metrics.core_metrics` podem ser zero: `lines_of_code` (linhas adicionadas e removidas) e `commit_count`. O campo `pull_request_count` pode ser menor do que o número real de pull requests. * **Skills iniciadas com um comando de barra:** Se um usuário inicia uma skill no Claude Code ou no Cowork digitando um comando de barra, como `/skill-name`, esse uso não é contado. Isso se aplica ao uso de skills e às contagens de skills do Cowork na atividade de usuários. As skills que o Claude invoca sem um comando de barra continuam sendo contadas. Para outras alterações nas análises com chaves de criptografia gerenciadas pelo cliente, consulte [O que o CMEK cobre no Claude Enterprise](https://platform.claude.com/docs/pt-BR/manage-claude/cmek-coverage-claude-enterprise#turned-off-or-changed). ## Próximos passos Acompanhe sessões do Claude Code, alterações de código e uso de ferramentas com uma chave de Admin API. Acompanhe o uso de tokens e os custos da sua organização. Referência de endpoints para dados de engajamento, adoção e custo. Dados de auditoria e conformidade usam seus próprios tipos de chave.