Skip to main content
GET
User Reels
Cost: 1 credit per successful request. Errors and cache hits (cache_max_age) are free.
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
Prompt

Authorizations

x-api-key
string
header
required

Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.

Query Parameters

userId
string

The Instagram user id (numeric pk), e.g. 787132. Pass this or handle.

handle
string

The Instagram username, e.g. natgeo (an @handle or profile URL also works). Pass this or userId.

cursor
string

The cursor from a previous response (same account) to fetch the next page. Omit for the first page.

cache_max_age
enum<string>

Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.

Available options:
1d,
3d,
7d,
14d,
30d

Response

A page of Reels.

data
object
required
meta
object
required

requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt).