Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

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é.

21 Apr 2025

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.

21 Jan 2025

Quand Meta a introduit views pour les insights de compte et de médias, et ouvert les insights aux applications Instagram Login.

8 Jan 2025

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.

2 Jul 2024

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.

total_value

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_views sur les médias, et les séries temporelles de compte email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks et website_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_count et ig_reels_aggregated_all_plays_count sur 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.

RetiredRequest instead
impressionsAccount and media, 21 Apr 2025views
playsMedia, 21 Apr 2025views
clips_replays_countMedia, 21 Apr 2025views
ig_reels_aggregated_all_plays_countMedia, 21 Apr 2025views
video_viewsMedia, 8 Jan 2025views
phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicksAccount, 8 Jan 2025profile_links_taps, by contact_button_type
profile_viewsAccount, 8 Jan 2025profile_visits, per post or Story
website_clicksAccount, 8 Jan 2025profile_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_rate et reposts sur les médias, reposts sur le compte, et crossposted_views et facebook_views pour les Reels publiés en crosspost.
  • 22 avril 2026 : total_likes, total_comments et total_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_views s'étend aussi aux publications et aux Stories.
  • 22 juin 2026 : link_clicks sur 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_count et video_views par 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 de time_series : lisez donc un total par période là où impressions donnait une courbe quotidienne.
  • Demander crossposted_views et facebook_views uniquement 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_comments et total_views dans les applications Instagram Login, car Meta ne les propose qu'avec Facebook Login.
  • Remplacer phone_call_clicks, email_contacts, text_message_clicks et get_direction_clicks par profile_links_taps, ventilé par contact_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, et audience_gender_age, audience_locale, audience_country et audience_city sur le compte, où follower_demographics couvre 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_days et prev_month pour engaged_audience_demographics et reached_audience_demographics ; this_week et this_month restent.

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.
Faire cela avec EasyCoexistence

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