Descripción general
La API de Claude Enterprise Analytics proporciona a tu organización acceso programático a datos de participación, adopción, uso y costo en todas las superficies de Claude dentro de tu organización Enterprise. Ya sea que estés creando paneles internos para la actividad de usuarios, rastreando la adopción de proyectos, reconciliando gastos con tu factura mensual o estableciendo límites de gasto, esta API proporciona las métricas 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 plazo 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 comunícalo a tu CSM si deseas una verificación o sospechas algo más.
Los endpoints de costo y uso tienen un modelo de actualización diferente. Consulta Endpoints de costo y uso a continuación para obtener más detalles.
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 adicionales 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, se denegarán todas las solicitudes.
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.
Encabezados de solicitud de ejemplo:
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. Para endpoints de costo y uso, los valores predeterminados varían según el endpoint y el ancho del intervalo — consulta Endpoints de costo y uso a continuación. 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.
Importante: No cambies parámetros de consulta en medio de la secuencia en endpoints de costo y uso. Los cursores están vinculados a los filtros y rango de fechas que los emitieron. Si cambias products[], order_by, group_by[], el rango de fechas o cualquier filtro y pasas un cursor antiguo, obtendrás un error 400.
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), una fecha que es hoy o en el futuro, o (en endpoints de costo y uso) un cursor de página que no coincide con los parámetros de consulta actuales. |
401 | Clave de API faltante o inválida (endpoints de costo y uso). |
404 | La clave de API falta, es inválida o no tiene el alcance |
410 | El cursor de página ya no es válido. Reinicia la paginación desde la primera página. |
429 | Límite de velocidad excedido. Demasiadas solicitudes. |
500 | Error interno (endpoints de costo y uso). |
504 | Solicitud agotada. |
Limitación de velocidad
Tenemos límites de velocidad predeterminados que se aplican en todos los endpoints de esta API. 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 — comunícate con tu CSM.
Endpoints de participación y adopción
1. Listar actividad de usuarios
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 recuentos de actividad en Claude (chat) y Claude Code.
Parámetros de consulta
Campo | Tipo | Requerido | Descripción |
| string | Sí | La fecha para recuperar métricas, en formato YYYY-MM-DD. |
| integer | No | Número de registros por página (predeterminado: 20, máximo: 1000). |
| string | No | Token de cursor de la respuesta anterior's |
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 distintos creados, específicamente dentro de Claude.ai. |
| Número de proyectos distintos utilizados, específicamente dentro de Claude.ai. |
| Número de archivos distintos cargados, específicamente dentro de Claude.ai. |
| Número de artefactos distintos creados, específicamente dentro de Claude.ai. |
| Número de artefactos compartidos distintos visualizados, 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 conversaciones compartidas visualizadas, 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 añadidas. |
| Total de líneas de código eliminadas. |
| Número de sesiones distintas de Claude Code. |
| Recuentos aceptados y rechazados para la herramienta Editar. |
| Recuentos aceptados y rechazados para la herramienta Edición múltiple. |
| Recuentos aceptados y rechazados para la herramienta Escribir. |
| Recuentos aceptados y rechazados para la herramienta Edición de cuadernos. |
| Total de invocaciones de la herramienta de búsqueda web. Esto se aplica tanto a claude.ai como al uso de código Claude dentro de su organización. |
Métricas del Agente de Office (por usuario)
Métricas del Agente de Office (por usuario) Cada registro de usuario también incluye un objeto office_metrics con desgloses por producto para Excel y PowerPoint. Este bloque siempre está presente en cada registro: las organizaciones sin uso del Agente de Office ven valores en cero en lugar de nulo.
El objeto office_metrics contiene dos claves: excel y powerpoint.
Cada clave contiene los mismos seis campos:
Campo | Descripción |
| Número de sesiones distintas del Agente de Office. |
| Número de mensajes enviados (uno por turno de agente completado). |
| Total de invocaciones de habilidades. Una única habilidad utilizada cinco veces cuenta como cinco. |
| Número de habilidades distintas utilizadas. |
| Total de invocaciones de conectores. Un único conector utilizado tres veces cuenta como tres. |
| Número de conectores distintos utilizados. |
*Nota: Donde [product] es uno de excel o powerpoint.
Métricas de Claude Cowork (por usuario)
Cada registro de usuario también incluye un objeto cowork_metrics con participación de Cowork por usuario. Este bloque siempre está presente en cada registro: las organizaciones sin uso de Cowork ven valores en cero en lugar de nulo.
Campo | Descripción |
| Número de sesiones distintas de Cowork. |
| Total de mensajes de usuario enviados en Cowork. |
| Llamadas de herramientas exitosas (Bash, Leer, Editar, etc.) |
| Turnos de agente completados en sesiones de Dispatch (agente de fondo). |
| Total de invocaciones de habilidades. Una única habilidad utilizada cinco veces cuenta como cinco. |
| Número de habilidades distintas utilizadas. |
| Total de invocaciones de conectores. Un único conector utilizado tres veces cuenta como tres. |
| Número de conectores distintos utilizados. |
Solicitud de ejemplo
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 del compromiso y la utilización de asientos por día para su organización en un rango de fechas determinado. La respuesta es una lista de días con recuentos agregados dentro del rango de fechas. Tenga 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 alguna de las siguientes condiciones es verdadera:
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 actividad de uso de herramientas/git
El usuario tuvo al menos una sesión de Claude Cowork con actividad de uso de herramientas o mensajes.
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 puede acceder son de hace tres días. |
| cadena | No | La fecha de finalización opcional para recuperar datos, en formato YYYY-MM-DD. Esta es exclusiva. |
Campos de respuesta
Campo | Descripción |
| Primer día para el cual se agregan las 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 puede acceder son de hace tres días. |
| Último día (exclusivo) para el cual se agregan las métricas, interpretado como una fecha UTC |
| Número de usuarios activos en la fecha especificada (basado en el 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 su organización. |
| Número de invitaciones pendientes que aún no han sido aceptadas. |
| Número de usuarios con ≥1 sesión de Cowork ese día |
| Número de usuarios con ≥1 sesión de Cowork en un período móvil de 7 días. |
| Número de usuarios con ≥1 sesión de Cowork en un período móvil de 30 días. |
Nota: Las ventanas móviles para recuentos 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 recuento mensual puede subestimar la actividad.
Solicitud de ejemplo
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 del proyecto 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 |
| string | 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 puede acceder son de hace tres días. |
| integer | No | Número de registros por página (predeterminado: 100, máximo: 1000). |
| string | No | Token de cursor de la respuesta anterior's |
Campos de respuesta (por proyecto)
Campo | Descripción |
| El nombre del proyecto. |
| El id del 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. |
| La marca de tiempo de creación del proyecto. |
|
|
Solicitud de ejemplo
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 su 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 |
| string | Sí | La fecha para la que se deben recuperar las 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 puede 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 de la respuesta anterior's |
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 especificada. |
| Número de conversaciones distintas en las que se utilizó la habilidad al menos una vez, en chat. |
| Número de sesiones remotas distintas en las que se utilizó la habilidad al menos una vez, en Claude Code. |
Métricas de Office Agent (por habilidad)
Cada registro de habilidad también incluye un objeto office_metrics que informa cuántas sesiones de Office Agent utilizaron la habilidad, desglosadas por producto. Este bloque siempre está presente: las organizaciones sin uso de Office Agent ven todos los valores en cero.
Campo | Descripción |
| Número de sesiones distintas de Office Agent en Excel en las que se utilizó esta habilidad. |
| Número de sesiones distintas de Office Agent en PowerPoint en las que se utilizó esta habilidad. |
Métricas de Claude Cowork (por habilidad)
Cada registro de habilidad también incluye un objeto cowork_metrics que informa cuántas sesiones de Cowork utilizaron la habilidad. Este bloque siempre está presente: las organizaciones sin uso de Cowork ven todos los valores en cero.
| Número de sesiones distintas de Cowork en las que se utilizó esta habilidad al menos una vez. |
Solicitud de ejemplo
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/skills?date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
5. Uso de conectores
GET /v1/organizations/analytics/connectors
Devuelve datos de uso de MCP/conectores en Claude (chat) y Claude Code dentro de su organización para una fecha determinada. Cada elemento representa un conector y muestra cuántos usuarios únicos lo utilizaron. Los nombres de conectores se normalizan desde varias fuentes: por ejemplo, "Atlassian MCP server," "mcp-atlassian," y "atlassian_MCP" aparecerían todos como "atlassian."
Parámetros de consulta
Campo | Tipo | Requerido | Descripción |
| cadena | Sí | La fecha para la que se deben recuperar las 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 puede 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 conector)
Campo | Descripción |
| El nombre normalizado del conector. |
| Número de usuarios únicos que utilizaron este conector en la fecha especificada. |
| Número de conversaciones distintas en las que se utilizó el conector al menos una vez, en chat. |
| Número de sesiones remotas distintas en las que se utilizó el conector al menos una vez, en Claude Code. |
Métricas de Office Agent (por conector)
Cada registro de conector también incluye un objeto office_metrics que informa cuántas sesiones de Office Agent utilizaron el conector, desglosado por producto. Este bloque siempre está presente: las organizaciones sin uso de Office Agent ven todos los valores en cero.
Campo | Descripción |
| Número de sesiones distintas de Office Agent en Excel en las que se utilizó este conector. |
| Número de sesiones distintas de Office Agent en PowerPoint en las que se utilizó este conector. |
Métricas de Claude Cowork (por conector)
Cada registro de conector también incluye un objeto cowork_metrics que informa cuántas sesiones de Cowork utilizaron el conector. Este bloque siempre está presente: las organizaciones sin uso de Cowork ven todos los valores en cero.
Campo | Descripción |
| Número de sesiones distintas de Cowork en las que se utilizó este conector al menos una vez. |
Solicitud de ejemplo
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/connectors?date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
Puntos finales de costo y uso
Nota: Los puntos finales de costo y uso se aplican a planes Enterprise basados en uso. Para planes Enterprise basados en asientos, estos puntos finales reflejarán solo créditos de uso.
Los puntos finales de costo y uso (disponibles ahora en versión beta) proporcionan a su organización acceso programático a datos de costo en tokens y USD para Claude (chat), Claude Code, Cowork, Office Agent y Claude en Chrome.
Hay cuatro puntos finales en dos formas:
Forma | Puntos finales | Devuelve |
Por usuario (una fila por usuario, ordenada) | user_usage_report, user_cost_report | Usuarios clasificados por tokens o gasto en un rango de fechas. |
Agrupado (una fila por intervalo de tiempo, opcionalmente agrupado) | usage_report, cost_report | Uso o costo a lo largo del tiempo, desglosado por producto, modelo u otras dimensiones. |
Utilice los puntos finales por usuario para responder "¿quiénes son mis principales gastadores?" Utilice los puntos finales agrupados para responder "¿cómo está tendiendo el uso día a día, desglosado por producto?"
Actualización y finalidad de datos
Los datos generalmente están disponibles dentro de cuatro horas del uso subyacente, pero pueden tardar hasta 24 horas. Cada respuesta incluye una marca de tiempo data_refreshed_at que indica la exportación desde la que se sirvió la respuesta; el uso que ocurrió después de esa marca de agua aún no se refleja.
Los valores para una fecha determinada pueden revisarse hasta 30 días mientras llegan eventos tardíos y se ejecutan reconciliaciones. Para totales de calidad de facturación, consulte fechas al menos 30 días en el pasado.
Cuando se omite ending_at (el valor predeterminado es "ahora"), la respuesta incluirá una cola de datos después de data_refreshed_at que está incompleta. Para resultados estables en llamadas repetidas, establezca ending_at en un valor igual o anterior a un data_refreshed_at devuelto anteriormente.
Límites de rango de fechas
starting_at puede ser hasta 365 días en el pasado, y una sola consulta puede abarcar como máximo 31 días (ending_at - starting_at). Para cubrir un período más largo, emita múltiples consultas con ventanas adyacentes. No hay datos disponibles antes de 2026-01-01.
Paginación
Los cuatro puntos finales de costo y uso están paginados con un cursor opaco. La primera solicitud devuelve hasta filas de límite más un cursor next_page; pasa ese cursor sin cambios como parámetro de página en la siguiente solicitud y repite hasta que has_more sea falso.
Trata next_page como opaco: devuélvelo sin cambios en la siguiente solicitud y envía los mismos parámetros de consulta en cada página. Si una solicitud devuelve 400 o 410 con un mensaje sobre el cursor de página, descártalo y comienza de nuevo desde la primera página.
No cambies los parámetros de consulta a mitad de la secuencia. Los cursores están vinculados a los filtros y rango de fechas que los emitieron. Si cambias products[], order_by, group_by[], el rango de fechas o cualquier filtro y pasas un cursor antiguo, obtendrás un error 400.
Serialización de parámetros de lista
Los parámetros de lista utilizan notación de corchetes: repite el nombre del parámetro con [] para cada valor.
products[]=chat&products[]=claude_code
El objeto Actor
Cada fila de resultado por usuario identifica al usuario que generó el uso.
{
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email": "[email protected]"
}
Campo | Tipo | Descripción |
tipo | cadena | Siempre "user_actor". |
user_id | cadena | El ID del usuario. Mismo valor aceptado por user_ids[]. |
nombre | cadena o nulo | El nombre del usuario. "Usuario eliminado" si el usuario fue eliminado. |
correo electrónico | cadena o nulo | La dirección de correo electrónico del usuario. Nulo cuando el usuario se elimina. |
eliminado | booleano | Verdadero si la cuenta ha sido eliminada. |
6. Uso de tokens por usuario
GET /v1/organizations/analytics/user_usage_report
Devuelve uso de tokens por usuario en un rango de fechas, ordenado por la métrica de token elegida.
Parámetros de consulta
Campo | Tipo | Requerido | Predeterminado | Descripción |
starting_at | Fecha y hora RFC 3339 | Sí | — | Inicio del rango, inclusive. Redondeado al inicio de la hora en UTC. Debe estar dentro de los últimos 365 días. |
ending_at | Fecha y hora RFC 3339 | No | ahora | Fin del rango, exclusivo. El rango puede abarcar como máximo 31 días. |
products[] | uno o más de chat, claude_code, cowork, office_agent, claude_in_chrome, claude_design | No | todos los productos basados en asientos | Solo superficies de productos basados en asientos. Repite el parámetro para múltiples valores. |
models[] | cadena, máximo 100 entradas | No | todos | Filtrar por nombres de modelo específicos (p. ej., claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5-20251001). |
user_ids[] | cadena, máximo 100 entradas | No | todos | Filtrar por usuarios específicos. Útil para buscar un conjunto conocido de usuarios sin paginar toda la organización. |
context_windows[] | uno o más de 0-200k, 200k-1M | No | todos | Filtrar por niveles de precios de ventana de contexto específicos. Utiliza group_by[]=context_window para desglosar valores por nivel. |
inference_geos[] | uno o más de global, us, not_available | No | todos | Filtrar por regiones de inferencia específicas. not_available coincide con filas donde la región no está establecida. Utiliza group_by[]=inference_geo para desglosar valores por región. |
speeds[] | uno o más de fast, standard | No | todos | Filtrar por modo de inferencia rápido o estándar. Utiliza group_by[]=speed para desglosar valores por modo. |
group_by[] | uno o más de product, model, context_window, inference_geo, speed | No | ninguno | Desglosar cada fila del usuario por las dimensiones dadas. Con dimensiones presentes, un usuario puede abarcar varias filas. |
order_by | total_tokens, output_tokens, uncached_input_tokens | No | total_tokens | Métrica para ordenar. |
exclude_deleted_users | booleano | No | falso | Cuando es verdadero, se omiten las filas de usuarios eliminados. |
order | desc, asc | No | desc | Dirección de ordenamiento. |
limit | entero 1–1000 | No | 20 | Filas por página. |
página | cadena de cursor opaca | No | — | El valor next_page de una respuesta anterior. |
Campos de respuesta
Campo | Descripción |
organization_id | ID de la organización a la que pertenece la clave API. |
data | Matriz de entradas, ordenadas por order_by en dirección de orden. |
data[].actor | El objeto Actor del usuario que generó el uso. |
data[].product | Cuando group_by[] incluye product, la superficie del producto. De lo contrario, null. |
data[].model | Cuando group_by[] incluye model, el nombre del modelo. De lo contrario, null. |
data[].context_window | Cuando group_by[] incluye context_window, el nivel de contexto (0-200k o 200k-1M). De lo contrario, null. |
data[].inference_geo | Cuando group_by[] incluye inference_geo, la región de inferencia. De lo contrario, null. |
data[].speed | Cuando group_by[] incluye speed: fast o standard. De lo contrario, null. |
data[].uncached_input_tokens | Tokens de entrada que no fueron servidos desde la caché de indicaciones. |
data[].cache_creation.ephemeral_5m_input_tokens | Tokens escritos en la caché de indicaciones de 5 minutos. |
data[].cache_creation.ephemeral_1h_input_tokens | Tokens escritos en la caché de indicaciones de 1 hora. |
data[].cache_read_input_tokens | Tokens de entrada servidos desde la caché de indicaciones. |
data[].output_tokens | Tokens de salida generados. |
data[].total_tokens | Suma de todos los componentes de tokens anteriores. El order_by=total_tokens predeterminado se ordena en este valor. |
data[].server_tool_use.web_search_requests | Número de llamadas de herramienta de búsqueda web. |
data[].requests | Número de solicitudes API |
has_more | Si existe otra página. |
next_page | Cursor opaco para la siguiente página; null cuando has_more es false. |
data_refreshed_at | Marca de tiempo de la exportación de datos desde la que se sirvió esta respuesta. |
Solicitud de ejemplo
curl "https://api.anthropic.com/v1/organizations/analytics/user_usage_report?starting_at=2026-03-01T00:00:00Z&products[]=claude_code&order_by=output_tokens&limit=20" \
--header "x-api-key: $YOUR_API_KEY"
7. Costo por usuario
GET /v1/organizations/analytics/user_cost_report
Devuelve el costo en USD por usuario en un rango de fechas, ordenado por cantidad con descuento o precio de lista.
Parámetros de consulta
Igual que user_usage_report, con estas diferencias:
Campo | Tipo | Requerido | Predeterminado | Descripción |
order_by | amount, list_amount | No | amount | Métrica para ordenar. |
group_by[] | uno o más de product, model, context_window, inference_geo, speed, cost_type, token_type | No | ninguno | Desglosar cada fila del usuario por las dimensiones dadas. cost_type devuelve una fila por componente de costo (tokens, búsqueda web, ejecución de código); token_type devuelve una fila por tipo de token. |
Todos los demás parámetros (starting_at, ending_at, products[], models[], user_ids[], order, limit, page) son idénticos.
Campos de respuesta
Campo | Descripción |
organization_id | ID de la organización a la que pertenece la clave API. |
data | Matriz de entradas, ordenadas por order_by en dirección de orden. |
data[].actor | El objeto Actor del usuario que generó el costo. |
data[].product, data[].model, data[].context_window, data[].inference_geo, data[].speed | Cuando se establece el valor group_by[] correspondiente, el valor de la dimensión. De lo contrario, nulo. |
data[].currency | Siempre "USD". |
data[].amount | Cantidad en centavos fraccionarios — costo de consumo bruto después de descuentos negociados. Por ejemplo, "41280.000000" es $412.80. El valor se suma en todos los productos en el filtro products[]. |
data[].list_amount | Cantidad de precio de lista (antes del descuento) en centavos fraccionarios, mismo formato. |
data[].cost_type | Cuando group_by[] incluye cost_type: uno de tokens, web_search, code_execution. nulo cuando no está establecido. |
data[].token_type | Cuando group_by[] incluye token_type: uno de uncached_input_tokens, output_tokens, cache_read_input_tokens, cache_creation.ephemeral_5m_input_tokens, cache_creation.ephemeral_1h_input_tokens. Solo no nulo en filas donde cost_type es tokens. |
data[].requests | Número de solicitudes de API |
has_more | Si existe otra página. |
next_page | Cursor opaco para la siguiente página. |
data_refreshed_at | Marca de tiempo de la exportación de datos desde la que se sirvió esta respuesta. |
Análisis de cantidades
amount y list_amount son cadenas decimales denominadas en centavos. "41280.000000" representa 41.280 centavos (US $412.80). Para convertir a dólares, analice como decimal y divida por 100. Evite el análisis de punto flotante binario para valores que pueden exceder varios millones de dólares.
Solicitud de ejemplo
curl "https://api.anthropic.com/v1/organizations/analytics/user_cost_report?starting_at=2026-03-01T00:00:00Z&order_by=amount&limit=20" \
--header "x-api-key: $YOUR_API_KEY"
8. Uso de tokens a lo largo del tiempo
GET /v1/organizations/analytics/usage_report
Devuelve uso de tokens a lo largo del tiempo, agrupado por minuto, hora o día, opcionalmente desglosado por producto, modelo, ventana de contexto, región de inferencia o velocidad.
Parámetros de consulta
Campo | Tipo | Requerido | Predeterminado | Descripción |
starting_at | Fecha y hora RFC 3339 | Sí | — | Inicio del rango, inclusive. Debe estar dentro de los últimos 365 días. Redondeado al límite bucket_width más cercano en UTC. |
ending_at | Fecha y hora RFC 3339 | No | ahora | Fin del rango, exclusivo. El rango puede abarcar como máximo 31 días. Redondeado al límite bucket_width más cercano en UTC. |
bucket_width | 1m, 1h, 1d | No | 1d | Granularidad del depósito de tiempo: minuto, hora o día. |
group_by[] | uno o más de producto, modelo, ventana_contexto, geografía_inferencia, velocidad | No | ninguno | Dimensiones para desglosar dentro de cada depósito. Omitir para un único agregado por depósito. |
products[] | uno o más de chat, claude_code, cowork, office_agent, claude_in_chrome, claude_design | No | todos | Filtrar a superficies de producto específicas. |
models[] | cadena, máximo 100 entradas | No | todos | Filtrar a nombres de modelo específicos. |
context_windows[] | uno o más de 0-200k, 200k-1M | No | todos | Filtrar a niveles de precios de ventana de contexto específicos. Utilice group_by[]=context_window para desglosar valores por nivel. |
inference_geos[] | uno o más de global, us, not_available | No | todos | Filtrar a regiones de inferencia específicas. not_available coincide con filas donde la región no está establecida. Utilice group_by[]=inference_geo para desglosar valores por región. |
speeds[] | uno o más de rápido, estándar | No | todos | Filtrar por modo de inferencia rápido o estándar. |
user_ids[] | cadena, máximo 100 entradas | No | todos | Filtrar a usuarios específicos. |
límite | entero | No | varía | Buckets por página. El valor predeterminado y máximo varían según bucket_width: 1d → 7 (máx. 31); 1h → 24 (máx. 168); 1m → 60 (máx. 256). |
página | cadena de cursor opaca | No | — | El valor next_page de una respuesta anterior. |
Campos de respuesta
Campo | Descripción |
organization_id | ID de la organización a la que pertenece la clave API. |
datos | Array de entradas, una por bucket de tiempo. |
data[].starting_at | Inicio del bucket. |
data[].ending_at | Fin del bucket. |
data[].results | Array de entradas, una por grupo dentro del bucket. Una única entrada con todos los campos de dimensión nulos cuando se omite group_by[]. |
data[].results[].product, .model, .context_window, .inference_geo, .speed | Cuando se establece el valor group_by[] correspondiente, el valor de la dimensión. De lo contrario, nulo. |
data[].results[].uncached_input_tokens | Tokens de entrada que no fueron servidos desde la caché de indicaciones. |
data[].results[].cache_creation.ephemeral_5m_input_tokens | Tokens escritos en la caché de indicaciones de 5 minutos. |
data[].results[].cache_creation.ephemeral_1h_input_tokens | Tokens escritos en la caché de indicaciones de 1 hora. |
data[].results[].cache_read_input_tokens | Tokens de entrada servidos desde la caché de indicaciones. |
data[].results[].output_tokens | Tokens de salida generados. |
data[].results[].server_tool_use.web_search_requests | Número de llamadas de herramienta de búsqueda web. |
has_more | Si existen más buckets. |
next_page | Cursor opaco para la siguiente página. |
data_refreshed_at | Marca de tiempo de la exportación de datos desde la que se sirvió esta respuesta. |
Solicitud de ejemplo
--header "x-api-key: $YOUR_API_KEY"
9. Costo a lo largo del tiempo
GET /v1/organizations/analytics/cost_report
Devuelve costo en USD a lo largo del tiempo, agrupado de la misma manera que usage_report.
Parámetros de consulta
Igual que usage_report (bucket_width, group_by[], filters, limit, page). Los valores de group_by[] también aceptan cost_type y token_type en este endpoint.
Campos de respuesta
Campo | Descripción |
organization_id | ID de la organización a la que pertenece la clave API. |
data | Matriz de entradas, una por cada intervalo de tiempo. |
data[].starting_at | Inicio del intervalo. |
data[].ending_at | Fin del intervalo. |
data[].results | Matriz de entradas, una por cada grupo dentro del intervalo. |
data[].results[].product, .model, .context_window, .inference_geo, .speed | Cuando se establece el valor de group_by[] correspondiente, el valor de la dimensión. De lo contrario, nulo. |
data[].results[].cost_type | Cuando group_by[] incluye cost_type: tokens, web_search o code_execution. nulo cuando no está establecido. |
data[].results[].token_type | Cuando group_by[] incluye token_type: uno de los tipos de token enumerados en el endpoint 7. Solo endpoint de costo — token_type se rechaza en usage_report. |
data[].results[].currency | Siempre "USD". |
data[].results[].amount | Cantidad en centavos fraccionarios — costo de consumo bruto después de descuentos negociados. |
data[].results[].list_amount | Cantidad de precio de lista (antes del descuento) en centavos fraccionarios. |
has_more | Si existen más intervalos. |
next_page | Cursor opaco para la siguiente página. |
data_refreshed_at | Marca de tiempo de la exportación de datos desde la que se sirvió esta respuesta. |
Solicitud de ejemplo
curl "https://api.anthropic.com/v1/organizations/analytics/cost_report?starting_at=2026-03-01T00:00:00Z&bucket_width=1d&group_by[]=model" \
--header "x-api-key: $YOUR_API_KEY"