Metrics
Métricas de Hotmart con la API
Tu cliente conecta su cuenta de Hotmart y tu producto consulta 33 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "ht:final_revenue_usd",
"component": "number_v1",
"metrics": [
"final_revenue_usd"
]
}
]
}Más ejemplos de llamadas a Hotmart
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Porcentaje de ventas por producto
Este gráfico muestra el porcentaje de ventas agrupado por los productos de tu cuenta.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ht:purchases_by_product",
"component": "chart_v1",
"metrics": [
"sales_count"
],
"dimensions": [
"product"
]
}
]
}Tabla
Ventas por producto
Resumen del rendimiento de los productos, durante el período analizado.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ht:revenue_by_product",
"component": "datatable_v1",
"metrics": [
"sales_count",
"sales_rate",
"revenue_brl",
"revenue_brl_rate",
"revenue_usd",
"revenue_usd_rate",
"revenue_eur",
"revenue_eur_rate"
],
"dimensions": [
"product.name"
]
}
]
}Número
Ingresos netos (R$)
Valor total de los ingresos por ventas, excluidas las compras canceladas, contracargos y reembolsos. Este monto se calcula reduciendo los montos de las compras canceladas, contracargos y reembolsos de los ingresos totales.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ht:final_revenue_brl",
"component": "number_v1",
"metrics": [
"final_revenue_brl"
]
}
]
}Números
24 métricas
Ingresos netos ($)
Valor total de los ingresos por ventas, excluidas las compras canceladas, contracargos y reembolsos. Este monto se calcula reduciendo los montos de las compras canceladas, contracargos y reembolsos de los ingresos totales.
ht:final_revenue_usdIngresos netos (R$)
Valor total de los ingresos por ventas, excluidas las compras canceladas, contracargos y reembolsos. Este monto se calcula reduciendo los montos de las compras canceladas, contracargos y reembolsos de los ingresos totales.
ht:final_revenue_brlIngresos netos (€)
Valor total de los ingresos por ventas, excluidas las compras canceladas, contracargos y reembolsos. Este monto se calcula reduciendo los montos de las compras canceladas, contracargos y reembolsos de los ingresos totales.
ht:final_revenue_eurIngresos totales ($)
Monto total de los ingresos por ventas, incluidas las compras canceladas, contracargos y reembolsos.
ht:revenue_usdIngresos totales (R$)
Monto total de los ingresos por ventas, incluidas las compras canceladas, contracargos y reembolsos.
ht:revenue_brlIngresos totales (€)
Monto total de los ingresos por ventas, incluidas las compras canceladas, contracargos y reembolsos.
ht:revenue_eurMonto de Chargebacks ($)
Valor total de reembolsos realizados durante el período analizado. Chargeback es cuando el cliente solicita el reembolso de la compra directamente a la operadora de su tarjeta de crédito.
ht:chargeback_usdMonto de Chargebacks (R$)
Valor total de reembolsos realizados durante el período analizado. Chargeback es cuando el cliente solicita el reembolso de la compra directamente a la operadora de su tarjeta de crédito.
ht:chargeback_brlMonto de Chargebacks (€)
Valor total de reembolsos realizados durante el período analizado. Chargeback es cuando el cliente solicita el reembolso de la compra directamente a la operadora de su tarjeta de crédito.
ht:chargeback_eurValor Total de Compras Canceladas ($)
Valor total de las compras que fueron canceladas por algún problema o impedimento.
ht:canceled_usdValor Total de Compras Canceladas (R$)
Valor total de las compras que fueron canceladas por algún problema o impedimento.
ht:canceled_brlValor Total de Compras Canceladas (€)
Valor total de las compras que fueron canceladas por algún problema o impedimento.
ht:canceled_eurMonto Total de Reembolsos ($)
Valor total de ventas que fueron reembolsadas o que sufrieron chargeback.
ht:refunded_chargeback_usdMonto Total de Reembolsos (R$)
Valor total de ventas que fueron reembolsadas o que sufrieron chargeback.
ht:refunded_chargeback_brlMonto Total de Reembolsos (€)
Valor total de ventas que fueron reembolsadas o que sufrieron chargeback.
ht:refunded_chargeback_eurReembolsos ($)
Monto Total de Reembolsos ($)
ht:refunded_usdReembolsos (R$)
Monto Total de Reembolsos (R$)
ht:refunded_brlReembolsos (€)
Monto Total de Reembolsos (€)
ht:refunded_eurVentas
Número total de ventas realizadas sin considerar el número de ventas canceladas.
ht:complete_countVentas Canceladas
Número total de ventas que fueron canceladas debido a algún problema o impedimento.
ht:canceled_sales_countContracargos
Número total de reembolsos realizados durante el período analizado. Chargeback es cuando el cliente solicita el reembolso de la compra directamente a la operadora de su tarjeta de crédito.
ht:chargeback_countVentas Totales
Número total de ventas con estado de aprobadas o completas, durante el período analizado.
ht:final_sales_amountNúmero de Reembolsos
Número de compras reembolsadas
ht:refunded_sales_countNúmero Total de Reembolsos
Número de compras reembolsadas + reembolsos
ht:total_refunded_sales_count
Gráficos
8 métricas
Porcentaje de ventas por producto
Este gráfico muestra el porcentaje de ventas agrupado por los productos de tu cuenta.
ht:purchases_by_productVentas a lo Largo del Tiempo
Este gráfico muestra la evolución de sus ventas a lo largo del período analizado.
ht:purchases_over_timeIngresos a lo largo del tiempo ($)
Este gráfico muestra la evolución de los ingresos durante el período de análisis seleccionado. Se tienen en cuenta las ventas aprobadas y completas, sin desestimar el valor de los chargebacks y reembolsos.
ht:revenue_over_time_usdIngresos a lo largo del tiempo (R$)
Este gráfico muestra la evolución de los ingresos durante el período de análisis seleccionado. Se tienen en cuenta las ventas aprobadas y completas, sin desestimar el valor de los chargebacks y reembolsos.
ht:revenue_over_time_brlIngresos a lo largo del tiempo (€)
Este gráfico muestra la evolución de los ingresos durante el período de análisis seleccionado. Se tienen en cuenta las ventas aprobadas y completas, sin desestimar el valor de los chargebacks y reembolsos.
ht:revenue_over_time_eurIngresos netos a lo largo del tiempo ($)
Este gráfico muestra la evolución de los ingresos netos durante el período de análisis seleccionado. Solo se consideran las ventas aprobadas y completas; las compras canceladas, los chargebacks y los reembolsos se excluyen.
ht:final_revenue_over_time_usdIngresos netos a lo largo del tiempo (R$)
Este gráfico muestra la evolución de los ingresos netos durante el período de análisis seleccionado. Solo se consideran las ventas aprobadas y completas; las compras canceladas, los chargebacks y los reembolsos se excluyen.
ht:final_revenue_over_time_brlIngresos netos a lo largo del tiempo (€)
Este gráfico muestra la evolución de los ingresos netos durante el período de análisis seleccionado. Solo se consideran las ventas aprobadas y completas; las compras canceladas, los chargebacks y los reembolsos se excluyen.
ht:final_revenue_over_time_eur
Tablas
1 métrica
Ventas por producto
Resumen del rendimiento de los productos, durante el período analizado.
ht:revenue_by_product
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
