Reels Facebook et insights vidéo via l'API
Les insights vidéo et Reels Facebook proviennent de GET /{video-id}/video_insights : total_video_views compte les lectures d'au moins 3 secondes, total_video_avg_time_watched et total_video_view_total_time donnent le temps de visionnage en millisecondes, et les Reels ajoutent blue_reels_play_count, fb_reels_total_plays et fb_reels_replay_count. Meta a déprécié en juin 2026, pour toutes les versions de l'API, les métriques d'impressions vidéo et de spectateurs uniques, comme total_video_impressions.
easyCoexistence lit les insights des Pages et publications Facebook avec get_social_insights depuis Claude, ChatGPT ou votre propre code, afin que votre IA puisse dire comment se portent la Page et ses publications ; les video_insights propres à une vidéo ou à un Reel se lisent dans Meta Business Suite.
La durée de lecture minimale comptée par total_video_views, ou presque toute la durée pour les vidéos plus courtes.
Quand Meta a déprécié total_video_impressions, total_video_views_unique et post_video_views_unique pour toutes les versions de l'API.
Sur quelle durée les données d'insights vidéo sont disponibles.
Comment total_video_retention_graph découpe une vidéo, en indiquant les lectures à chaque point en pourcentage de toutes les vues.
La lecture qui compte comme une lecture de Reel dans blue_reels_play_count, sans les relectures.
Les interactions sur les Reels ne sont pas incluses dans les métriques de Page, parmi les limites de la référence insights de Meta.
Quelles métriques video_insights renvoie-t-il pour une vidéo ?
Ces métriques vidéo figurent dans la référence de Meta et ne sont pas dans ses listes de dépréciation en novembre 2026. Ce sont toutes des totaux cumulés, lus sur l'ID de la vidéo. Les vues excluent le temps passé à revoir une même lecture, et plusieurs ont des versions organiques et payantes, comme total_video_views_organic et total_video_views_paid :
Quelles métriques couvrent les Reels ?
La référence de Meta comporte une section Reels, lue sur l'ID vidéo du Reel, avec des valeurs cumulées :
blue_reels_play_count: lectures d'au moins 1 milliseconde après une impression, relectures exclues.fb_reels_total_plays: les mêmes lectures, relectures incluses ;fb_reels_replay_count: les relectures seules dans une même session.post_video_avg_time_watchedetpost_video_view_time: durée moyenne et totale lue en millisecondes, relectures incluses.post_video_followers: abonnements générés par le Reel.post_video_likes_by_reaction_type: j'aime sur le Reel, par type de réaction.post_video_social_actions: ses commentaires et partages.post_video_retention_graph: lectures à des points du Reel, en pourcentage du total des lectures.
Quelles métriques ont été dépréciées par Meta en 2026 ?
L'annonce de la version 25 de l'API Graph de Meta a déprécié deux groupes en juin 2026, pour toutes les versions de l'API, et renvoie vers ses métriques Media Views et Media Viewers : post_total_media_view_unique et page_total_media_view_unique pour les spectateurs uniques, et post_media_view et page_media_view pour la répartition payant et organique.
- Impressions vidéo :
total_video_impressionsavec ses variantes unique, payante, organique, virale et fans, etpost_impressions_uniquesur une vidéo. - Spectateurs des 3 premières secondes :
total_video_views_uniqueet ses versions organique et payante,post_video_views_uniqueet ses versions organique et payante, etpage_video_views_unique.
post_video_views et page_video_views sont-ils toujours valides ?
Oui. Les deux restent dans la référence insights de Meta sans marque de dépréciation : post_video_views compte les lectures d'au moins 3 secondes d'une publication vidéo, par durée de vie ou par jour, et page_video_views compte celles de la Page, par jour, semaine ou days_28. Leurs versions uniques, post_video_views_unique et page_video_views_unique, ont été dépréciées en juin 2026 pour toutes les versions de l'API, et les métriques de 10 secondes, comme post_video_views_10s, au-delà de la version 18.
Comment demander les insights vidéo ?
Sur trois objets, chacun avec ses propres métriques. GET /{video-id}/video_insights avec metric comme liste séparée par des virgules lit une vidéo ou un Reel, et sans metric il renvoie les totaux de la vidéo. Les métriques vidéo au niveau de la publication, comme post_video_views, se lisent avec GET /{page-post-id}/insights, et celles au niveau de la Page, comme page_video_views, avec GET /{page-id}/insights et un paramètre period.
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graphQuelles permissions et quelle tâche sont nécessaires ?
Un token de Page émis par une personne pouvant effectuer la tâche ANALYZE sur la Page. La référence video_insights de Meta cite read_insights et pages_manage_engagement, tandis que son guide des insights vidéo cite pages_read_engagement. Les données couvrent les 2 dernières années, les insights des vidéos publiées sur des comptes ou des groupes ne sont pas disponibles, et une vidéo publiée en crosspost a un ID vidéo distinct sur chaque Page où elle a été publiée.
Les métriques au niveau de la Page incluent-elles les Reels ?
Non. La référence insights de Meta indique, parmi ses limites pour la lecture des métriques de Page, que les interactions sur les Reels ne sont pas incluses. Les lectures, abonnements, commentaires et partages d'un Reel se lisent sur le Reel lui-même, via video_insights avec son ID vidéo.
Comment easyCoexistence les lit-il ?
get_social_insights lit l'edge insights de la Page ou d'une publication : metrics, une period, et object_id pour une publication, avec des paramètres supplémentaires comme since et until transmis tels quels. video_insights est un edge à part, qu'aucun outil ne lit, donc les métriques propres à une vidéo ou à un Reel se lisent dans Meta Business Suite. Une métrique retirée revient sous forme d'erreur de Meta, afin que votre IA puisse changer de nom.
Erreurs courantes
- Demander total_video_impressions. Meta a déprécié les métriques d'impressions vidéo en juin 2026 ; demandez plutôt ses métriques Media Views, comme post_media_view.
- Additionner les valeurs du graphe de rétention. Ce sont des pourcentages des vues à chaque intervalle, pas des comptages de lectures.
- Chercher les Reels dans les totaux de Page. Les insights de Page de Meta excluent les interactions sur les Reels, donc lisez le video_insights de chaque Reel.
- Lire le temps de visionnage en secondes. total_video_avg_time_watched, total_video_view_total_time et post_video_view_time sont en millisecondes.
De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.
Questions fréquemment posées
Par quoi a été remplacé total_video_views_unique ?
Meta renvoie vers ses métriques Media Viewers : post_total_media_view_unique sur la publication, et page_total_media_view_unique pour la Page.
Comment obtenir les lectures d'un Reel via l'API ?
Lisez blue_reels_play_count, ou fb_reels_total_plays pour inclure les relectures, depuis GET /{video-id}/video_insights avec l'ID vidéo renvoyé par l'appel de démarrage du Reel.
post_impressions_unique fonctionne-t-il encore pour les Reels ?
Non. Le tableau des Reels de Meta le liste encore, mais l'annonce v25 l'a déprécié sur video_insights en juin 2026 ; post_total_media_view_unique compte les spectateurs uniques de la publication.
Quelles vidéos n'ont pas d'insights ?
Les vidéos publiées sur des comptes ou des groupes. Les insights vidéo de Meta couvrent les vidéos des Pages, avec des données sur les 2 dernières années.
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