Skip to main content
GET
Search Instagram audio
Search Instagram’s audio catalog by keyword. Use the returned audioId with instagramOptions.audioConfiguration to attach the track when you publish a Reel.
Requires Instagram linked through Facebook Login. Instagram's Audio API is only available to accounts connected via Facebook Login, which needs a Facebook Page connected to the Instagram account. Accounts connected with Instagram Login (the Ayrshare default) cannot search, look up, or attach audio, and every audio request returns code: 514.

This is a Meta restriction, not an Ayrshare one. Meta's documentation states the Audio API "is only available on the Instagram API with Facebook Login. It is not supported on the Instagram API with Instagram Login." No permission or plan upgrade changes it.

Three things are required:
1. An Instagram Business or Creator account
2. A Facebook Page connected to that Instagram account
3. Instagram linked to Ayrshare with Instagram Login disabled, so the Facebook Login flow is used

See the step-by-step setup guide.

Header Parameters

Query Parameters

string
required
Keyword to search for, such as an artist or track name. An empty or whitespace-only value returns code: 101.
string
default:"music"
Which catalog to search. Either music for licensed commercial tracks or original_sound for audio taken from other creators’ Reels. Any other value returns code: 101.
integer
Maximum number of tracks to return, from 1 to 100. Non-integer or out-of-range values return code: 101. When omitted, Instagram’s own default applies.

Response Fields

Instagram does not return every field for every track, so treat all track fields except audioId as optional.
string
success when the search completed. An empty catalog match is still a success.
string
The keyword that was searched, echoed back.
array
Matching tracks. An empty array means the search ran and matched nothing.

Errors

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

Next Steps

Attach the track to a Reel

Look up a single track