--- title: APIs de analítica url: https://platform.claude.com/docs/es/manage-claude/analytics-api description: 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 de producto, y cuál uses depende de qué producto de Claude administra tu organización: * La **API de Analytics de Claude Code** reporta métricas diarias de productividad de Claude Code para organizaciones que usan Claude Platform. Forma parte de la [Admin API](https://platform.claude.com/docs/es/manage-claude/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? | API | Tipo de clave | Se crea en | Quién puede crearla | Qué cubre | | ----------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **API de Analytics de Claude Code** | Clave de Admin API (`sk-ant-admin01-...`) | Página [Claves de administrador](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) en Claude Console | Administrador de la organización | Mé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 API** | Clave de Analytics API | [claude.ai > Configuración de la organización > API](https://claude.ai/admin-settings/api-access) | Propietario principal | Participación y adopción a nivel de toda la organización (actividad de usuarios, resúmenes de usuarios activos, uso de proyectos, skills 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. La única excepción es la [API de análisis de uso y costos](https://platform.claude.com/docs/es/manage-claude/usage-cost-analytics-api), a la que las organizaciones de Claude Enterprise llaman con su clave de Analytics API. Ambas APIs de analítica de producto aparecen en la [referencia de la Admin API](https://platform.claude.com/docs/es/api/beta/organization), 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 de tokens y costos en lugar de analítica de producto? Consulta la [API de análisis de uso y costos](https://platform.claude.com/docs/es/manage-claude/usage-cost-analytics-api), que sirve tanto a organizaciones de Claude Console como de Claude Enterprise. Si quieres ver los datos de participación y adopción en el producto en lugar de hacerlo de forma programática, usa el [panel de Analytics](https://claude.ai/analytics/activity) 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](https://platform.claude.com/docs/es/manage-claude/compliance-api-access). ## 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](https://platform.claude.com/docs/es/manage-claude/admin-api), y su uso es gratuito. Sigue los pasos en [Crear una clave de Admin API](https://platform.claude.com/docs/es/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization). Pasa la clave en el encabezado `x-api-key`: ```bash curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08" \ -H "anthropic-version: 2026-10-21" \ -H "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 [API de Analytics de Claude Code](https://platform.claude.com/docs/es/manage-claude/claude-code-analytics-api) y la [referencia de la API](https://platform.claude.com/docs/es/api/beta/organization/usage_report/retrieve_claude_code). ## 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. Solo el propietario principal de la organización puede habilitar el acceso a la API y crear claves de Analytics API. Ve a [claude.ai > Configuración de la organización > API](https://claude.ai/admin-settings/api-access) 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. Pasa la clave en el encabezado `x-api-key` e incluye el encabezado [`anthropic-version`](https://platform.claude.com/docs/es/api/versioning) 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](https://platform.claude.com/docs/es/api/beta/organization/analytics). 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), Chat and Cowork unified (actividad de chat y sesiones de Cowork) 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) Los endpoints de informes de costos y uso en `/v1/organizations/analytics/` (`usage_report`, `cost_report`, `user_usage_report` y `user_cost_report`) son heredados y siguen siendo compatibles. Para integraciones nuevas, usa la [API de análisis de uso y costos](https://platform.claude.com/docs/es/manage-claude/usage-cost-analytics-api). Para migrar una integración existente, consulta [Migrar desde los informes de uso y costos de Claude Enterprise](https://platform.claude.com/docs/es/manage-claude/usage-cost-analytics-api#migrate-from-enterprise-analytics-reports). Los demás endpoints de la Claude Enterprise Analytics API no son heredados. Para conocer los detalles de los endpoints, los parámetros y los esquemas de respuesta, consulta la [referencia de la Claude Enterprise Analytics API](https://platform.claude.com/docs/es/api/beta/organization/analytics). 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 alrededor de las 13:00–13:30 UTC del día siguiente (un retraso de 1 día). Hasta entonces, el día disponible más reciente suele ser 2 días antes de la fecha UTC actual. Los datos llegan más tarde los días en que un pipeline de datos ascendente se retrasa, y la actualización exacta varía según la consulta. 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 el pipeline de datos por parte de Anthropic; contacta al soporte si la brecha persiste. **Los endpoints de costos y uso** siguen un modelo de actualización diferente. Los datos suelen estar disponibles dentro de las 4 horas posteriores al uso subyacente, pero pueden tardar hasta 24 horas. Los valores pueden revisarse a medida que llegan eventos tardíos y se ejecuta la conciliación, hasta aproximadamente 7 días después del final del mes calendario. Por ejemplo, los valores del 1 de octubre pueden cambiar hasta aproximadamente el 7 de noviembre. Para obtener totales aptos para facturación, consulta solo los meses que terminaron hace al menos 7 días. Las respuestas de costos y uso incluyen una marca de tiempo `data_refreshed_at`. Si omites `ending_at`, su valor predeterminado es 31 días después de `starting_at` o la hora actual, lo que ocurra primero. Ese rango puede extenderse más allá de `data_refreshed_at`, y los datos posteriores a ese momento están incompletos. 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 con tu organización de Claude Enterprise que incluyó “tool use” (uso de herramientas) o actividad de git. * Tuvo al menos una sesión de Cowork con uso de herramientas o actividad de mensajes. **Chat and Cowork unified.** Chat and Cowork unified lleva las funciones de Cowork al chat de claude.ai. La mayor parte de la actividad en Chat and Cowork unified se informa con el valor de producto `chat_cowork_unified`, no con `chat` ni `cowork`. En la actividad de usuarios y en el uso de skills, conectores y plugins, este uso aparece en el objeto `chat_cowork_unified_metrics`. En los resúmenes de actividad, se cuenta en `chat_cowork_unified_daily_active_user_count`, `chat_cowork_unified_weekly_active_user_count` y `chat_cowork_unified_monthly_active_user_count`. Cuando un usuario empieza a usar Chat and Cowork unified, su uso sale de tus cifras de chat y Cowork y pasa a las cifras de Chat and Cowork unified. El uso de los días anteriores a que un usuario empiece a usar Chat and Cowork unified permanece en chat o Cowork. Las cifras de toda la organización, como el uso total de tokens, el costo total y los recuentos generales de usuarios activos, no cambian. Los informes de costos y uso filtrados por producto excluyen el uso de Chat and Cowork unified a menos que `products[]` incluya `chat_cowork_unified`. Parte de la actividad de los usuarios de Chat and Cowork unified, como el modo de voz, todavía puede informarse en chat o Cowork. La actividad de un usuario también puede dividirse entre productos el día en que empieza a usar Chat and Cowork unified. Lo mismo ocurre el día en que se desactiva para ese usuario. No se garantiza cómo se divide la actividad. Un usuario puede aparecer tanto en los recuentos de chat o Cowork como en los recuentos de Chat and Cowork unified. Esto puede ocurrir un día en que usa Chat and Cowork unified y parte de su actividad todavía se informa en chat o Cowork. Los recuentos semanales y mensuales pueden incluirlo en ambos cuando la ventana tiene actividad de ambos tipos, incluso en días diferentes. Por ejemplo, la ventana podría abarcar días antes y después de que comenzara a usar Chat and Cowork unified. Cuando filtras la actividad de usuarios por proyecto, la actividad de proyecto de cada día se cuenta en un solo lugar. Si un usuario envió un mensaje de chat en Chat and Cowork unified ese día, toda su actividad de proyecto se cuenta en `chat_cowork_unified_metrics.chat`. De lo contrario, se cuenta en `chat_metrics`. **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 recuentos en cero en lugar de un objeto `null`. La excepción es Chat and Cowork unified: en las implementaciones que no lo ofrecen, sus campos se omiten de la respuesta. Los campos individuales dentro de estos objetos pueden ser `null`, lo que significa que el valor no está disponible. Por ejemplo, cuando filtras la actividad de usuarios por proyecto, `distinct_skills_used_count` en `chat_metrics` es `null`. La [referencia de la Claude Enterprise Analytics API](https://platform.claude.com/docs/es/api/beta/organization/analytics) muestra qué campos pueden ser `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 importe son cadenas decimales en centavos.** Los importes monetarios se devuelven como cadenas decimales como `"41280.000000"` (que representa $412.80 USD). Para convertirlos a dólares, analízalos como decimales y divídelos entre 100. Evita el análisis en punto flotante binario para valores que podrían superar varios millones de dólares. **Los “rate limits” (límites de velocidad) se aplican a nivel de organización**, no por cada 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 hablar sobre ajustar el límite. ## Control de versiones Envía el encabezado `anthropic-version` en cada solicitud; consulta [Versiones](https://platform.claude.com/docs/es/api/versioning) para ver las versiones disponibles. ## Limitaciones conocidas ### Claude Code a través de Amazon Bedrock 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. ### Claude Code y Cowork con claves de cifrado administradas por el cliente Si tu organización usa [claves de cifrado administradas por el cliente](https://platform.claude.com/docs/es/manage-claude/cmek), Anthropic deja fuera de sus análisis de uso algunos detalles del uso de Claude Code y Cowork, para proteger tus datos. Como resultado, no uses los siguientes números de la Claude Enterprise Analytics API para medir cuánto usa tu organización Claude Code o Cowork. Pueden ser cero o inferiores al uso real: * **Cambios de código:** En la actividad de usuarios, estos campos en `claude_code_metrics.core_metrics` pueden ser cero: `lines_of_code` (líneas agregadas y eliminadas) y `commit_count`. El campo `pull_request_count` puede ser inferior al número real de pull requests. * **Skills iniciadas con un comando de barra:** Si un usuario inicia una skill en Claude Code o Cowork escribiendo un comando de barra, como `/skill-name`, ese uso no se cuenta. Esto se aplica al uso de skills y a los recuentos de skills de Cowork en la actividad de usuarios. Las skills que Claude invoca sin un comando de barra siguen contándose. Para conocer otros cambios en los análisis con claves de cifrado administradas por el cliente, consulta [Qué cubre CMEK en Claude Enterprise](https://platform.claude.com/docs/es/manage-claude/cmek-coverage-claude-enterprise#turned-off-or-changed). ## Próximos pasos Haz seguimiento de las sesiones de Claude Code, los cambios de código y el uso de herramientas con una clave de Admin API. Haz seguimiento del uso de tokens y los costos de tu organización. Referencia de endpoints para datos de participación, adopción y costos. Los datos de auditoría y cumplimiento usan sus propios tipos de clave.