instagram
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.
AuthorizationBearer <token>
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
accountIdstring
The Instagram account ID
storyIdstring
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
}
}
}Empty
{
"error": "Unauthorized"
}Empty