Skip to content

List Instagram reels

GET
/v1/instagram-reels

Paginate through a user’s reels. Use username for the first page and user_id + continuation for subsequent pages.

Credits: 1 per request.

username
string

Instagram username (required for first page).

Example
natgeo
user_id
string

Instagram user ID (required for pagination).

continuation
string

Pagination token from previous response.

page_size
integer
default: 12 <= 50

Number of reels to return (default 12, max 50).

Extracted data.

object
user_id
string
reels
Array<object>
object
id
string
shortcode
string
url
string
display_url
string
likes
number
comments
number
plays
number
counts_hidden
boolean
is_pinned
boolean
pagination
object
has_next_page
boolean
continuation
string
X-Credits-Used
integer

Credits consumed.

X-Credits-Remaining
integer

Remaining credit balance.

Missing or invalid API key.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

Insufficient unreserved credits.

object
error
required
string
Example
insufficient credits
required
required
integer
available
required
integer

Request, concurrency, or plan limit exceeded.

One of:
object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string
Retry-After
integer

Seconds to wait when supplied.