Skip to main content
Usa la API de estadísticas para descubrir las métricas disponibles y luego obtener una serie temporal para una cuenta. La referencia de estadísticas explica cada métrica, sus unidades y los filtros compatibles.
Las consultas de ingresos de la cuenta requieren el permiso stats:read. Consulta Permisos para solicitar permisos para tu app.

Descubrir métricas

Lista las métricas de series temporales para obtener sus claves, nombres, unidades, descripciones y propiedades filtrables:
Usa la key de una métrica, como gross_revenue, en la siguiente solicitud. Su array properties enumera las propiedades por las que puedes filtrar o desglosar.

Obtener una serie temporal

Pasa el ID de tu cuenta y un rango de fechas a Retrieve metric time series:
El array data.points de la respuesta contiene un timestamp Unix en segundos y un value para cada periodo. Interpreta el valor en la unidad del catálogo: count es un recuento, currency es un importe decimal y percent ya está en puntos porcentuales (1.6 significa 1,6 %). Algunas métricas también devuelven data.totals para todo el rango. Usa esos totales cuando estén disponibles: promediar tasas diarias o sumar recuentos únicos diarios no da el resultado de todo el rango.

Filtrar y desglosar resultados

Pasa una propiedad directamente como parámetro de consulta para filtrar por ella. Usa breakdown_by para dividir cada punto según una propiedad. Este ejemplo filtra los ingresos brutos a los pagos con tarjeta y los divide por la moneda original de la transacción:
Cada punto incluye un array breakdown de entradas { name, value }. Filtrar o desglosar métricas de transacciones por currency muestra sus importes en la moneda original sin conversión. Usa solo las propiedades indicadas para la métrica. Una propiedad no compatible devuelve 400. Una clave de métrica desconocida devuelve 404. Consulta los parámetros de consulta y la referencia de métricas para ver zonas horarias, intervalos, ventanas de instantánea y opciones específicas de cada métrica.