Skip to main content
GET
Get Instagram audio metadata
Retrieve the details of one audio track by its audioId. Use this to confirm a stored id is still valid, or to show a track’s title and artwork before publishing.

Header Parameters

Path Parameters

string
required
The track id, as returned by audio search. An id Instagram does not recognize returns code: 517.

Response Fields

The track’s fields are returned flat on the response object rather than nested. Instagram does not return every field for every track, so treat all fields except audioId as optional.
string
success when the track was found.
string
The track id, echoed back.
string
Track title.
string
Artist name as Instagram displays it.
integer
Track length in milliseconds.
string
Cover artwork thumbnail URL.
string
Either music or original_sound.
boolean
Whether the track may be used in an ad.
Availability is region-dependent. Meta returns the same error for an id that does not exist, one that is not licensed in the account’s region, and one that is not licensed for this use. All three report 517, so a track that resolves for one account can legitimately fail for another. Look up an id rather than assuming a stored one still works.

Errors

Codes 514 to 518 are described in Instagram Reels audio errors; the rest are in the Ayrshare error reference.

Next Steps

Search for a track

Attach the track to a Reel