Descripción general
La API de Análisis de Claude Enterprise proporciona a tu organización acceso programático a datos de participación para el uso de Claude y Claude Code dentro de tu organización Enterprise. Ya sea que estés creando paneles internos para la actividad de usuarios o rastreando la adopción de proyectos, esta API proporciona las métricas agregadas que necesitas.
Agregación de datos
Todos los datos se agregan por organización, por día. Cada endpoint devuelve una instantánea para una única fecha que especifiques. Los datos del día (N-1) se ejecutan a las 10:00:00 UTC en el día N, y están disponibles para consultas tres días después de la agregación, para garantizar la precisión de los datos.
Si los datos no están disponibles dentro del cronograma anterior, esto generalmente indica una falla en la canalización de datos que nuestro equipo necesitará investigar internamente. Generalmente somos conscientes de tales problemas, pero por favor comunícalo a tu CSM si deseas una verificación o sospechas algo más.
Habilitación del acceso
Para crear nuevas claves de API de análisis, debes ser Propietario Principal dentro de tu organización Enterprise. Puedes hacerlo navegando a claude.ai/analytics/api-keys.
Algunos detalles más que podrían ser útiles:
Puedes habilitar/deshabilitar el acceso a la API pública en cualquier momento. Si deshabilitas el acceso desactivando el interruptor, todas las solicitudes serán rechazadas.
Necesitarás una clave con el alcance
read:analyticspara acceder a la API. Puedes crear múltiples claves para tu organización, pero los límites de velocidad se aplican a nivel de organización , no a nivel de clave . Consulta la sección "Limitación de velocidad" a continuación.Como siempre, recomendamos encarecidamente manejar las claves de API de forma segura: nunca compartas estas claves públicamente - son secretas y deben compartirse de forma segura.
URL base
Todas las solicitudes se envían a:
https://api.anthropic.com/v1/organizations/analytics/
Autenticación
Cada solicitud requiere una clave de API pasada en el encabezado x-api-key. Tu clave de API debe tener el alcance read:analytics. Puedes crear y administrar claves de API desde la configuración de administrador de claude.ai en la sección Claves de API.
Ejemplo de encabezados de solicitud:
x-api-key: $YOUR_API_KEY
Paginación
Varios endpoints devuelven resultados paginados. La paginación utiliza un enfoque basado en cursores, donde la respuesta incluye un token next_page que pasas en tu siguiente solicitud para recuperar la siguiente página de resultados.
Dos parámetros opcionales controlan la paginación:
limit (entero): Número de registros por página. Por defecto es 20 para el endpoint /users y 100 para todos los demás endpoints. El máximo es 1000.
page (cadena): El token de cursor opaco del campo next_page de la respuesta anterior. Omite esto en tu primera solicitud.
Cuando no hay más resultados, next_page será null en la respuesta.
Respuestas de error
Todos los endpoints devuelven códigos de error HTTP estándar:
Código | Significado |
400 | Un parámetro de consulta es inválido. Las causas comunes incluyen una fecha inválida, una fecha anterior a 1/1/26 (primera disponibilidad), o una fecha que es hoy o en el futuro. La disponibilidad de datos se retrasa tres días. |
404 | La clave de API falta, es inválida, o no tiene el alcance |
429 | Límite de velocidad excedido. Demasiadas solicitudes. |
503 | Falla transitoria, por favor reintentar. |
Limitación de velocidad
Tenemos límites de velocidad predeterminados en su lugar. Si eso no es suficiente para tu caso de uso, nos encantaría entender por qué. Si es necesario, podemos ajustar los límites de velocidad para tu organización—por favor comunícate con tu CSM.
Endpoints
1. Listar actividad de usuario
GET /v1/organizations/analytics/users
Devuelve métricas de participación por usuario para un único día. Cada elemento en la respuesta representa un usuario e incluye sus conteos de actividad en Claude (chat) y Claude Code.
Parámetros de consulta
Campo | Tipo | Requerido | Descripción |
| cadena | Sí | La fecha para la que recuperar métricas, en formato YYYY-MM-DD. |
| entero | No | Número de registros por página (predeterminado: 20, máximo: 1000). |
| cadena | No | Token de cursor del campo |
Campos de respuesta (por usuario)
Campo | Descripción |
| Identificador único para el usuario. |
| La dirección de correo electrónico del usuario. |
| Número de conversaciones distintas, específicamente dentro de Claude.ai. |
| Total de mensajes enviados, específicamente dentro de Claude.ai. |
| Número de proyectos creados, específicamente dentro de Claude.ai. |
| Número de proyectos distintos utilizados, específicamente dentro de Claude.ai. |
| Número de archivos cargados, específicamente dentro de Claude.ai. |
| Número de artefactos creados, específicamente dentro de Claude.ai. |
| Número de mensajes de pensamiento (extendidos), específicamente dentro de Claude.ai. |
| Número de habilidades distintas utilizadas, específicamente dentro de Claude.ai. |
| Número total de conectores invocados, específicamente dentro de Claude.ai. |
| Número de confirmaciones de git realizadas a través de Claude Code. |
| Número de solicitudes de extracción creadas a través de Claude Code. |
| Total de líneas de código agregadas. |
| Total de líneas de código eliminadas. |
| Número de sesiones distintas de Claude Code. |
| Conteos aceptados y rechazados para la herramienta Edit. |
| Conteos aceptados y rechazados para la herramienta Multi-Edit. |
| Conteos aceptados y rechazados para la herramienta Write. |
| Conteos aceptados y rechazados para la herramienta Notebook Edit. |
| Total de invocaciones de la herramienta de búsqueda web. Esto se aplica tanto al uso de claude.ai como al de claude code dentro de tu organización. |
Ejemplo de solicitud
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/users?date=2025-01-01&limit=3"
--header "x-api-key: $YOUR_API_KEY"
2. Resumen de actividad
GET /v1/organizations/analytics/summaries
Devuelve un resumen de alto nivel de participación y utilización de asientos por día para tu organización para un rango de fechas determinado. La respuesta es una lista de días con conteos agregados dentro del rango de fechas. Ten en cuenta que la diferencia máxima entre ending_date y starting_date debe ser 31 días, y hay un retraso de tres días en la disponibilidad de datos. Esto es útil para rastrear usuarios activos diarios, tendencias semanales y mensuales, y asignación de asientos de un vistazo.
Definimos "activo" si alguno de los siguientes es verdadero:
El usuario envió al menos un mensaje de chat en Claude (chat).
El usuario tuvo al menos una sesión de Claude Code (local o remota) asociada con la organización C4E, con uso de herramientas/actividad de git
Parámetros de consulta
Campo | Tipo | Requerido | Descripción |
| cadena | Sí | La fecha de inicio para recuperar datos, en formato YYYY-MM-DD. Hay un retraso de tres días en la disponibilidad de datos, por lo que los datos más recientes a los que puedes acceder son de hace tres días. |
| cadena | No | La fecha de finalización opcional para recuperar datos, en formato YYYY-MM-DD. Esto es exclusivo. |
Campos de respuesta
Campo | Descripción |
| Primer día para el cual se agregan métricas, interpretado como una fecha UTC. Hay un retraso de tres días en la disponibilidad de datos, por lo que los datos más recientes a los que puedes acceder son de hace tres días. |
| Último día (exclusivo) para el cual se agregan métricas, interpretado como una fecha UTC |
| Número de usuarios activos en la fecha especificada (basado en consumo de tokens). |
| Número de usuarios activos dentro de la ventana móvil de 7 días que termina en la fecha especificada. |
| Número de usuarios activos dentro de la ventana móvil de 30 días que termina en la fecha especificada. |
| Número total de asientos actualmente asignados en tu organización. |
| Número de invitaciones pendientes que aún no han sido aceptadas. |
Nota: Las ventanas móviles para conteos semanales y mensuales miran hacia atrás desde la fecha especificada (inclusive). Si los datos están incompletos para algunos días dentro de la ventana (por ejemplo, si la fecha es menos de 30 días en el pasado), el conteo mensual puede subestimar la actividad.
Ejemplo de solicitud
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/summaries?starting_date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
3. Uso de proyectos de chat
GET /v1/organizations/analytics/apps/chat/projects
Devuelve datos de uso desglosados por proyecto de chat para una fecha determinada. Los proyectos son específicos de Claude (chat), por lo que este endpoint se enfoca en esa superficie. Cada elemento muestra el nombre del proyecto, cuántos usuarios únicos interactuaron con él, y el número total de conversaciones realizadas en ese proyecto.
Parámetros de consulta
Campo | Tipo | Requerido | Descripción |
| cadena | Sí | La fecha para la que recuperar métricas, en formato YYYY-MM-DD. Hay un retraso de tres días en la disponibilidad de datos, por lo que los datos más recientes a los que puedes acceder son de hace tres días. |
| entero | No | Número de registros por página (predeterminado: 100, máximo: 1000). |
| cadena | No | Token de cursor del campo |
Campos de respuesta (por proyecto)
Campo | Descripción |
| El nombre del proyecto. |
| El id de proyecto etiquetado, es decir, "claude_proj_{ID}" |
| Número de usuarios únicos que utilizaron este proyecto en la fecha determinada. |
| Número de conversaciones en este proyecto en la fecha determinada. |
| Número total de mensajes enviados dentro de este proyecto en la fecha determinada. |
Ejemplo de solicitud
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/apps/chat/projects?date=2025-01-01&limit=50"
--header "x-api-key: $YOUR_API_KEY"
4. Uso de habilidades
GET /v1/organizations/analytics/skills
Devuelve datos de uso de habilidades en Claude (chat) y Claude Code dentro de tu organización para una fecha determinada. Cada elemento representa una habilidad y muestra cuántos usuarios únicos la utilizaron.
Parámetros de consulta
Campo | Tipo | Requerido | Descripción |
| cadena | Sí | La fecha para la que recuperar métricas, en formato YYYY-MM-DD. Hay un retraso de tres días en la disponibilidad de datos, por lo que los datos más recientes a los que puedes acceder son de hace tres días. |
| entero | No | Número de registros por página (predeterminado: 100, máximo: 1000). |
| cadena | No | Token de cursor del campo |
Campos de respuesta (por habilidad)
Campo | Descripción |
| El nombre de la habilidad. |
| Número de usuarios únicos que utilizaron esta habilidad en la fecha determinada. |
| Número de conversaciones distintas en las que la habilidad fue utilizada al menos una vez, en chat. |
| Número de sesiones remotas distintas en las que la habilidad fue utilizada al menos una vez, en Claude Code. |
Ejemplo de solicitud
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/skills?date=2025-01-01"
--header "x-api