Statistiques des Reels Instagram via l'API
L'endpoint de statistiques média d'Instagram, GET /<IG_MEDIA_ID>/insights, renvoie ces métriques pour un Reel : views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time et reels_skip_rate, ainsi que crossposted_views et facebook_views pour un Reel en publication croisée. plays, clips_replays_count et ig_reels_aggregated_all_plays_count ont été retirées en avril 2025, remplacées par views.
easyCoexistence lit les statistiques d'un Reel avec get_social_insights : Claude, ChatGPT ou votre propre code peuvent ainsi demander comment s'est comporté un Reel et obtenir directement auprès de Meta les vues, la portée, le temps de visionnage et le taux de passage du compte connecté, avec l'erreur propre à Meta lorsqu'un nom de métrique est retiré.
Fenêtre que mesure reels_skip_rate : la part des vues où le Reel a été passé dans ses 3 premières secondes.
Date à laquelle plays, clips_replays_count et ig_reels_aggregated_all_plays_count ont été dépréciées dans toutes les versions de l'API.
Date d'ajout de reels_skip_rate, reposts, crossposted_views et facebook_views aux statistiques média.
Délai maximal pendant lequel les données derrière les métriques média peuvent être en retard.
Durée pendant laquelle Meta conserve les métriques média.
Quelles métriques un Reel renvoie-t-il ?
Celles que la référence des statistiques média de Meta liste pour media_product_type REELS, lues avec GET /<IG_MEDIA_ID>/insights et un paramètre metric séparé par des virgules. Meta qualifie plusieurs d'entre elles d'estimées ou en développement, comme indiqué à côté de chacune, et ne compte les j'aime et commentaires que comme activité organique :
Que renvoie une requête de statistiques de Reels ?
Un objet par métrique dans data, chacun avec name, period, values, title, description et id. period vaut toujours lifetime : Meta le définit pour les métriques média et il ne peut pas être modifié, la requête n'en a donc pas besoin. La référence de Meta décrit les deux métriques de temps de visionnage comme des durées sans nommer d'unité ; vérifiez-les donc sur un Reel que vous connaissez avant de les représenter sur un graphique.
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "views",
"period": "lifetime",
"values": [{ "value": <VALUE> }],
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"id": "<IG_MEDIA_ID>/insights/views/lifetime"
}
]
}Quelles métriques de Reels ont été retirées, et par quoi ont-elles été remplacées ?
Meta a déprécié les trois premières à partir de Graph API v22.0 le 21 janvier 2025, date à laquelle il a introduit views, et dans toutes les versions le 21 avril 2025 ; video_views l'a été à partir de la v21.0 et dans toutes les versions le 8 janvier 2025. Une requête qui nomme une métrique retirée échoue, donc une liste de métriques rédigée avant 2025 doit être mise à jour :
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
Que comptent les vues et la portée d'un Reel ?
views est le nombre de fois où le Reel a été lu sur Instagram, une métrique que Meta qualifie en développement ; reach est le nombre de comptes uniques qui l'ont vu au moins une fois, que Meta qualifie d'estimée. likes, comments, views et total_interactions ne comptent que l'activité organique, en excluant l'engagement sur les publicités créées à partir du Reel. total_likes, total_comments et total_views, qui incluent les médias promus, ne sont proposés qu'avec Facebook Login.
Quelles limites et quels délais s'appliquent ?
La référence des statistiques média de Meta fixe ces règles pour les chiffres d'un Reel :
- Les données derrière les métriques peuvent être en retard de 48 heures au maximum.
- Les métriques média sont conservées pendant 2 ans au maximum.
- Une donnée manquante ou indisponible renvoie un ensemble de données vide, et non 0.
crossposted_viewsetfacebook_viewsgénèrent une erreur pour un Reel qui n'était pas en publication croisée ; demandez-les donc dans un appel séparé.- Une ventilation que la métrique demandée ne prend pas en charge fait échouer toute la requête avec An unknown error has occurred.
- Avec Instagram Login, le token doit disposer de
instagram_business_basicetinstagram_business_manage_insights, sur graph.instagram.com.
Comment get_social_insights lit-il un Reel ?
Avec le account_id de la connexion, l'ID média du Reel comme object_id et une liste de métriques. easyCoexistence appelle GET /<IG_MEDIA_ID>/insights sur graph.instagram.com avec le token du compte, transmet à Meta les noms de métriques tels quels et renvoie les données de Meta, ou l'erreur propre à Meta lorsqu'un nom est retiré. list_social_posts renvoie les ID média des publications et Reels récents du compte.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<REEL_MEDIA_ID>",
"metrics": [
"views", "reach", "likes", "comments", "shares", "saved",
"total_interactions", "ig_reels_avg_watch_time",
"ig_reels_video_view_total_time", "reels_skip_rate"
]
}Erreurs courantes
- Demander plays ou clips_replays_count. Les deux ont été dépréciées dans toutes les versions de l'API le 21 avril 2025 ; demandez views.
- Mélanger crossposted_views ou facebook_views dans une requête générale. Elles génèrent une erreur pour un Reel qui n'était pas en publication croisée, et cette erreur fait échouer l'appel.
- Supposer une unité pour le temps de visionnage. La référence de Meta n'en nomme aucune pour ig_reels_avg_watch_time ou ig_reels_video_view_total_time ; vérifiez donc sur un Reel connu.
- Lire un résultat vide comme zéro. Meta renvoie un ensemble de données vide lorsque la donnée n'existe pas ou est actuellement indisponible.
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.
Questions fréquemment posées
Pourquoi une requête de statistiques de Reels renvoie-t-elle un résultat vide ?
Meta renvoie un ensemble de données vide, et non 0, lorsque la donnée n'existe pas ou est actuellement indisponible ; les données derrière les métriques peuvent aussi accuser un retard allant jusqu'à 48 heures.
Comment obtenir le temps de visionnage des Reels depuis l'API ?
Demandez ig_reels_avg_watch_time pour la moyenne et ig_reels_video_view_total_time pour le total, replays inclus, depuis GET /<IG_MEDIA_ID>/insights.
Qu'est-ce que reels_skip_rate ?
Le pourcentage des vues initiales où le Reel a été passé dans ses 3 premières secondes. Meta l'a ajouté le 3 décembre 2025 et le qualifie d'estimé et en développement.
Les statistiques de Reels incluent-elles les vues publicitaires ?
Non. likes, comments, views et total_interactions ne comptent que l'activité organique ; total_views, qui inclut les médias promus, n'est proposé qu'avec Facebook Login.
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