Get Instagram story insights
Returns metrics for a single story. The source field discriminates
between three states:
live— fetched from Meta in real time (story is still active)cached— fetched from a persistedstory_insightswebhook payload (story has expired but we received its final-state metrics from Meta)unavailable— story has expired and we never received its webhook payload (for example, the account connected after the story expired)
Field semantics follow Meta's API. Counts below 5 may be returned as 0
due to Meta's privacy floor on small audiences. The navigation field
is the sum of tapsForward + tapsBack + exits + swipesForward.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
The Instagram account ID
The Instagram media ID of the story.
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.instagram.getInstagramStoryInsights({ path: { accountId: 'account_abc123', storyId: 'story_abc123', },});console.log(data);{
"data": {
"source": "live",
"metrics": {
"views": 0,
"reach": 0,
"replies": 0,
"shares": 0,
"navigation": 0,
"tapsForward": 0,
"tapsBack": 0,
"exits": 0,
"swipesForward": 0,
"profileVisits": 0,
"follows": 0,
"reposts": 0,
"totalInteractions": 0
}
}
}{
"error": "Unauthorized"
}List active Instagram stories GET
Returns the IG Business/Creator account's currently-active stories. Meta keeps stories live for 24h; expired stories are not returned. Limitations propagated from Meta (these are NOT bugs): - 24h window only - Live videos excluded - Reshared stories not returned - `mediaUrl` may be null if Meta flagged the story for copyright - `caption`, `likeCount`, `commentsCount` do not apply to story media
List templates GET
List all message templates for the WhatsApp Business Account (WABA) associated with the given account. Templates are fetched directly from the WhatsApp Cloud API.