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"
      ]
    }
  ]
}
Ejemplo: "Ingresos netos ($)" en octubre, comparado con septiembre.

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_usd
  • 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.

    ht:final_revenue_brl
  • 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_eur
  • Ingresos totales ($)

    Monto total de los ingresos por ventas, incluidas las compras canceladas, contracargos y reembolsos.

    ht:revenue_usd
  • Ingresos totales (R$)

    Monto total de los ingresos por ventas, incluidas las compras canceladas, contracargos y reembolsos.

    ht:revenue_brl
  • Ingresos totales (€)

    Monto total de los ingresos por ventas, incluidas las compras canceladas, contracargos y reembolsos.

    ht:revenue_eur
  • Monto 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_usd
  • Monto 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_brl
  • Monto 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_eur
  • Valor Total de Compras Canceladas ($)

    Valor total de las compras que fueron canceladas por algún problema o impedimento.

    ht:canceled_usd
  • Valor Total de Compras Canceladas (R$)

    Valor total de las compras que fueron canceladas por algún problema o impedimento.

    ht:canceled_brl
  • Valor Total de Compras Canceladas (€)

    Valor total de las compras que fueron canceladas por algún problema o impedimento.

    ht:canceled_eur
  • Monto Total de Reembolsos ($)

    Valor total de ventas que fueron reembolsadas o que sufrieron chargeback.

    ht:refunded_chargeback_usd
  • Monto Total de Reembolsos (R$)

    Valor total de ventas que fueron reembolsadas o que sufrieron chargeback.

    ht:refunded_chargeback_brl
  • Monto Total de Reembolsos (€)

    Valor total de ventas que fueron reembolsadas o que sufrieron chargeback.

    ht:refunded_chargeback_eur
  • Reembolsos ($)

    Monto Total de Reembolsos ($)

    ht:refunded_usd
  • Reembolsos (R$)

    Monto Total de Reembolsos (R$)

    ht:refunded_brl
  • Reembolsos (€)

    Monto Total de Reembolsos (€)

    ht:refunded_eur
  • Ventas

    Número total de ventas realizadas sin considerar el número de ventas canceladas.

    ht:complete_count
  • Ventas Canceladas

    Número total de ventas que fueron canceladas debido a algún problema o impedimento.

    ht:canceled_sales_count
  • Contracargos

    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_count
  • Ventas Totales

    Número total de ventas con estado de aprobadas o completas, durante el período analizado.

    ht:final_sales_amount
  • Número de Reembolsos

    Número de compras reembolsadas

    ht:refunded_sales_count
  • Nú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_product
  • Ventas 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_time
  • Ingresos 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_usd
  • Ingresos 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_brl
  • Ingresos 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_eur
  • Ingresos 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_usd
  • Ingresos 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_brl
  • Ingresos 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.