Statistiques des publications Facebook via l'API : vues, portée et engagement
Les insights d'une publication Facebook proviennent de GET /{page-post-id}/insights, avec des métriques telles que post_media_view, le nombre de fois où la publication a été lue ou affichée, post_total_media_view_unique, ses spectateurs uniques, post_clicks et post_reactions_by_type_total. Meta a déprécié post_impressions en novembre 2025 et post_impressions_unique en juin 2026 : les vues et les spectateurs uniques remplacent donc désormais les impressions et la portée.
easyCoexistence lit les insights de publications Facebook avec get_social_insights : Claude, ChatGPT ou votre propre code peuvent demander comment s'est comportée une publication et obtenir en retour les vues, spectateurs uniques, clics et réactions actuels de Meta, avec list_social_posts pour retrouver la publication.
La recommandation de Meta pour remplacer post_impressions_unique, dont la dépréciation, pour toutes les versions de l'API, a été fixée à juin 2026.
Date à partir de laquelle post_impressions ne renvoie plus de données, dans toutes les versions ; Meta cite post_media_view comme alternative.
La période indiquée par Meta pour les métriques de publication telles que post_media_view, post_clicks et les totaux de réactions.
Ce que comptent les totaux de réactions « J'aime » de Meta : les réactions « J'aime » et « Care ».
Ce que Meta renvoie, au lieu d'une erreur, lorsque l'application ne dispose pas de la permission read_insights.
Quelles métriques de publication fonctionnent en 2026 ?
Elles figurent dans la référence des insights de Meta et ne sont pas sur ses listes de dépréciation au 1er novembre 2026. Chacune est lue sur l'ID de la publication, avec une période lifetime sauf mention contraire :
post_media_view: nombre de fois où la publication a été lue ou affichée, avec les ventilationsis_from_adsetis_from_followers.post_total_media_view_unique: les spectateurs uniques de la publication, le remplaçant de la portée selon Meta.post_clicks: clics n'ayant pas généré de story, sur n'importe quel élément de la publication ;post_clicks_by_typeles répartit par type de consultation.post_reactions_by_type_total: réactions par type, plus un total par type, commepost_reactions_love_totaloupost_reactions_anger_total.post_video_views: lectures d'une vidéo d'au moins 3 secondes, avec la période lifetime ou day.
Qu'est-ce qui a remplacé les impressions et la portée des publications ?
Meta a fait passer la mesure des publications des impressions aux vues de médias en deux vagues, chacune pour toutes les versions de l'API à la fois, et un ancien nom renvoie désormais une erreur de métrique invalide. Son changelog, sa page des métriques dépréciées et ses notes de la version 25 de Graph API proposent ces alternatives :
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | post_impressions | post_media_view |
| Nov 15, 2025 | post_impressions_paid | post_media_view with is_from_ads |
| Nov 15, 2025 | post_impressions_fan | post_media_view with is_from_followers |
| June 2026 | post_impressions_unique | post_total_media_view_unique |
| June 2026 | post_impressions_paid_unique, post_impressions_organic_unique | post_media_view breakdowns, which count views rather than people |
Quelle est la différence entre vues et spectateurs uniques ?
Les vues comptent les affichages, les spectateurs uniques comptent les personnes. post_media_view additionne chaque fois que la publication a été lue ou affichée : une personne qui la voit deux fois compte donc deux fois, alors que post_total_media_view_unique compte une fois chaque spectateur unique de la publication. Meta indique que les métriques se terminant par _unique sont approximatives et que les valeurs uniques sont calculées indépendamment, si bien qu'un total peut ne pas égaler la somme de ses parties.
Comment demander les insights d'une publication ?
Avec GET /{page-post-id}/insights et metric défini sur une liste séparée par des virgules, ou GET /{page-post-id}/insights/{metric} pour une seule métrique. Le token doit provenir d'une personne pouvant effectuer la tâche ANALYZE sur la Page, avec les permissions read_insights et pages_read_engagement accordées, et chaque résultat contient name, period, values, title et description. L'exemple de Meta demande les totaux de réactions :
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total
{
"data": [
{
"name": "post_reactions_like_total",
"period": "lifetime",
"values": [{ "value": 226 }],
"title": "Lifetime Total Like Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
},
{
"name": "post_reactions_love_total",
"period": "lifetime",
"values": [{ "value": 17 }],
"title": "Lifetime Total Love Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
}
]
}Comment compter les réactions, commentaires et partages ?
À partir des champs propres à la publication, à côté de ses insights. fields=reactions.summary(total_count) renvoie le total des réactions, et reactions.type(LOVE).limit(0).summary(total_count) le nombre d'un type, parmi LIKE, LOVE, WOW, HAHA, SORRY et ANGRY. Le champ shares contient le nombre de partages, que Meta dit pouvoir inclure des publications supprimées et des publications que le token ne peut pas voir, et l'edge comments avec summary=true ajoute un total_count.
Comment les métriques de publication se rapportent-elles aux métriques de Page ?
Les métriques de Page additionnent le contenu de la Page sur une période, tandis que les métriques de publication donnent les totaux cumulés d'une seule publication. page_post_engagements compte l'engagement avec les publications de la Page via les réactions, commentaires, partages et plus, par jour, semaine ou days_28, et page_media_view ainsi que page_total_media_view_unique font de même pour les vues et les spectateurs. Meta a supprimé post_engaged_users en 2024 : l'engagement par publication se calcule donc à partir des clics, réactions, commentaires et partages.
À quelle fréquence les données sont-elles mises à jour, et sur quelle durée remontent-elles ?
La plupart des métriques sont mises à jour une fois par jour ; celles que Meta marque d'un astérisque, comme post_clicks, le sont plusieurs fois par jour. Meta conserve deux ans d'insights pour les Pages publiques, mais seulement 5 jours pour les Pages non publiées. lifetime désigne la période pour laquelle des données sont disponibles, deux ans ou moins par défaut. Les données d'insights de Page nécessitent une Page comptant 100 « J'aime » ou plus, et plusieurs métriques vidéo valent 0 sur une vidéo repartagée depuis une autre Page.
Comment easyCoexistence lit les insights de publication ?
get_social_insights prend les métriques et, pour une publication, son object_id, l'ID de publication que renvoie list_social_posts ; sans object_id, il lit la Page. Les paramètres period et les paramètres supplémentaires comme since et until sont transmis tels quels à Meta, et une métrique retirée renvoie l'erreur de métrique invalide de Meta, afin que l'IA puisse passer à un nom actuel.
Erreurs courantes
- Demander post_impressions_unique. Meta l'a déprécié pour toutes les versions de l'API en juin 2026 ; demandez post_total_media_view_unique pour compter les spectateurs uniques.
- Additionner les spectateurs uniques entre publications. Chaque publication compte ses propres spectateurs, de façon approximative, si bien qu'une personne ayant vu deux publications est comptée deux fois.
- Lire les insights d'une vidéo repartagée depuis une autre Page. Plusieurs métriques vidéo renvoient 0 pour les repartages ; seule la Page qui a créé la vidéo obtient des valeurs exactes.
- Faire confiance à un zéro issu d'une réponse vide. Sans read_insights, Meta renvoie un jeu de données vide plutôt qu'une erreur : vérifiez donc d'abord la permission.
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Qu'est-ce qui a remplacé la portée des publications Facebook ?
post_total_media_view_unique, le nombre de spectateurs uniques d'une publication, depuis que Meta a déprécié post_impressions_unique en juin 2026.
Puis-je voir qui a réagi à une publication de Page ?
Non. Meta renvoie les totaux de réactions par type, mais une Page ou une personne ne peut interroger que sa propre réaction ; les autres restent privées.
Les totaux de « J'aime » incluent-ils les réactions Care ?
Oui. Les totaux « J'aime » de Meta comptent à la fois les réactions « J'aime » et « Care », dans les insights comme sur l'edge reactions.
Puis-je lire les insights d'une publication d'une autre Page ?
Pas via les insights de Page : ils nécessitent un token émis par une personne pouvant effectuer la tâche ANALYZE sur la Page qui a créé la publication.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le