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"
}Get campaign analytics GET
Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign's ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass `platform` when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
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`.