Métriques Instagram API retirées : impressions et plays remplacés par views
Meta a remplacé impressions par views dans l'API insights d'Instagram. views a été introduit le 21 janvier 2025, et impressions, plays, clips_replays_count et ig_reels_aggregated_all_plays_count ont été dépréciés dans toutes les versions de l'API le 21 avril 2025, après la fin de video_views et de six métriques de compte le 8 janvier. Des changements ultérieurs ont ajouté des métriques, comme reposts et reels_skip_rate en décembre 2025.
easyCoexistence lit les insights Instagram avec get_social_insights, qui transmet à Meta les noms de métriques que vous donnez, views compris, et renvoie les données de Meta, ou le message d'erreur de Meta lorsqu'un nom est retiré.
Quand impressions, plays, clips_replays_count et ig_reels_aggregated_all_plays_count ont été dépréciés dans toutes les versions de l'API.
Quand Meta a introduit views pour les insights de compte et de médias, et ouvert les insights aux applications Instagram Login.
Quand video_views et six séries temporelles de compte, dont profile_views et website_clicks, ont cessé d'être prises en charge dans toutes les versions.
Les médias créés à partir de cette date renvoient une erreur, et non des données, si impressions est demandé après le 21 avril 2025.
Le seul metric_type accepté par la métrique views au niveau du compte ; impressions proposait aussi une time_series quotidienne.
Quelles métriques Instagram ont été retirées en 2025 ?
Deux vagues, chacune annoncée plusieurs mois à l'avance dans le journal des modifications de Meta, appliquées d'abord à partir d'une nouvelle version de Graph API, puis à toutes les versions :
- 8 janvier 2025 :
video_viewssur les médias, et les séries temporelles de compteemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksetwebsite_clicks, d'abord abandonnées dans la v21.0. - 21 janvier 2025 : impressions sur les insights de compte et de médias, ainsi que plays,
clips_replays_countetig_reels_aggregated_all_plays_countsur les médias, dépréciés pour la v22.0 et les versions ultérieures, le jour même de l'arrivée de views. - 21 avril 2025 : ces quatre métriques dépréciées dans toutes les versions de l'API.
Par quoi remplacer chaque métrique retirée ?
Meta a associé views aux retraits d'avril 2025 dans la même entrée du journal des modifications. Pour ceux de janvier, il n'a nommé aucun successeur ; la colonne de droite donne donc la métrique la plus proche que ses références de compte et de médias documentaient au 31 octobre 2026.
| Retired | Request instead | |
|---|---|---|
| impressions | Account and media, 21 Apr 2025 | views |
| plays | Media, 21 Apr 2025 | views |
| clips_replays_count | Media, 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Media, 21 Apr 2025 | views |
| video_views | Media, 8 Jan 2025 | views |
| phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicks | Account, 8 Jan 2025 | profile_links_taps, by contact_button_type |
| profile_views | Account, 8 Jan 2025 | profile_visits, per post or Story |
| website_clicks | Account, 8 Jan 2025 | profile_activity per post, whose action_type includes BIO_LINK_CLICKED |
Est-ce qu'impressions renvoie encore des données ?
Seulement pour les anciens médias. Le journal des modifications de Meta indique que les requêtes faites après le 21 avril 2025 pour des médias créés à partir du 2 juillet 2024 renvoient une erreur, et sa référence des insights de médias ne conserve impressions que pour les médias créés avant cette date. Au niveau du compte, impressions est déprécié dans toutes les versions : un code écrit aujourd'hui n'a donc aucune raison de l'utiliser.
Que compte views ?
Au niveau du compte, le nombre de fois où le contenu a été lu ou affiché, sur les Reels, les publications et les Stories ; sur une publication, un Reel ou une Story seule, le nombre de fois où il a été lu sur Instagram. impressions comptait les fois où le contenu était à l'écran, publicités comprises : un graphique qui passe de l'une à l'autre change donc de mesure au moment du basculement. views au niveau du compte n'accepte que metric_type=total_value et se décline par media_product_type, et Meta le signale toujours comme étant en développement.
Quelles métriques ont été ajoutées depuis ?
Le journal des modifications de Meta recense ces ajouts après les retraits de 2025 :
- 3 décembre 2025 :
reels_skip_rateet reposts sur les médias, reposts sur le compte, etcrossposted_viewsetfacebook_viewspour les Reels publiés en crosspost. - 22 avril 2026 :
total_likes,total_commentsettotal_views, agrégés sur l'ensemble des surfaces et incluant les médias sponsorisés, que la référence de Meta ne propose qu'avec Facebook Login ;facebook_viewss'étend aussi aux publications et aux Stories. - 22 juin 2026 :
link_clickssur les Stories, qui comptent les appuis sur les liens comme les autocollants de lien, et que le journal limite à Facebook Login.
Que faut-il changer dans le code ?
Une liste de métriques écrite avant 2025 doit subir ces changements pour continuer à fonctionner :
- Remplacer impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countetvideo_viewspar views, dans les requêtes de compte comme de médias. - Demander views au niveau du compte avec
metric_type=total_value. Il n'a pas detime_series: lisez donc un total par période là où impressions donnait une courbe quotidienne. - Demander
crossposted_viewsetfacebook_viewsuniquement pour les médias publiés en crosspost, dans une requête distincte : la référence de Meta indique que les deux renvoient une erreur si le média n'a pas été publié en crosspost. - Ne pas inclure
total_likes,total_commentsettotal_viewsdans les applications Instagram Login, car Meta ne les propose qu'avec Facebook Login. - Remplacer
phone_call_clicks,email_contacts,text_message_clicksetget_direction_clicksparprofile_links_taps, ventilé parcontact_button_type. - Traiter une erreur sur un nom de métrique comme un signal pour mettre la liste à jour, et non comme une raison de relancer la requête.
Comment les dépréciations atteignent-elles les anciennes versions de l'API ?
En deux temps. Un changement s'applique d'abord à partir d'une nouvelle version de Graph API, v21.0 pour video_views et v22.0 pour impressions, puis atteint toutes les versions à une date indiquée dans la même entrée du journal, environ trois mois plus tard dans les deux cas. Épingler une version plus ancienne n'apporte que quelques mois au mieux, et le journal des modifications de la plateforme Instagram de Meta indique les deux dates pour chaque changement.
Quels retraits antérieurs touchent encore un ancien code ?
Deux retraits d'avant 2025 apparaissent dans du code qui n'a pas été modifié depuis :
- 11 décembre 2023 : les métriques de
carousel_album,taps_forward,taps_back, exits et engagement sur les médias, etaudience_gender_age,audience_locale,audience_countryetaudience_citysur le compte, oùfollower_demographicscouvre désormais l'âge, la ville, le pays et le genre. - 19 août 2024 : les périodes
last_14_days,last_30_days,last_90_daysetprev_monthpourengaged_audience_demographicsetreached_audience_demographics;this_weeketthis_monthrestent.
Erreurs courantes
- Demander impressions pour une publication publiée depuis juillet 2024. Meta renvoie une erreur pour ce média ; demandez views.
- Demander les views du compte sous forme de time_series. Meta ne les documente qu'avec total_value : lisez donc un total pour chaque période nécessaire.
- Demander crossposted_views ou facebook_views pour un média qui n'a jamais été publié en crosspost. La référence de Meta indique que les deux renvoient alors une erreur.
- Attendre total_likes, total_comments ou total_views avec Instagram Login. Meta ne les rend disponibles qu'avec Facebook Login ; les j'aime, les commentaires et views restent disponibles.
Ainsi, Claude, ChatGPT ou votre propre code peuvent suivre un renommage le jour même où Meta l'annonce. 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
Par quoi ont été remplacés phone_call_clicks et email_contacts dans l'API Instagram ?
Meta n'a nommé aucun successeur direct lorsqu'elles ont pris fin dans toutes les versions le 8 janvier 2025. La métrique la plus proche que sa référence de compte documente aujourd'hui est profile_links_taps, ventilée par contact_button_type.
Par quoi ont été remplacées les plays des Reels Instagram ?
views. Meta a déprécié plays, clips_replays_count et ig_reels_aggregated_all_plays_count dans toutes les versions de l'API le 21 avril 2025, trois mois après l'introduction de views.
Pourquoi mon appel aux insights Instagram a-t-il commencé à échouer ?
Vérifiez d'abord la liste des métriques : impressions, plays, video_views et les anciennes métriques de profil sont retirées, et views au niveau du compte n'accepte que total_value. Relancer la même requête renvoie la même erreur.
Meta a-t-il retiré des métriques Instagram en 2026 ?
Aucune n'apparaît dans le journal des modifications Instagram de Meta jusqu'au 28 octobre 2026. Ses entrées de 2026 ajoutent plutôt des métriques, dont total_views, un facebook_views élargi et link_clicks sur les Stories.
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