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

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.

GET
/v1/accounts/{accountId}/instagram/audio

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 ID of the Instagram account

Query Parameters

audioType*string

Catalog to search: licensed music or original sounds from Reels.

Value in

  • "music"
  • "original_sound"
q?string

Search keywords. Omit to get the current trending list.

Length1 <= length <= 200

Response Body

application/json

application/json

application/json

application/json

application/json

{  "audio": [    {      "audioId": "string",      "title": "string",      "audioType": "music",      "durationInMs": 0,      "displayArtist": "string",      "coverArtworkThumbnailUrl": "string",      "downloadUrl": "string",      "igUsername": "string",      "profilePictureUrl": "string",      "isAdsEligible": true,      "onPlatformAudioPreviewLink": "string"    }  ]}
Was this page helpful?

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 Instagram audio metadata

Fetch one audio asset's metadata by ID. Use it to re-validate a stored `audioId` before a scheduled Reel publishes, or to refresh the preview `downloadUrl` (Meta expires preview URLs after roughly 1.5 days). Same connection requirement as the search endpoint: Facebook-Login Instagram accounts only.