AdministraciónMonitoreo

APIs de analítica

Copy page



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

Anthropic ofrece dos APIs de analítica, y cuál uses depende de qué producto de Claude administra tu organización:

• La Claude Code Analytics API reporta métricas diarias de productividad de Claude Code para organizaciones que usan Claude Platform. Forma parte de la Admin API y usa una clave de Admin API.
• La Claude Enterprise Analytics API reporta datos de participación, adopción y costos a nivel de toda la organización en los 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?

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 en la referencia de la Admin API, pero son APIs separadas con tipos de clave separados. Si tu organización usa tanto Claude Platform como Claude Enterprise, puedes habilitar ambas claves y usar cada API para sus propios datos.

Obtén acceso a la Claude Code Analytics API

La Claude Code Analytics API está disponible para toda organización 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: $ANTHROPIC_ADMIN_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.

Obtén acceso a la Claude Enterprise Analytics API

La Claude Enterprise Analytics API está disponible para organizaciones de Claude Enterprise. Los datos de participación y adopción están disponibles en todos los planes Enterprise. Los endpoints de costos y uso se aplican a los planes Enterprise basados en uso; para los planes Enterprise basados en asientos, 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 tienen el alcance read:analytics. Copia el secreto que se muestra y guárdalo en tu gestor de secretos.

3. 3

   Llama a la API

   Pasa la clave en el encabezado x-api-key e incluye el encabezado anthropic-version en cada solicitud. Los endpoints se encuentran en https://api.anthropic.com/v1/organizations/analytics/. Para ver 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, conteo de asientos e invitaciones pendientes
• Uso de proyectos, skills y conectores: desgloses de adopción para proyectos de chat, skills y conectores
• Informes de costos y uso: uso de tokens y costos a lo largo del tiempo por usuario y a nivel de organización (planes Enterprise basados en uso)

Para conocer los detalles de los endpoints, los parámetros y los 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 se 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 participación y adopción (actividad de usuarios, resúmenes, proyectos, skills, conectores) devuelven una instantánea diaria para la fecha que especifiques. Los datos de un día determinado suelen estar disponibles a partir de aproximadamente las 17:00 UTC del día siguiente (un retraso de 1 día); hasta entonces, el día disponible más reciente suele ser dos días antes de la fecha UTC actual. En ocasiones, los datos llegan más tarde y la actualización exacta varía según la consulta, así que, en lugar de suponer una hora fija, revisa la respuesta de error: solicitar una fecha que aún no está disponible devuelve un error 400 que indica el día disponible más reciente. Si los datos no están disponibles mucho después del retraso habitual, normalmente indica una falla en la canalización de datos por parte de Anthropic; comunícate con soporte si la brecha persiste.

Los endpoints de costos y uso siguen un modelo de actualidad diferente. Los datos normalmente están 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 totales con calidad de facturación, consulta fechas de al menos 30 días en el pasado.

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ó "tool use" (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 todos en cero en lugar de null.

Nombres de conectores. Los nombres de conectores se normalizan entre las distintas 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 montos son cadenas decimales en centavos. Los montos monetarios se devuelven como cadenas decimales como "41280.000000" (que representa $412.80). Para convertir a dólares, analízalo como decimal y divide entre 100. Evita el análisis con punto flotante binario para valores que puedan superar varios millones de dólares.

Los "rate limits" (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 conversar sobre el ajuste del límite.

Control de versiones

Envía el encabezado anthropic-version en cada solicitud; consulta Versiones de la API para ver las versiones disponibles.

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 correspondiente a ese uso.

Próximos pasos