Audio

Audio ids come from GET /search/audio, from clips_metadata on any reel, or from the trending list.

Track info

Metadata for a track or an original sound: title, artist, duration, and how many reels use it.

Path Parameters

audio_id*Audio Id

curl -X GET "https://example.com/audio/string"

{}

{}

What comes back

{
  "music_canonical_id": "18234567890123456",
  "audio_page_reporting_id": "...",
  "formatted_media_count": "1.2M",
  "is_music_page_restricted": false,
  "metadata": {
    "music_info": {
      "music_asset_info": {
        "title": "Song Title",
        "display_artist": "Artist",
        "duration_in_ms": 29000,
        "cover_artwork_uri": "https://..."
      }
    }
  },
  "spotify_track_metadata": null
}

Licensed tracks carry metadata.music_info; a creator's original sound carries metadata.original_sound_info instead, with the reel it came from. Check which is present rather than assuming.

Reels using an audio

The feed behind a sound's page. Standard cursor; items are media objects identical in shape to /posts/{id}.

Path Parameters

audio_id*Audio Id

Query Parameters

cursor?|

Opaque pagination cursor from a previous next_cursor

curl -X GET "https://example.com/audio/string/medias"

{}

{}

What comes back

The standard list envelope, with media objects in the same shape as a post. All of them are reels (product_type: "clips").

Instagram's trending-audio list, as shown in the composer. Standard cursor.

Query Parameters

cursor?|

Opaque pagination cursor from a previous next_cursor

curl -X GET "https://example.com/audio/trending"

{}

{}

What comes back

The standard list envelope, with items in the same shape as audio search — a track or an original_sound, whichever the entry is.

Errors

Code	When
`not_found`	No such audio id, or the sound was removed for rights reasons.
`invalid_cursor`	The `cursor` was not one we issued.
`upstream_error`	Transient. Retry.

On this page