Instagram-insights via de API: account- en postmetrics
De Instagram-API geeft insights terug voor een professioneel account en voor elk van de posts, Reels en Stories. Accountmetrics omvatten reach, views, accounts met interactie, nieuwe volgers en ontvolgingen, likes, reacties, opgeslagen items en gedeelde items; postmetrics omvatten reach, views, likes, reacties, opgeslagen items en shares. Meta meldt dat de gegevens tot 48 uur kunnen achterlopen.
easyCoexistence leest Instagram-insights met get_social_insights, zodat je Claude of ChatGPT kunt vragen hoe de posts van vorige week het deden en bereik, views, likes, reacties, opgeslagen items en shares rechtstreeks van Meta krijgt, voor het account of voor één post.
Hoe lang de gegevens achter Instagram-metrics kunnen achterlopen.
Onder deze grens worden nieuwe volgers, ontvolgingen en volgersdemografie niet teruggegeven voor het account.
Hoe lang Meta mediametrics bewaart.
Hoe lang Story-metrics via de API beschikbaar blijven.
Wanneer impressions in alle API-versies stopte, behalve bij media gemaakt vóór 2 juli 2024; views nam die plaats in.
Welke accountmetrics zijn beschikbaar?
Lees ze met GET /<IG_ID>/insights, meestal met period=day en metric_type=total_value:
- reach: unieke accounts die de content zagen, inclusief advertenties; geschat.
- views: keren dat de content werd afgespeeld of getoond.
accounts_engaged: accounts die met de content interacteerden, inclusief advertenties; geschat.follows_and_unfollows: nieuwe volgers en ontvolgingen in de periode; vereist minimaal 100 volgers.- likes, comments, saves, shares, replies en reposts, plus
total_interactions. profile_links_taps: taps op de knoppen voor zakelijk adres, bellen, e-mail en sms.follower_demographicsenengaged_audience_demographics: leeftijd, stad, land en geslacht.
Welke postmetrics zijn beschikbaar?
Lees ze met GET /<IG_MEDIA_ID>/insights; welke metrics gelden hangt af van het formaat. Bij een post of Reel tellen likes, comments, views en total_interactions alleen organische activiteit, niet de interactie met advertenties die ervan zijn gemaakt.
- Posts en Reels: reach, views, likes, comments, saved, shares,
total_interactionsen reposts. - Alleen Reels:
ig_reels_avg_watch_time,ig_reels_video_view_total_timeenreels_skip_rate. - Posts en Stories: follows,
profile_visitsenprofile_activity. - Stories: reach, views, shares, replies, navigation, reposts en
total_interactions.
Hoe werken period, metric_type en uitsplitsingen?
Accountmetrics gebruiken period=day. metric_type=total_value geeft één waarde voor de hele periode terug en is wat uitsplitsingen nodig hebben; time_series geeft een waarde per dag en is beschikbaar voor reach. Uitsplitsingen verdelen een totaal per media_product_type (posts, carrousels, Reels, Stories en advertenties), per follow_type (volger of niet) of per contact_button_type.
Demografische metrics nemen een timeframe zoals this_week of this_month in plaats van since en until, en zonder since en until kijken de overige metrics 24 uur terug. Een uitsplitsing aanvragen die een van de gevraagde metrics niet ondersteunt, laat het hele verzoek mislukken met een onbekende fout.
Welke drempels en vertragingen gelden?
De regels van Meta voor wanneer een getal verschijnt en hoe lang het beschikbaar blijft:
- Gegevens kunnen tot 48 uur achterlopen.
- Accounts met minder dan 100 volgers krijgen geen
follows_and_unfollowsoffollower_demographics;engaged_audience_demographicsvereist 100 interacties in het timeframe. - Ontbrekende of niet-beschikbare gegevens komen terug als een lege set, niet als 0.
- Demografische metrics geven alleen de top 45 waarden terug.
- Accountmetrics worden tot 90 dagen bewaard, mediametrics tot 2 jaar.
Wat is anders voor Stories en carrousels?
Story-metrics zijn alleen 24 uur beschikbaar, en een waarde onder 5 geeft foutcode 10, onvoldoende kijkers, in plaats van een getal. Antwoorden van mensen in Europa en Japan worden weggelaten, en een Story die een account daar heeft gemaakt, toont 0 antwoorden. Met Instagram Login is er geen story_insights-webhook, dus Story-getallen moeten worden gelezen terwijl de Story actief is.
Een carrousel telt als één post: Meta geeft geen insights terug voor de foto's en video's erin.
Waarom veranderen metricnamen?
Omdat Meta metrics tussen API-versies uitfaseert en hernoemt. impressions werd afgekeurd voor v22.0 en stopte op 21 april 2025 in alle versies, behalve op media gemaakt vóór 2 juli 2024; views kwam ervoor in de plaats, en plays, clips_replays_count en ig_reels_aggregated_all_plays_count verdwenen tegelijk. video_views en enkele profieltijdreeksen, waaronder profile_views, waren eerder al vervallen. Een verzoek met een teruggetrokken naam mislukt, dus een metriclijst die voor een eerdere API-versie is geschreven, kan bijgewerkt moeten worden.
Veelgemaakte fouten
- impressions aanvragen. Dat werkt in geen enkele API-versie meer; vraag in plaats daarvan views op.
- Een leeg resultaat als nul behandelen. Meta geeft een lege dataset terug wanneer een metric niet beschikbaar is, en dat is niet hetzelfde als geen activiteit.
- Story-metrics lezen nadat de Story is afgelopen. Die zijn alleen 24 uur beschikbaar.
- Een uitsplitsing toevoegen aan een verzoek voor meerdere metrics. Als een ervan die niet ondersteunt, mislukt de hele aanroep.
Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.
Veelgestelde vragen
Wat verving impressions in de Instagram-API?
views, dat telt hoe vaak content werd afgespeeld of getoond. Meta haalde impressions op 21 april 2025 uit alle API-versies, behalve voor media gemaakt vóór 2 juli 2024.
Waarom geeft mijn account geen volgersgegevens terug?
Meta geeft follows_and_unfollows en volgersdemografie niet terug voor accounts met minder dan 100 volgers.
Hoe ver terug kan ik Instagram-insights lezen?
Tot 90 dagen aan accountmetrics en tot 2 jaar aan mediametrics, waarbij online_followers alleen de laatste 30 dagen beslaat.
Zijn advertenties in de cijfers opgenomen?
Gedeeltelijk. Het bereik en de accounts met interactie van een account omvatten advertenties, terwijl likes, reacties en views van een post alleen organische activiteit tellen.
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