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"
]
}
]
}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_usdRevenu 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_brlRevenu 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_eurRevenu total ($)
Montant total des revenus de vente, y compris les achats annulés, les rétrofacturations et les remboursements.
ht:revenue_usdRevenu total (R$)
Montant total des revenus de vente, y compris les achats annulés, les rétrofacturations et les remboursements.
ht:revenue_brlRevenu total (€)
Montant total des revenus de vente, y compris les achats annulés, les rétrofacturations et les remboursements.
ht:revenue_eurMontant 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_usdMontant 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_brlMontant 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_eurValeur 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_usdValeur 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_brlValeur 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_eurMontant Total des Remboursements ($)
Montant total des ventes qui ont été remboursées ou qui ont subi une rétrofacturation.
ht:refunded_chargeback_usdMontant Total des Remboursements (R$)
Montant total des ventes qui ont été remboursées ou qui ont subi une rétrofacturation.
ht:refunded_chargeback_brlMontant Total des Remboursements (€)
Montant total des ventes qui ont été remboursées ou qui ont subi une rétrofacturation.
ht:refunded_chargeback_eurRemboursements ($)
Montant Total des Remboursements ($)
ht:refunded_usdRemboursements (R$)
Montant Total des Remboursements (R$)
ht:refunded_brlRemboursements (€)
Montant Total des Remboursements (€)
ht:refunded_eurSoldes
Nombre total de ventes réalisées en ignorant le nombre de ventes annulées.
ht:complete_countVentes Annulées
Nombre total de ventes qui ont été annulées en raison d'un problème ou d'un obstacle.
ht:canceled_sales_countRé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_countVentes Totales
Nombre total de ventes avec un statut approuvé ou complet, pendant la période analysée.
ht:final_sales_amountNombre de Remboursements
Nombre d'achats remboursés
ht:refunded_sales_countNombre 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_productVentes au Fil du Temps
Ce graphique montre l'évolution de vos ventes au cours de la période analysée.
ht:purchases_over_timeRevenus 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_usdRevenus 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_brlRecette 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_eurRevenu 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_usdRevenu 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_brlRevenu 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.
