Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Insights de l'API Instagram : métriques du compte et des publications

L'API Instagram renvoie les insights d'un compte professionnel, ainsi que ceux de chacune de ses publications, Reels et Stories. Les métriques du compte incluent la portée, les vues, les comptes engagés, les abonnements et désabonnements, les mentions j'aime, les commentaires, les enregistrements et les partages. Celles des publications comprennent la portée, les vues, les mentions j'aime, les commentaires, les enregistrements et les partages. Meta précise que les données peuvent accuser un retard allant jusqu'à 48 heures.

easyCoexistence lit les insights Instagram avec get_social_insights : vous pouvez demander à Claude ou ChatGPT comment se sont passées les publications de la semaine dernière et obtenir directement auprès de Meta la portée, les vues, les mentions j'aime, les commentaires, les enregistrements et les partages, pour le compte ou pour une seule publication.

48 hours

Durée pendant laquelle les données des métriques Instagram peuvent être retardées.

100 followers

En dessous de ce seuil, les abonnements, désabonnements et données démographiques des abonnés ne sont pas renvoyés pour le compte.

2 years

Durée pendant laquelle Meta conserve les métriques des médias.

24 hours

Durée pendant laquelle les métriques des Stories restent disponibles via l'API.

21 Apr 2025

Date à partir de laquelle impressions a cessé de fonctionner dans toutes les versions de l'API, sauf pour les médias créés avant le 2 juillet 2024 ; views les remplace.

Quelles métriques de compte sont disponibles ?

Lisez-les avec GET /<IG_ID>/insights, surtout avec period=day et metric_type=total_value :

  • reach : comptes uniques ayant vu le contenu, publicités comprises ; valeur estimée.
  • views : nombre de fois où le contenu a été lu ou affiché.
  • accounts_engaged : comptes ayant interagi avec le contenu, publicités comprises ; valeur estimée.
  • follows_and_unfollows : abonnements et désabonnements sur la période ; nécessite au moins 100 abonnés.
  • likes, comments, saves, shares, replies et reposts, ainsi que total_interactions.
  • profile_links_taps : clics sur les boutons d'adresse, d'appel, d'e-mail et de SMS de l'entreprise.
  • follower_demographics et engaged_audience_demographics : âge, ville, pays et genre.

Quelles métriques de publication sont disponibles ?

Lisez-les avec GET /<IG_MEDIA_ID>/insights ; les métriques applicables dépendent du format. Pour une publication ou un Reel, les mentions j'aime, commentaires, vues et interactions totales ne comptent que l'activité organique, pas l'engagement généré par les publicités créées à partir de celle-ci.

  • Publications et Reels : reach, views, likes, comments, saved, shares, total_interactions et reposts.
  • Reels uniquement : ig_reels_avg_watch_time, ig_reels_video_view_total_time et reels_skip_rate.
  • Publications et Stories : follows, profile_visits et profile_activity.
  • Stories : reach, views, shares, replies, navigation, reposts et total_interactions.

Comment fonctionnent period, metric_type et les ventilations ?

Les métriques de compte utilisent period=day. metric_type=total_value renvoie une seule valeur pour la plage ; c'est le mode requis pour les ventilations. time_series renvoie une valeur par jour et n'est disponible que pour reach. Les ventilations répartissent un total par media_product_type (publications, carrousels, Reels, Stories et publicités), par follow_type (abonnés ou non) ou par contact_button_type.

Les métriques démographiques prennent un timeframe comme this_week ou this_month à la place de since et until ; sans since ni until, les autres métriques portent sur les 24 dernières heures. Demander une ventilation que l'une des métriques demandées ne prend pas en charge fait échouer toute la requête avec une erreur inconnue.

Quels seuils et délais s'appliquent ?

Les règles de Meta pour l'apparition d'un chiffre et sa durée de disponibilité :

  • Les données peuvent être retardées jusqu'à 48 heures.
  • Les comptes de moins de 100 abonnés ne reçoivent ni follows_and_unfollows ni follower_demographics ; engaged_audience_demographics exige 100 engagements sur la période.
  • Les données manquantes ou indisponibles sont renvoyées sous forme d'ensemble vide, et non comme 0.
  • Les métriques démographiques ne renvoient que les 45 premières valeurs.
  • Les métriques de compte sont conservées jusqu'à 90 jours, celles des médias jusqu'à 2 ans.

Qu'est-ce qui change pour les Stories et les carrousels ?

Les métriques des Stories ne sont disponibles que pendant 24 heures, et une valeur inférieure à 5 renvoie le code d'erreur 10 (pas assez de spectateurs) au lieu d'un nombre. Les réponses des personnes situées en Europe et au Japon sont exclues : une Story créée depuis un compte de ces zones affiche 0 réponse. Avec Instagram Login, il n'existe pas de webhook story_insights ; les chiffres des Stories doivent donc être relevés pendant que la Story est visible.

Un carrousel est compté comme une seule publication : Meta ne renvoie aucun insight pour les photos et vidéos qui le composent.

Pourquoi les noms de métriques changent-ils ?

Parce que Meta retire et renomme des métriques d'une version de l'API à l'autre. impressions est devenu obsolète en v22.0 et a cessé de fonctionner dans toutes les versions le 21 avril 2025, sauf pour les médias créés avant le 2 juillet 2024 ; views l'a remplacé. plays, clips_replays_count et ig_reels_aggregated_all_plays_count ont été retirés en même temps. video_views et plusieurs séries temporelles de profil, dont profile_views, avaient été supprimées plus tôt. Une requête contenant un nom retiré échoue : une liste de métriques écrite pour une version antérieure de l'API peut donc avoir besoin d'une mise à jour.

Erreurs courantes

  • Demander impressions. Ce champ ne fonctionne plus dans aucune version de l'API ; demandez views à la place.
  • Prendre un résultat vide pour zéro. Meta renvoie un ensemble de données vide lorsqu'une métrique est indisponible, ce qui n'équivaut pas à une absence d'activité.
  • Lire les métriques d'une Story après sa fin. Elles ne sont disponibles que pendant 24 heures.
  • Ajouter une ventilation à une requête portant sur plusieurs métriques. Si l'une d'elles ne la prend pas en charge, tout l'appel échoue.
Faire cela avec EasyCoexistence

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é impressions dans l'API Instagram ?

views, qui compte le nombre de fois où le contenu a été lu ou affiché. Meta a retiré impressions dans toutes les versions de l'API le 21 avril 2025, sauf pour les médias créés avant le 2 juillet 2024.

Pourquoi mon compte ne renvoie-t-il aucune donnée sur les abonnés ?

Meta ne renvoie pas follows_and_unfollows ni les données démographiques des abonnés pour les comptes comptant moins de 100 abonnés.

Sur quelle période puis-je lire les insights Instagram ?

Jusqu'à 90 jours de métriques de compte et jusqu'à 2 ans de métriques de médias, online_followers ne couvrant que les 30 derniers jours.

Les chiffres incluent-ils les publicités ?

En partie. La portée et les comptes engagés d'un compte incluent les publicités, tandis que les mentions j'aime, commentaires et vues d'une publication ne comptent que l'activité organique.

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