Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Insights des Stories Instagram via l'API

L'endpoint d'insights des médias d'Instagram renvoie ces métriques pour une Story tant qu'elle est en ligne : portée, vues, réponses, partages, navigation, abonnements, profile_visits, profile_activity, reposts et total_interactions. navigation se ventile par story_navigation_action_type en TAP_FORWARD, TAP_BACK, TAP_EXIT et SWIPE_FORWARD. Les métriques d'une Story sont disponibles pendant 24 heures, les valeurs inférieures à 5 renvoient l'erreur 10, et Instagram Login ne propose pas de webhook story_insights.

easyCoexistence lit les insights d'une Story avec get_social_insights tant qu'elle est en ligne, pour que Claude, ChatGPT ou votre propre code puisse demander comment se sont passées les Stories du jour et obtenir directement auprès de Meta la portée, les vues, les réponses, les partages et la navigation pour le compte connecté.

24 hours

Durée de disponibilité des métriques de Story média via l'API.

Error 10

Valeur renvoyée à la place d'une métrique de Story inférieure à 5 : pas assez de spectateurs pour que le média affiche des insights.

Facebook Login

Le seul paramétrage que le guide des insights de Meta donne pour le webhook story_insights ; il n'est pas pris en charge avec Instagram Login.

0

La valeur de replies pour une Story créée par un compte en Europe ou au Japon.

22 Jun 2026

Ajout par Meta de link_clicks pour les Stories, qui compte les taps sur les liens comme les autocollants lien, pour Facebook Login uniquement.

Quelles métriques renvoie une Story ?

Celles que la référence des insights média de Meta liste pour media_product_type STORY, lues avec GET /<STORY_MEDIA_ID>/insights tant que la Story est en ligne. Avec Instagram Login, l'appel part vers graph.instagram.com avec un token portant instagram_business_basic et instagram_business_manage_insights, et period vaut toujours lifetime :

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

Comment lire la navigation par action ?

Demandez navigation seul avec breakdown=story_navigation_action_type. Le total revient dans total_value.value et chaque action dans total_value.breakdowns[].results, dont la somme correspond à ce total : TAP_FORWARD (Forward), TAP_BACK (Back), TAP_EXIT (Exit) et SWIPE_FORWARD (Next Story). La réponse type de Meta écrit les valeurs en minuscules :

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": ["story_navigation_action_type"],
            "results": [
              { "dimension_values": ["tap_forward"], "value": 19 },
              { "dimension_values": ["tap_back"], "value": 4 },
              { "dimension_values": ["tap_exit"], "value": 1 },
              { "dimension_values": ["swipe_forward"], "value": 1 }
            ]
          }
        ]
      },
      "id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

Pendant combien de temps les métriques d'une Story sont-elles disponibles ?

24 heures. Meta ne rend les métriques média d'une Story disponibles que 24 heures, soit la durée de vie de la Story elle-même, alors que les données qui les alimentent peuvent accuser jusqu'à 48 heures de retard. Lisez-les selon un calendrier tant que la Story est en ligne et conservez les dernières valeurs obtenues. Meta précise que des données peuvent encore arriver après l'expiration d'une Story ajoutée à la une, et que l'API, les webhooks et l'application peuvent alors afficher des résultats différents.

Pourquoi une métrique de Story renvoie-t-elle l'erreur 10 ?

Parce que sa valeur est inférieure à 5. Meta renvoie le code d'erreur 10 avec le message (#10) Not enough viewers for the media to show insights au lieu d'un petit nombre ; une Story vue par peu de monde peut donc échouer là où une Story plus suivie réussit. Traitez-le comme un faible nombre et non comme une panne, et ne le relancez pas en boucle.

Pourquoi les réponses d'une Story valent-elles 0 ?

À cause des règles régionales. Les réponses venant d'Europe, depuis le 1er décembre 2020, et du Japon, depuis le 14 avril 2021, sont exclues de la métrique replies, et une Story créée par un compte de l'une de ces régions renvoie 0. La référence de Meta définit replies comme les IG Comments sur l'objet média de la Story.

Existe-t-il un webhook story_insights ?

Pas avec Instagram Login. La table des champs de Meta indique story_insights comme indisponible dans ce cas, sa référence des insights média précise que le webhook d'insights n'est pas pris en charge avec Instagram Login, et son guide des insights ne liste story_insights que pour Facebook Login. Avec Facebook Login, le champ se déclenche à l'expiration d'une Story, ne transporte que ses 24 premières heures de métriques, et renvoie -1 pour les comptages inférieurs à 5.

Quelles métriques de Story sont retirées ou limitées ?

Quelques noms apparaissent encore dans l'ancien code ou dans le changelog de Meta :

  • impressions : déprécié pour les médias créés après le 2 juillet 2024, donc une Story actuelle renvoie views à la place.
  • taps_forward, taps_back et exits : retirés le 11 décembre 2023 ; navigation, ventilée par story_navigation_action_type, renvoie les mêmes actions.
  • link_clicks : taps sur les liens comme les autocollants lien, ajouté le 22 juin 2026 pour Facebook Login uniquement.
  • total_views : vues sur l'ensemble des surfaces, médias sponsorisés inclus, proposé avec Facebook Login uniquement.

Comment get_social_insights lit-il une Story ?

Avec l'identifiant média de la Story comme object_id, que publish_instagram_post renvoie sous le nom media_id lors de la publication de la Story, et les métriques sous forme de liste. Demandez navigation dans un appel séparé avec params défini sur breakdown=story_navigation_action_type, car un breakdown que l'une des métriques demandées ne prend pas en charge fait échouer tout l'appel. Les erreurs de Meta, l'erreur 10 comprise, reviennent telles que Meta les a écrites.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

Erreurs courantes

  • Lire les métriques d'une Story le lendemain. Meta ne les rend disponibles que 24 heures, donc collectez-les tant que la Story est en ligne.
  • Relancer l'erreur 10 en boucle. Elle signifie une valeur inférieure à 5, pas assez de spectateurs, et ne changera pas tant que davantage de personnes n'auront pas vu la Story.
  • Demander navigation avec un breakdown à côté d'autres métriques. story_navigation_action_type ne fonctionne qu'avec navigation seul, et un breakdown non pris en charge fait échouer tout l'appel.
  • Attendre story_insights avec Instagram Login. Meta ne propose pas ce webhook dans ce cas, donc interrogez l'endpoint d'insights avant l'expiration de la Story.
Faire cela avec EasyCoexistence

Les Stories partent avec publish_instagram_post. 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

Les insights d'une Story changent-ils après son ajout à la une ?

Ils le peuvent. Meta indique qu'une Story ajoutée à la une peut continuer à recevoir des données après son expiration, si bien que l'API, les webhooks et l'application peuvent diverger pendant un temps.

total_views fonctionne-t-il pour les Stories avec Instagram Login ?

Non. total_views, qui compte les vues sur l'ensemble des surfaces, médias sponsorisés inclus, est proposé avec Facebook Login uniquement ; avec Instagram Login, demandez views.

L'API peut-elle lire les clics sur les autocollants lien d'une Story Instagram ?

Avec Facebook Login uniquement. Meta a ajouté link_clicks pour les Stories le 22 juin 2026, en comptant les taps sur les liens comme les autocollants lien, et ne le propose pas avec Instagram Login.

Par quoi ont été remplacés taps_forward, taps_back et exits ?

Par navigation, ventilée par story_navigation_action_type en TAP_FORWARD, TAP_BACK, TAP_EXIT et SWIPE_FORWARD. Les anciennes métriques ont été retirées le 11 décembre 2023.

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