A API de Análise oferece aos Proprietários Primários do plano Enterprise acesso programático aos dados de engajamento, adoção, uso e custo da sua organização. Use-a para criar painéis internos, acompanhar tendências de adoção, reconciliar gastos com sua fatura mensal e alimentar dados do Claude em suas ferramentas de relatório existentes.
A API de Análise está disponível em planos Enterprise. Os Proprietários Primários podem gerar chaves de API para começar.
Como isso é diferente do painel de análise e da API de Conformidade?
Todas as três opções oferecem diferentes visualizações dos dados da sua organização:
O painel de Análise (acessado via Análise) mostra dados de uso visualizados no produto. É a ferramenta certa para monitoramento diário quando você não precisa integrar dados em outro lugar.
A API de Análise retorna as mesmas métricas agregadas, mas programaticamente — para que você possa extraí-las em ferramentas de BI, mapeá-las contra organogramas, automatizar fluxos de trabalho de relatório e reconciliar dados de custo contra registros internos. Os dados de engajamento e adoção são agregados por organização, por dia. Os dados de uso e custo estão disponíveis com divisões mais granulares por usuário e agrupadas por tempo.
A API de Conformidade é para casos de uso de governança e auditoria. Oferece acesso a ações de usuários individuais, eventos de atividade brutos e conteúdo de conversas. Se você precisar de métricas de engajamento agregadas para painéis, em vez de eventos brutos para auditoria, use a API de Análise.
Comece
Para acessar a API de Análise, você precisa de acesso de Proprietário Primário à sua organização Enterprise.
Siga estas etapas:
Navegue até Análise > Chaves de API.
Encontre o botão Acesso em API de Análise e ative-o.
Clique em "+ Criar chave" para gerar uma nova chave de API. Mantenha esta chave privada — trate-a como uma senha.
Use a chave com o cabeçalho
x-api-keyem suas solicitações.
Para detalhes completos de autenticação, referências de endpoints e exemplos de código, consulte nosso guia de referência da API de Análise do Claude Enterprise.
Quais dados estão disponíveis?
A API de Análise inclui nove endpoints em duas categorias.
Engajamento e adoção
Esses endpoints retornam métricas de engajamento agregadas, por organização, por dia. Os dados estão disponíveis para até os últimos 90 dias (não antes de 1º de janeiro de 2026).
Atividade do usuário: Métricas de engajamento por usuário em todas as superfícies do Claude. Inclui contagens de conversas, mensagens enviadas, projetos criados, arquivos enviados, artefatos criados, habilidades usadas, conectores usados, métricas do Claude Code como commits, pull requests e linhas de código, e métricas do Cowork como sessões iniciadas, ações de ferramentas, turnos de dispatch e invocações de habilidades e conectores.
Resumo de atividade: Contagens de usuários ativos diários, semanais e mensais em toda a organização no Claude, Claude Code e Cowork, juntamente com utilização de assentos e contagens de convites pendentes. Suporta intervalos de datas de até 31 dias por solicitação.
Uso de projeto de chat: Contagens de conversas e usuários divididas por projeto, para projetos do Claude.
Uso de habilidades: Quantos usuários estão usando cada habilidade, com divisões para sessões do Claude, Claude Code e Cowork separadamente.
Uso de conectores: Quais conectores sua organização está usando e quantos usuários únicos usaram cada um, com divisões para sessões do Claude, Claude Code e Cowork separadamente.
Uso e custo
Nota: Os endpoints de custo e uso se aplicam a planos Enterprise baseados em uso. Para planos Enterprise baseados em assentos, esses endpoints refletirão apenas o uso extra.
Esses endpoints (disponíveis agora em beta) retornam dados de uso de tokens e custo em USD em todas as superfícies do Claude. Use-os para acompanhar o uso entre faturas mensais, reconciliar a cobrança da Anthropic contra centros de custo internos e informar limites de gastos com base no comportamento real do usuário.
Uso de tokens por usuário: Usuários classificados por uso de tokens em um intervalo de datas, com divisões opcionais por produto, modelo, janela de contexto, região de inferência ou velocidade.
Custo por usuário: Usuários classificados por gastos em USD em um intervalo de datas, com divisões opcionais por produto, modelo, tipo de custo (tokens, busca na web, execução de código) ou tipo de token.
Uso de tokens ao longo do tempo: Uso de tokens agrupado por minuto, hora ou dia, opcionalmente dividido por produto, modelo, janela de contexto, região de inferência ou velocidade.
Custo ao longo do tempo: Custo em USD agrupado por minuto, hora ou dia, com as mesmas opções de agrupamento mais tipo de custo e tipo de token.
Os dados são atualizados a cada quatro horas e podem levar até 24 horas. Os valores podem ser revisados por até 30 dias conforme eventos atrasados são reconciliados, portanto, para totais de qualidade de faturamento, consulte datas com pelo menos 30 dias no passado.
Limites de dados
Os endpoints de engajamento e adoção retornam dados para uma única data ou intervalo de datas. Os dados estão disponíveis apenas após 1º de janeiro de 2026 e para datas com mais de três dias atrás.
Os endpoints de uso e custo permitem consultar uma janela de até 31 dias, voltando até 365 dias a partir de hoje. Para totais de qualidade de faturamento, consulte datas com pelo menos 30 dias no passado para que eventos atrasados tenham tempo de ser reconciliados.
A API tem um limite de taxa padrão de 60 solicitações por minuto. Se isso não atender às necessidades da sua organização, entre em contato com seu Contato Anthropic ou nosso time de Vendas.
Importante: Se você está usando Claude Code via Amazon Bedrock, a API de Análise não retornará dados relacionados ao Claude Code.