List active Instagram stories
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
mediaUrlmay be null if Meta flagged the story for copyrightcaption,likeCount,commentsCountdo not apply to story media
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
The Instagram account ID
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.listInstagramStories({ path: { accountId: 'account_abc123', },});console.log(data);{
"data": [
{
"id": "string",
"mediaType": "string",
"mediaProductType": "string",
"mediaUrl": "string",
"permalink": "string",
"thumbnailUrl": "string",
"timestamp": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Unauthorized"
}Stop sharing a tracking tag with an ad account DELETE
`adAccountId` may be passed as a query parameter (recommended) or as a JSON body field for clients that can send DELETE bodies. Meta only (platform `metaads`); other platforms return 405.
Get Instagram story insights GET
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 persisted `story_insights` webhook 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`.