Claude Platform Docs
  • Mensajes
  • Agentes gestionados
  • Administración

Search...
⌘K
Organización
API de administraciónEspacios de trabajo
Autenticación
Descripción generalCrear una clave de API de administraciónFederación de identidades de carga de trabajoGestionar WIF mediante APIReferencia de WIF
Monitoreo
API de uso y costosAPI de límites de velocidadAPIs de análisisAPI de análisis de Claude CodeAPI de límites de gasto
Datos y cumplimiento
Residencia de datosAPI y retención de datosTransparencia de acceso
API de cumplimiento
Descripción generalObtener accesoFeed de actividadChats, archivos y proyectosOrganizaciones, usuarios, roles, grupos y configuraciónDiseñar tu integraciónErroresPreguntas frecuentes

Log in
APIs de análisis
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Claude Platform Docs

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Claude on AWS
  • Claude on Google Cloud

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Administración/Monitoreo

APIs de analíticas

Comprende qué API de analíticas y qué clave de API necesita tu organización, y luego aprovisiona el acceso a las métricas de productividad de Claude Code o a los datos de interacción y adopción de Claude Enterprise.

Anthropic proporciona dos APIs de analíticas, y cuál uses depende de qué producto de Claude gestiona tu organización:

  • La Claude Code Analytics API reporta métricas diarias de productividad de Claude Code para organizaciones que usan la Claude Platform. Forma parte de la Admin API y usa una clave de Admin API.
  • La Claude Enterprise Analytics API reporta datos de interacción, adopción y costos a nivel de toda la organización en los distintos productos de Claude (chat, proyectos, Claude Code y más) para organizaciones de Claude Enterprise. Usa una clave de Analytics API creada en claude.ai.

Las dos APIs usan tipos de clave diferentes, creados en lugares diferentes por roles diferentes. Esta página describe qué API se ajusta a tu organización y cómo crear la clave correcta.

¿Qué API necesitas?

APITipo de claveCreada enQuién puede crearlaQué cubre
Claude Code Analytics APIClave de Admin API (sk-ant-admin01-...)Claude Console > Settings > Admin keysAdministrador de la organizaciónMétricas diarias de Claude Code por usuario: sesiones, líneas de código, commits, pull requests, aceptación de herramientas y costo estimado por modelo
Claude Enterprise Analytics APIClave de Analytics APIclaude.ai > Organization settings > APIPropietario principalInteracción y adopción a nivel de toda la organización (actividad de usuarios, resúmenes de usuarios activos, uso de proyectos, habilidades y conectores), además de informes de costos y uso

Los tipos de clave no son intercambiables: una clave de Admin API no puede llamar a la Claude Enterprise Analytics API, y una clave de Analytics API no puede llamar a la Admin API. Ambas APIs aparecen bajo la referencia de la Admin API, pero son APIs separadas con tipos de clave separados. Si tu organización usa tanto la Claude Platform como Claude Enterprise, puedes aprovisionar ambas claves y usar cada API para sus propios datos.



¿Buscas datos de uso y costos de la API en lugar de analíticas de producto? Consulta la Usage and Cost API, que explica la ruta correcta tanto para organizaciones de Claude Console como de Claude Enterprise.



Si quieres ver datos de interacción y adopción en el producto en lugar de hacerlo de forma programática, usa el panel de Analytics en claude.ai. Para casos de uso de gobernanza y auditoría (acciones individuales de usuarios, eventos de actividad sin procesar, contenido de conversaciones), consulta la Compliance API.

Obtener acceso a la Claude Code Analytics API

La Claude Code Analytics API está disponible para todas las organizaciones con acceso a la Admin API, y su uso es gratuito.

  1. 1

    Crea una clave de Admin API

    Sigue los pasos en Crear una clave de Admin API.

  2. 2

    Llama a la API

    Pasa la clave en el encabezado 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: $ADMIN_API_KEY"

Para conocer las métricas disponibles, los parámetros de solicitud y el esquema de respuesta, consulta la guía de la Claude Code Analytics API y la referencia de la API.

Obtener acceso a la Claude Enterprise Analytics API

La Claude Enterprise Analytics API está disponible para organizaciones de Claude Enterprise. Los datos de interacción y adopción están disponibles en todos los planes Enterprise. Los endpoints de costos y uso aplican a los planes Enterprise basados en uso; para los planes Enterprise basados en licencias, reflejan únicamente los créditos de uso.

  1. 1

    Inicia sesión como propietario principal

    Solo el propietario principal de la organización puede habilitar el acceso a la API y crear claves de Analytics API.

  2. 2

    Habilita el acceso a la API y crea una clave

    Ve a claude.ai > Organization settings > API y habilita el acceso público a la API, luego crea una clave de Analytics API. Las claves llevan el alcance read:analytics. Copia el secreto mostrado y guárdalo en tu gestor de secretos.

  3. 3

    Llama a la API

    Pasa la clave en el encabezado x-api-key. Los endpoints se encuentran bajo https://api.anthropic.com/v1/organizations/analytics/. Para ejemplos de solicitudes, parámetros y esquemas de respuesta, consulta la referencia de la Claude Enterprise Analytics API.

La Claude Enterprise Analytics API proporciona:

  • Actividad de usuarios: métricas diarias por usuario en chat (conversaciones, mensajes, proyectos, archivos, artifacts), Claude Code (sesiones, commits, pull requests, líneas de código, acciones de herramientas) y otros productos de Claude
  • Resúmenes de actividad: usuarios activos diarios, semanales y mensuales a nivel de organización, recuentos de licencias e invitaciones pendientes
  • Uso de proyectos, habilidades y conectores: desgloses de adopción para proyectos de chat, habilidades y conectores
  • Informes de costos y uso: uso de tokens y costos por usuario y a nivel de organización a lo largo del tiempo (planes Enterprise basados en uso)

Para detalles de los endpoints, parámetros y esquemas de respuesta, consulta la referencia de la Claude Enterprise Analytics API. Las siguientes secciones cubren la actualidad de los datos, las definiciones de métricas y la orientación operativa que aplican a todos esos endpoints.

Disponibilidad y actualidad de los datos

Los datos de la Claude Enterprise Analytics API están disponibles para fechas a partir del 1 de enero de 2026.

Los endpoints de interacción y adopción (actividad de usuarios, resúmenes, proyectos, habilidades, conectores) devuelven una instantánea por día para la fecha que especifiques. Los datos de un día determinado se agregan a las 10

UTC del día siguiente y quedan disponibles para consulta tres días después de la agregación. Si los datos no están disponibles dentro de ese plazo, generalmente indica una falla en el pipeline de datos del lado de Anthropic; contacta a soporte si la brecha persiste.

Los endpoints de costos y uso siguen un modelo de actualidad diferente. Los datos suelen estar disponibles dentro de las cuatro horas posteriores al uso subyacente, pero pueden tardar hasta 24 horas. Los valores de una fecha determinada pueden revisarse durante hasta 30 días a medida que llegan eventos tardíos y se ejecuta la conciliación. Para obtener totales con calidad de facturación, consulta fechas de al menos 30 días en el pasado.



Las respuestas de costos y uso incluyen una marca de tiempo data_refreshed_at. Cuando se omite ending_at (el valor predeterminado es la hora actual), la respuesta incluye una cola de datos posteriores a data_refreshed_at que está incompleta. Para obtener resultados estables en llamadas repetidas, establece ending_at en un valor igual o anterior a un data_refreshed_at devuelto previamente.

Cómo se definen las métricas

Usuarios activos. Un usuario cuenta como activo en un día si se cumple cualquiera de las siguientes condiciones: envió al menos un mensaje de chat en Claude, tuvo al menos una sesión de Claude Code (local o remota) asociada a tu organización de Claude Enterprise que incluyó uso de herramientas o actividad de git, o tuvo al menos una sesión de Cowork con uso de herramientas o actividad de mensajes.

Bloques de métricas por producto. Los objetos de métricas por producto (por ejemplo, las métricas de Office Agent o Cowork en un registro de actividad de usuario) siempre están presentes en cada registro. Las organizaciones sin uso de ese producto ven valores en cero en lugar de null.

Nombres de conectores. Los nombres de conectores se normalizan entre fuentes. Por ejemplo, Atlassian MCP server, mcp-atlassian y atlassian_MCP aparecen todos como atlassian en el endpoint de uso de conectores.

Trabajar con la API

Los cursores de paginación están vinculados a la consulta que los emitió. En los endpoints de costos y uso, no cambies los parámetros de consulta a mitad de la secuencia: si cambias products[], group_by[], order_by, el rango de fechas o cualquier filtro y pasas un cursor antiguo, la solicitud devuelve un error 400. Para cambiar parámetros, reinicia desde la primera página sin cursor.

Los parámetros de lista usan notación de corchetes. Repite el parámetro para cada valor, por ejemplo products[]=chat&products[]=claude_code.

Los campos de importe son cadenas decimales en centavos. Los importes monetarios se devuelven como cadenas decimales como "41280.000000" (que representa $412.80). Para convertir a dólares, analiza como decimal y divide entre 100. Evita el análisis en punto flotante binario para valores que puedan superar varios millones de dólares.

Los límites de velocidad se aplican a nivel de organización, no por clave, con un valor predeterminado de 60 solicitudes por minuto en todos los endpoints de esta API. Si eso no es suficiente para tu caso de uso, contacta a tu equipo de cuenta de Anthropic para discutir el ajuste del límite.

Limitaciones conocidas

Si tu organización usa Claude Code a través de Amazon Bedrock, la Claude Enterprise Analytics API no devuelve la actividad de Claude Code para ese uso.

Próximos pasos

Claude Code Analytics API

Rastrea sesiones de Claude Code, cambios de código y uso de herramientas con una clave de Admin API.

Usage and Cost API

Rastrea el uso de tokens de la API y los costos de tu organización.

Referencia de la Claude Enterprise Analytics API

Referencia de endpoints para datos de interacción, adopción y costos.

Obtener acceso a la Compliance API

Los datos de auditoría y cumplimiento usan sus propios tipos de clave.

Was this page helpful?

  • ¿Qué API necesitas?
  • Obtener acceso a la Claude Code Analytics API
  • Obtener acceso a la Claude Enterprise Analytics API
  • Disponibilidad y actualidad de los datos
  • Cómo se definen las métricas
  • Trabajar con la API
  • Limitaciones conocidas
  • Próximos pasos