Aperçu des statistiques

Permission: analytics.read. Voir Rôles et permissions.

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, LinkedIn, YouTube, X et la fiche d'établissement Google. La fiche d'établissement Google ne donne que les impressions de l'établissement, sans chiffres par publication. Mastodon, Telegram et Tumblr n'ont pas de statistiques. Connecter un compte importe ses publications des 180 derniers jours, et les statistiques sont conservées ensuite tant que le compte reste connecté : vous pouvez donc interroger n'importe quelle période de cet historique.

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
connectionIds	Limite aux comptes indiqués, par leur `id` dans Comptes sociaux. Répétez la clé pour chaque valeur. Omettez ce paramètre pour couvrir tous les comptes

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 from, to et connectionIds, mais pas platforms. 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.