List Instagram audio Reels

List Instagram Reels that use a specific audio track, with track metadata, tagged users, and coauthors when Instagram exposes them.

GET/v1/instagram/audio/{audioId}/reels
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
audioIdstringrequiredpath

Instagram audio id whose Reels should be listed.

min 1 chars

cursorstringoptionalquery

Pagination cursor returned by a previous response.

min 1 chars

Response fields
79

Endpoint-specific response payload.

dataaudioId
string

Audio id that was evaluated for this response.

Track-level metadata for the requested audio, lifted from the first reel that exposes licensed-music or original-sound details. Omitted when no reel on this page includes audio attribution.

dataaudioaudioId
stringnullableoptional

Instagram audio cluster / audio-page id when available. Matches the path `audioId` when Instagram exposes the same cluster.

dataaudioaudioAssetId
stringnullableoptional

Licensed-music or original-sound asset id when available.

dataaudioartistName
stringnullableoptional

Attributed artist name when available.

dataaudioartistHandle
stringnullableoptional

Instagram username for the attributed artist when available.

dataaudiosongName
stringnullableoptional

Attributed song or audio title when available.

dataaudiocoverUrl
stringnullableoptional

Cover artwork. Instagram CDN URL when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset.

dataaudiocoverThumbnailUrl
stringnullableoptional

Smaller cover artwork. Instagram CDN URL when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset.

dataaudiodurationMs
integeroptional

Full track duration in milliseconds when available.

≥ 0

dataaudioisExplicit
booleanoptional

Whether Instagram marks the track as explicit.

dataaudiohasLyrics
booleanoptional

Whether Instagram indicates the track has lyrics.

dataaudiousesOriginalAudio
booleanoptional

Whether this is original audio rather than licensed music.

Instagram Reels that use the requested audio. Order is Instagram's audio-page ranking, not chronological. An empty array can mean no public Reels for this audio, or other cases—this route has no lookupStatus.

datareels[]id
string

Instagram media id for this reel.

min 1 chars

datareels[]shortcode
string

Public shortcode used in the Instagram reel URL.

min 1 chars

datareels[]url
string

Canonical public Instagram URL for this reel.

min 1 chars

datareels[]caption
stringnullable

Caption text when available.

datareels[]createdAt
string

When the reel was taken or posted (ISO-8601).

datareels[]thumbnailUrl
stringnullable

Thumbnail or cover image URL when available.

datareels[]displayUrl
stringnullable

Primary display image URL when available.

datareels[]videoUrl
stringnullable

Direct video URL when a playable URL is available.

datareels[]hasAudio
booleannullable

Whether the reel includes audio when known.

Engagement metrics when available.

datareels[]metricsplays
integernullable

Play count when available.

≥ 0

datareels[]metricslikes
integernullable

Like count when available.

≥ 0

datareels[]metricscomments
integernullable

Comment count when available.

≥ 0

Width and height when available.

datareels[]dimensionswidth
integer

Media width in pixels.

≥ 0

datareels[]dimensionsheight
integer

Media height in pixels.

≥ 0

Reel owner metadata when available.

datareels[]ownerplatformUserId
stringnullable

Instagram numeric user id for the reel owner when present.

datareels[]ownerhandle
stringnullable

Instagram username for the reel owner when present.

datareels[]ownerdisplayName
stringnullable

Display name for the reel owner when present.

datareels[]owneravatarUrl
stringnullable

Profile image URL for the reel owner when present.

datareels[]ownerverified
booleannullable

Whether Instagram marks the reel owner as verified.

datareels[]ownerprivateAccount
booleannullable

Whether the reel owner account is private.

datareels[]videoDurationSec
numberoptional

Video duration in seconds when available.

≥ 0

Tagged location when Instagram exposes it.

datareels[]locationid
stringoptional

Location id when Instagram provides one.

datareels[]locationname
stringnullableoptional

Location name when Instagram provides one.

datareels[]locationslug
stringnullableoptional

Location slug when Instagram provides one.

datareels[]locationaddressJson
stringnullableoptional

Serialized address metadata when Instagram provides it.

datareels[]locationlat
numberoptional

Latitude when Instagram exposes it.

datareels[]locationlng
numberoptional

Longitude when Instagram exposes it.

Audio attribution when Instagram exposes it.

datareels[]audioaudioId
stringnullableoptional

Instagram audio cluster / audio-page id when available. Matches the path `audioId` when Instagram exposes the same cluster.

datareels[]audioaudioAssetId
stringnullableoptional

Licensed-music or original-sound asset id when available.

datareels[]audioartistName
stringnullableoptional

Attributed artist name when available.

datareels[]audioartistHandle
stringnullableoptional

Instagram username for the attributed artist when available.

datareels[]audiosongName
stringnullableoptional

Attributed song or audio title when available.

datareels[]audiocoverUrl
stringnullableoptional

Cover artwork. Instagram CDN URL when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset.

datareels[]audiocoverThumbnailUrl
stringnullableoptional

Smaller cover artwork. Instagram CDN URL when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset.

datareels[]audiodurationMs
integeroptional

Full track duration in milliseconds when available.

≥ 0

datareels[]audioisExplicit
booleanoptional

Whether Instagram marks the track as explicit.

datareels[]audiohasLyrics
booleanoptional

Whether Instagram indicates the track has lyrics.

datareels[]audiousesOriginalAudio
booleanoptional

Whether this is original audio rather than licensed music.

datareels[]audioshouldMuteAudio
booleanoptional

Whether Instagram indicates the audio should be muted.

datareels[]audioshouldMuteAudioReason
stringnullableoptional

Reason for muting audio when Instagram provides one.

datareels[]audiostartTimeMs
integeroptional

Offset into the track where this reel's clip starts, in milliseconds.

≥ 0

datareels[]audiooverlapDurationMs
integeroptional

How much of the track this reel uses, in milliseconds, when Instagram exposes it.

≥ 0

datareels[]audioisTrending
booleanoptional

Whether Instagram marks this audio as trending in Reels at fetch time.

Users tagged in the reel when Instagram exposes them.

datareels[]taggedUsers[]handle
string

Tagged Instagram username without a leading @.

min 1 chars

datareels[]taggedUsers[]platformUserId
stringoptional

Instagram numeric user id for the tagged account when present.

Collaborators listed on the reel when Instagram exposes them.

datareels[]coauthors[]handle
string

Coauthor Instagram username without a leading @.

min 1 chars

datareels[]coauthors[]platformUserId
stringoptional

Instagram numeric user id for the coauthor when present.

datareels[]coauthors[]verified
booleanoptional

Whether Instagram marks the coauthor as verified.

datareels[]coauthors[]avatarUrl
stringnullableoptional

Profile image URL for the coauthor. Instagram CDN URL when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset.

Pagination state for the current response.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/instagram/audio/1392969992841787/reels" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Reels for the requested Instagram audio.