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 nos 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. Você também pode aproveitar o recurso de chat de análise para fazer perguntas sobre os dados subjacentes.
A API de Análise retorna métricas mais abrangentes e agregadas, mas de forma programática. Você pode extraí-las para ferramentas de BI, mapeá-las em organogramas, automatizar fluxos de trabalho de relatório e reconciliar dados de custo com 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 desagregações mais granulares por usuário e períodos de tempo.
A API de Conformidade é para casos de uso de governança e auditoria. Ela 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.
Soluções de parceiros
Plataformas líderes de observabilidade oferecem integrações prontas para uso para monitorar seu uso e custo da API Claude, sem escrever código personalizado. Essas integrações fornecem painéis, alertas e análises para ajudá-lo a gerenciar seu uso de API de forma eficaz.
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 despacho 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 desagregaçõ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 desagregações para sessões do Claude, Claude Code e Cowork separadamente.
Uso e custo
Nota: Os endpoints de custo e uso se aplicam aos planos Enterprise baseados em uso. Para planos Enterprise baseados em assentos, esses endpoints refletirão apenas créditos de uso.
Esses endpoints 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 com 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 desagregações opcionais por produto, modelo, janela de contexto, região de inferência ou velocidade.
Custo por usuário: Usuários classificados por gasto em USD em um intervalo de datas, com desagregaçõ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.
Nota: Os endpoints de custo e uso da exportação da API de Análise incluem preço com desconto e preço de tabela.
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 reconciliação.
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 com nosso time de Vendas.
Importante: Se você estiver usando Claude Code via Amazon Bedrock, a API de Análise não retornará dados relacionados ao Claude Code.