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.

Authorizations

• apiKeyHeader
• apiKeyQuery

Parameters

Query Parameters

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).

Responses

200

Paginated reels.

object

user_id

string

reels

Array<object>

object

id

string

shortcode

string

display_url

string

video_url

string

likes

integer

comments

integer

plays

integer

timestamp

integer

caption

string

pagination

object

has_next_page

boolean

continuation

string

Headers

X-Credits-Used

integer

X-Credits-Remaining

integer

401

Missing or invalid API key.

object

error

Error message.

string

Example

invalid or inactive api_key

402

Insufficient credits.

429

Rate limit exceeded.

object

error

Error message.

string

Example

invalid or inactive api_key

Headers

Retry-After

integer

Seconds to wait before retrying.