Metrics

Métriques Hotmart via l'API

Votre client connecte son compte Hotmart et votre produit interroge 33 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.

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"
      ]
    }
  ]
}
Exemple : « Revenu net ($) » en octobre, comparé à septembre.

Plus d'exemples d'appels Hotmart

Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).

Graphique

Pourcentage des ventes par produit

Ce graphique montre le pourcentage des ventes regroupées par les produits de votre compte.

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"
      ]
    }
  ]
}

Tableau

Ventes par produit

Résumé des performances des produits, pendant la période analysée.

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"
      ]
    }
  ]
}

Chiffre

Revenu net (R$)

Montant total des revenus de vente, hors achats annulés, rétrofacturations et remboursements. Ce montant est calculé en réduisant les montants des achats annulés, des rétrofacturations et des remboursements du chiffre d'affaires total.

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"
      ]
    }
  ]
}

Chiffres

24 métriques

  • Revenu net ($)

    Montant total des revenus de vente, hors achats annulés, rétrofacturations et remboursements. Ce montant est calculé en réduisant les montants des achats annulés, des rétrofacturations et des remboursements du chiffre d'affaires total.

    ht:final_revenue_usd
  • Revenu net (R$)

    Montant total des revenus de vente, hors achats annulés, rétrofacturations et remboursements. Ce montant est calculé en réduisant les montants des achats annulés, des rétrofacturations et des remboursements du chiffre d'affaires total.

    ht:final_revenue_brl
  • Revenu net (€)

    Montant total des revenus de vente, hors achats annulés, rétrofacturations et remboursements. Ce montant est calculé en réduisant les montants des achats annulés, des rétrofacturations et des remboursements du chiffre d'affaires total.

    ht:final_revenue_eur
  • Revenu total ($)

    Montant total des revenus de vente, y compris les achats annulés, les rétrofacturations et les remboursements.

    ht:revenue_usd
  • Revenu total (R$)

    Montant total des revenus de vente, y compris les achats annulés, les rétrofacturations et les remboursements.

    ht:revenue_brl
  • Revenu total (€)

    Montant total des revenus de vente, y compris les achats annulés, les rétrofacturations et les remboursements.

    ht:revenue_eur
  • Montant des Retours ($)

    Valeur totale des remboursements effectués pendant la période analysée. Un chargeback est lorsque le client demande le remboursement de l'achat directement auprès de l'émetteur de sa carte de crédit.

    ht:chargeback_usd
  • Montant des Retours (R$)

    Valeur totale des remboursements effectués pendant la période analysée. Un chargeback est lorsque le client demande le remboursement de l'achat directement auprès de l'émetteur de sa carte de crédit.

    ht:chargeback_brl
  • Montant des Retours (€)

    Valeur totale des remboursements effectués pendant la période analysée. Un chargeback est lorsque le client demande le remboursement de l'achat directement auprès de l'émetteur de sa carte de crédit.

    ht:chargeback_eur
  • Valeur Totale des Achats Annulés ($)

    Montant total des achats qui ont été annulés en raison d'un problème ou d'un empêchement.

    ht:canceled_usd
  • Valeur Totale des Achats Annulés (R$)

    Montant total des achats qui ont été annulés en raison d'un problème ou d'un empêchement.

    ht:canceled_brl
  • Valeur Totale des Achats Annulés (€)

    Montant total des achats qui ont été annulés en raison d'un problème ou d'un empêchement.

    ht:canceled_eur
  • Montant Total des Remboursements ($)

    Montant total des ventes qui ont été remboursées ou qui ont subi une rétrofacturation.

    ht:refunded_chargeback_usd
  • Montant Total des Remboursements (R$)

    Montant total des ventes qui ont été remboursées ou qui ont subi une rétrofacturation.

    ht:refunded_chargeback_brl
  • Montant Total des Remboursements (€)

    Montant total des ventes qui ont été remboursées ou qui ont subi une rétrofacturation.

    ht:refunded_chargeback_eur
  • Remboursements ($)

    Montant Total des Remboursements ($)

    ht:refunded_usd
  • Remboursements (R$)

    Montant Total des Remboursements (R$)

    ht:refunded_brl
  • Remboursements (€)

    Montant Total des Remboursements (€)

    ht:refunded_eur
  • Soldes

    Nombre total de ventes réalisées en ignorant le nombre de ventes annulées.

    ht:complete_count
  • Ventes Annulées

    Nombre total de ventes qui ont été annulées en raison d'un problème ou d'un obstacle.

    ht:canceled_sales_count
  • Rétrofacturations

    Nombre total de remboursements effectués pendant la période analysée. Un chargeback est lorsque le client demande le remboursement de l'achat directement auprès de l'émetteur de sa carte de crédit.

    ht:chargeback_count
  • Ventes Totales

    Nombre total de ventes avec un statut approuvé ou complet, pendant la période analysée.

    ht:final_sales_amount
  • Nombre de Remboursements

    Nombre d'achats remboursés

    ht:refunded_sales_count
  • Nombre Total de Remboursements

    Nombre d'achats remboursés + rétrofacturations

    ht:total_refunded_sales_count

Graphiques

8 métriques

  • Pourcentage des ventes par produit

    Ce graphique montre le pourcentage des ventes regroupées par les produits de votre compte.

    ht:purchases_by_product
  • Ventes au Fil du Temps

    Ce graphique montre l'évolution de vos ventes au cours de la période analysée.

    ht:purchases_over_time
  • Revenus au fil du temps ($)

    Ce graphique montre l'évolution des revenus pendant la période d'analyse sélectionnée. Les ventes approuvées et complètes sont prises en compte, sans ignorer le montant des rétrofacturations et des remboursements.

    ht:revenue_over_time_usd
  • Revenus au fil du temps (R$)

    Ce graphique montre l'évolution des revenus pendant la période d'analyse sélectionnée. Les ventes approuvées et complètes sont prises en compte, sans ignorer le montant des rétrofacturations et des remboursements.

    ht:revenue_over_time_brl
  • Recette au fil du temps (€)

    Ce graphique montre l'évolution des revenus pendant la période d'analyse sélectionnée. Les ventes approuvées et complètes sont prises en compte, sans ignorer le montant des rétrofacturations et des remboursements.

    ht:revenue_over_time_eur
  • Revenu net au fil du temps ($)

    Ce graphique montre l'évolution du revenu net pendant la période d'analyse sélectionnée. Seules les ventes approuvées et complètes sont prises en compte ; les achats annulés, les chargebacks et les remboursements sont exclus.

    ht:final_revenue_over_time_usd
  • Revenu net au fil du temps (R$)

    Ce graphique montre l'évolution du revenu net pendant la période d'analyse sélectionnée. Seules les ventes approuvées et complètes sont prises en compte ; les achats annulés, les chargebacks et les remboursements sont exclus.

    ht:final_revenue_over_time_brl
  • Revenu net au fil du temps (€)

    Ce graphique montre l'évolution du revenu net pendant la période d'analyse sélectionnée. Seules les ventes approuvées et complètes sont prises en compte ; les achats annulés, les chargebacks et les remboursements sont exclus.

    ht:final_revenue_over_time_eur

Tableaux

1 métrique

  • Ventes par produit

    Résumé des performances des produits, pendant la période analysée.

    ht:revenue_by_product

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.