Social Fetch
Instagram

List Instagram profile reels

Get Reels from a specific Instagram profile.

Operation

GET/v1/instagram/profiles/{handle}/reels

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

handlestringrequired

Instagram handle whose reels should be listed.

min 1 chars · max 64 chars

cursorstring(query)

Opaque pagination cursor from a previous response (`data.page.nextCursor`).

min 1 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether reels could be listed for this handle: found (including empty pages), or not_found when the handle does not resolve or reels cannot be listed.

one of: found, not_found

datareels
arrayrequired

Instagram reels for the requested profile page when `lookupStatus` is `found`. Empty when `lookupStatus` is `not_found`, or when the profile has no reels in this page.

datareels[]id
stringrequired

Instagram media id for this reel.

min 1 chars

datareels[]shortcode
stringrequired

Public shortcode used in the Instagram reel URL.

min 1 chars

datareels[]caption
stringrequirednullable

Caption text when Instagram provides one.

datareels[]takenAt
integerrequired

When the reel was taken or posted (Unix epoch seconds).

datareels[]url
stringrequired

Canonical public Instagram URL for this reel.

min 1 chars

datareels[]displayUrl
string

Primary display image URL when available.

datareels[]thumbnailUrl
string

Thumbnail or cover image URL when available.

datareels[]videoUrl
string

Direct video URL when a playable URL is available.

datareels[]likeCount
integer

Like count when Instagram exposes it.

≥ 0

datareels[]commentCount
integer

Comment count when Instagram exposes it.

≥ 0

datareels[]playCount
integer

Play or view count when Instagram exposes it (Instagram-only views when distinguishable).

≥ 0

datareels[]dimensions
object

Width and height when available.

datareels[]dimensionswidth
integerrequired

Media width in pixels.

≥ 0

datareels[]dimensionsheight
integerrequired

Media height in pixels.

≥ 0

datareels[]owner
object

Reel owner metadata when Instagram exposes it on the media item.

datareels[]ownerplatformUserId
string

Instagram numeric user id for the reel owner when present.

datareels[]ownerhandle
string

Instagram username for the reel owner when present.

datareels[]ownerdisplayName
string

Display name for the reel owner when present.

datareels[]owneravatarUrl
string

Profile image URL for the reel owner when present.

datareels[]ownerverified
boolean

Whether Instagram marks the reel owner as verified.

datapage
objectrequired

Pagination state for the current response.

datapagenextCursor
stringrequirednullable

Cursor to pass as `cursor` in the next request when more reels are available.

datapagehasMore
booleanrequired

Whether another page of reels is available from Instagram.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Instagram reels for the requested profile page. Inspect `data.lookupStatus` to interpret empty `data.reels` and not-found outcomes.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page