Zernio
Zernio
API Reference

Instagram

List active Instagram storiesGETSearch Instagram audioGETGet Instagram audio metadataGETGet Instagram publishing limitGETGet Instagram story insightsGET
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Instagram

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
  • mediaUrl may be null if Meta flagged the story for copyright
  • caption, likeCount, commentsCount do not apply to story media
GET
/v1/accounts/{accountId}/instagram/stories

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string

The Instagram account ID

Response Body

application/json

application/json

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"    }  ]}
Was this page helpful?

Create, update or delete products in bulk

Up to 5000 CREATE / UPDATE / DELETE requests keyed by `retailerId`, processed asynchronously by Meta. Returns handles; poll GET /v1/ads/catalogs/{catalogId}/batches/{handle} for the outcome and per-item errors. CREATE requests need name, url, imageUrl, price and currency.

Search Instagram audio

Search Instagram's audio catalog (licensed music or original sounds), or list what is currently trending by omitting `q`. Returns up to ~30 assets; Meta exposes no pagination on this edge. Pass the returned `audioId` as `platformSpecificData.audioConfiguration.audioId` when creating a Reel to publish it with that track. Requires an Instagram account connected via **Facebook Login**. Meta hosts this catalog on graph.facebook.com only, so accounts connected with classic Instagram Login receive a 400 (`instagram_audio_requires_facebook_login`) and must be reconnected choosing the Facebook option.