Instagram Story-inzichten via de API
Het media-insights-endpoint van Instagram geeft deze metrics voor een Story zolang die actief is: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts en total_interactions. navigation wordt uitgesplitst per story_navigation_action_type in TAP_FORWARD, TAP_BACK, TAP_EXIT en SWIPE_FORWARD. Story-metrics zijn 24 uur beschikbaar, waarden onder 5 geven foutcode 10, en Instagram Login heeft geen story_insights-webhook.
easyCoexistence leest de insights van een Story met get_social_insights zolang die actief is, zodat Claude, ChatGPT of je eigen code kan vragen hoe de Stories van vandaag het deden, en bereik, views, replies, shares en navigation rechtstreeks van Meta krijgt voor het gekoppelde account.
Hoe lang Story-mediametrics via de API beschikbaar zijn.
Wordt teruggegeven in plaats van een waarde wanneer een Story-metric onder 5 ligt: te weinig kijkers om insights te tonen.
De enige setup die Meta's insights-gids geeft voor de story_insights-webhook; die wordt niet ondersteund met Instagram Login.
De replies-waarde voor een Story aangemaakt door een account in Europa of Japan.
Toen Meta link_clicks voor Stories toevoegde, die tikken op links zoals linkstickers telt, alleen voor Facebook Login.
Welke metrics geeft een Story terug?
Die uit de media-insights-referentie van Meta voor media_product_type STORY, opgevraagd met GET /<STORY_MEDIA_ID>/insights zolang de Story actief is. Met Instagram Login gaat de aanroep naar graph.instagram.com met een token met instagram_business_basic en instagram_business_manage_insights, en period is altijd lifetime:
Hoe lees je navigation per actie uit?
Vraag navigation apart op met breakdown=story_navigation_action_type. Het totaal komt terug in total_value.value en elke actie in total_value.breakdowns[].results, die samen het totaal vormen: TAP_FORWARD (Forward), TAP_BACK (Back), TAP_EXIT (Exit) en SWIPE_FORWARD (Next Story). Het voorbeeldantwoord van Meta schrijft de waarden in kleine letters:
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"
}
]
}Hoelang zijn Story-metrics beschikbaar?
24 uur. Meta maakt Story-mediametrics slechts 24 uur beschikbaar, de eigen levensduur van de Story, terwijl de data erachter tot 48 uur kan achterlopen. Lees ze volgens een schema zolang de Story actief is en bewaar de laatste waarden die je kreeg. Meta meldt dat data na het verlopen van een Story nog kan binnenkomen als die aan een highlight is toegevoegd, en dat API-aanroepen, webhooks en de app dan verschillende resultaten kunnen tonen.
Waarom geeft een Story-metric foutcode 10?
Omdat de waarde onder 5 ligt. Meta geeft foutcode 10 terug met de melding (#10) Not enough viewers for the media to show insights in plaats van een klein getal, dus een Story die door weinig mensen is gezien kan falen waar een drukkere Story slaagt. Zie het als een laag aantal en niet als een storing, en probeer het niet in een lus opnieuw.
Waarom staan replies van een Story op 0?
Regionale regels. Reacties van mensen in Europa, sinds 1 december 2020, en in Japan, sinds 14 april 2021, vallen buiten de replies-metric, dus een Story van een account in een van die regio's geeft 0. De referentie van Meta definieert replies als IG Comments op het Story-mediaobject.
Is er een story_insights-webhook?
Niet met Instagram Login. De velden-tabel van Meta markeert story_insights daar als niet beschikbaar, de referentie van de media-insights zegt dat de insights-webhook niet wordt ondersteund met Instagram Login, en de insights-gids vermeldt story_insights alleen voor Facebook Login. Met Facebook Login vuurt het veld wanneer een Story verloopt, bevat het alleen de eerste 24 uur aan metrics en geeft het tellingen onder 5 terug als -1.
Welke Story-metrics zijn uitgefaseerd of beperkt?
Een paar namen staan nog in oude code of in het changelog van Meta:
- impressions: verouderd voor media gemaakt na 2 juli 2024, dus een actuele Story geeft views terug.
taps_forward,taps_backen exits: uitgefaseerd op 11 december 2023; navigation, uitgesplitst perstory_navigation_action_type, geeft dezelfde acties terug.link_clicks: tikken op links zoals linkstickers, toegevoegd op 22 juni 2026, alleen voor Facebook Login.total_views: views over alle plaatsingen, inclusief gepromote media, alleen beschikbaar met Facebook Login.
Hoe leest get_social_insights een Story?
Met het media-ID van de Story als object_id, dat publish_instagram_post teruggeeft als media_id wanneer het de Story publiceert, en de metrics als lijst. Vraag navigation in een aparte aanroep op met params ingesteld op breakdown story_navigation_action_type, omdat een breakdown die een van de gevraagde metrics niet ondersteunt de hele aanroep laat mislukken. Fouten van Meta, ook foutcode 10, komen terug zoals Meta ze schreef.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}Veelgemaakte fouten
- Een Story's metrics de volgende dag uitlezen. Meta maakt ze slechts 24 uur beschikbaar, dus verzamel ze terwijl de Story actief is.
- Foutcode 10 in een lus opnieuw proberen. Dat betekent een waarde onder 5, te weinig kijkers, en het verandert pas als meer mensen de Story zien.
- navigation met een breakdown naast andere metrics opvragen. story_navigation_action_type werkt alleen met navigation, en een niet-ondersteunde breakdown laat de hele aanroep mislukken.
- Wachten op story_insights met Instagram Login. Meta biedt die webhook daar niet aan, dus poll het insights-endpoint voordat de Story verloopt.
Stories publiceer je met publish_instagram_post. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Veranderen Story-insights nadat een Story aan een highlight is toegevoegd?
Dat kan. Meta zegt dat een Story die aan een highlight is toegevoegd na het verlopen nog data kan blijven ontvangen, dus de API, webhooks en de app kunnen even uiteenlopen.
Werkt total_views voor Stories met Instagram Login?
Nee. total_views, dat views over alle plaatsingen telt, inclusief gepromote media, is alleen beschikbaar met Facebook Login; met Instagram Login vraag je views op.
Kan de API linkstickerklikken op een Instagram Story lezen?
Alleen met Facebook Login. Meta voegde link_clicks voor Stories toe op 22 juni 2026, dat tikken op links zoals linkstickers telt, en biedt het niet aan met Instagram Login.
Wat verving taps_forward, taps_back en exits?
navigation, uitgesplitst per story_navigation_action_type in TAP_FORWARD, TAP_BACK, TAP_EXIT en SWIPE_FORWARD. De oude metrics zijn uitgefaseerd op 11 december 2023.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op