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

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.


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

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

audioId*string

Instagram audio asset ID

Match^\d{1,30}$

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?

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 Instagram publishing limit

Returns the account's remaining content-publishing quota for Instagram's rolling 24-hour window, so you can pace publishing and warn before the cap is reached. `quotaUsage` counts containers published since the start of the window. Always compare against the returned `quotaTotal` rather than hardcoding a number: Meta's prose documentation and the live API disagree on the value, and the live value is authoritative.