List Instagram profile reels
Get Reels from a specific Instagram profile.
Operation
/v1/instagram/profiles/{handle}/reelsHeaders
API key (`sfk_...`)
Parameters
Instagram handle whose reels should be listed.
min 1 chars · max 64 chars
Opaque pagination cursor from a previous response (`data.page.nextCursor`).
min 1 chars
Response fields
Endpoint-specific response payload.
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
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.
Instagram media id for this reel.
min 1 chars
Public shortcode used in the Instagram reel URL.
min 1 chars
Caption text when Instagram provides one.
When the reel was taken or posted (Unix epoch seconds).
Canonical public Instagram URL for this reel.
min 1 chars
Primary display image URL when available.
Thumbnail or cover image URL when available.
Direct video URL when a playable URL is available.
Like count when Instagram exposes it.
≥ 0
Comment count when Instagram exposes it.
≥ 0
Play or view count when Instagram exposes it (Instagram-only views when distinguishable).
≥ 0
Width and height when available.
Media width in pixels.
≥ 0
Media height in pixels.
≥ 0
Reel owner metadata when Instagram exposes it on the media item.
Instagram numeric user id for the reel owner when present.
Instagram username for the reel owner when present.
Display name for the reel owner when present.
Profile image URL for the reel owner when present.
Whether Instagram marks the reel owner as verified.
Pagination state for the current response.
Cursor to pass as `cursor` in the next request when more reels are available.
Whether another page of reels is available from Instagram.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
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