List Instagram profile reels
Get Reels from a specific Instagram profile.
Use `data.lookupStatus` for the domain outcome; call `GET /v1/instagram/profiles/{handle}` when you need full profile cards and related fields.
When `lookupStatus` is `found`, an empty `data.reels` page with `hasMore: false` can mean a public profile with no reels in range. When `lookupStatus` is `not_found`, reels will be empty by design.
Headers
Get your API keyAPI key (`sfk_...`)
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
Endpoint-specific response payload.
Whether reels could be listed for this handle.
one of: found, not_found
Instagram reels for the requested profile 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
curl "https://api.socialfetch.dev/v1/instagram/profiles/charlidamelio/reels" \
-H "x-api-key: YOUR_API_KEY"Responses
Instagram reels for the requested profile page. Inspect `data.lookupStatus` to interpret empty `data.reels` and not-found outcomes.