Aperçu des statistiques
Consultez les vues, les mentions j'aime, les commentaires, les partages, les abonnés et le taux d'engagement sur une période donnée, en total, par jour et par plateforme, chacun comparé à la période précédente.
Trois endpoints répondent à « comment on s'en sort » : un total, une tendance, une comparaison entre plateformes. Les trois lisent les mêmes chiffres. Les statistiques couvrent Facebook, Instagram, Threads, TikTok, Pinterest, Bluesky et YouTube sur les 180 derniers jours. X n'a pas de statistiques ici, et les statistiques LinkedIn attendent l'approbation de LinkedIn, donc les deux ne renvoient rien.
Paramètres de la période
| Paramètre | Description |
|---|---|
| from | Début de la période, au format ISO 8601. Obligatoire |
| to | Fin de la période, au format ISO 8601, pas antérieure à from. Obligatoire |
| platforms | Limite aux plateformes indiquées. Répétez la clé pour chaque valeur. Omettez ce paramètre pour couvrir toutes les plateformes prises en charge |
Les statistiques comptabilisent les publications parues pendant la période. Chaque valeur est accompagnée de la même statistique pour une période de durée égale précédant immédiatement from, donc une période de 30 jours est comparée aux 30 jours qui la précèdent.
GET /api/v1/analytics/overview
GET /api/v1/analytics/overview?from=2026-08-01&to=2026-08-31&platforms=INSTAGRAM&platforms=TIKTOK
{
"views": { "value": 48210, "previousValue": 39100, "deltaPercent": 23.3 },
"likes": { "value": 2210, "previousValue": 1980, "deltaPercent": 11.6 },
"comments": { "value": 340, "previousValue": 410, "deltaPercent": -17.1 },
"shares": { "value": 128, "previousValue": null, "deltaPercent": null },
"followers": { "value": 12980, "previousValue": 12410, "deltaPercent": 4.6 },
"postsCount": { "value": 42, "previousValue": 37, "deltaPercent": 13.5 },
"avgViewsPerPost": { "value": 1147.9, "previousValue": 1056.8, "deltaPercent": 8.6 },
"engagementRate": { "value": 5.55, "previousValue": 6.11, "deltaPercent": -9.2 },
"partialMetrics": ["shares"],
"lastSyncedAt": "2026-09-08T06:12:41.000Z"
}| Champ | Description |
|---|---|
| value | La statistique pour la période demandée |
| previousValue | La même statistique pour la période précédente de durée égale |
| deltaPercent | Évolution entre previousValue et value. Null lorsque la valeur précédente est 0 ou inconnue |
| followers | Nombre d'abonnés le plus récent à la date to, comparé au nombre à la fin de la période précédente |
| engagementRate | Mentions j'aime, commentaires et partages divisés par les vues, exprimé en pourcentage |
| partialMetrics | Statistiques qu'au moins une des plateformes sélectionnées ne peut pas fournir. Leurs totaux ne couvrent alors que les plateformes qui le peuvent |
| lastSyncedAt | Dernière synchronisation réussie parmi les plateformes sélectionnées |
Une statistique qu'aucune plateforme sélectionnée ne fournit vaut null. Cela signifie « non mesuré », pas zéro.
GET /api/v1/analytics/timeseries
GET /api/v1/analytics/timeseries?from=2026-08-01&to=2026-08-31&granularity=WEEKLY
Ajoute granularity : DAILY (par défaut), WEEKLY ou MONTHLY.
{
"points": [
{
"date": "2026-08-03T00:00:00.000Z",
"views": 11820,
"likes": 590,
"comments": 82,
"shares": 31,
"followers": 12520,
"postsCount": 10,
"engagementRate": 5.9
}
]
}date est le début de l'intervalle en UTC. followers est le dernier nombre connu à la fin de l'intervalle. Les autres compteurs additionnent les publications parues pendant cet intervalle.
GET /api/v1/analytics/platform-breakdown
GET /api/v1/analytics/platform-breakdown?from=2026-08-01&to=2026-08-31
Prend uniquement from et to. Renvoie { "platforms": [...] } avec une ligne par plateforme ayant des données dans l'espace de travail. Chaque ligne reprend les statistiques de l'aperçu pour cette plateforme, plus supportedMetrics, la liste des statistiques que la plateforme fournit. Ne comparez deux plateformes que sur les statistiques que toutes deux indiquent : une ligne Pinterest avec null pour shares n'est pas en retard sur Instagram sur les partages, elle ne les rapporte tout simplement pas.
Fraîcheur des données
Les chiffres se rafraîchissent automatiquement toutes les quelques heures. Si vous venez de publier et voulez les chiffres tout de suite, consultez Synchronisation des statistiques.