List Instagram reels (POST)
POST /v1/instagram-reels
POST
/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.
Accepts the same fields as JSON instead of query parameters.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
username
Instagram username (required for first page).
string
user_id
Instagram user ID (required for pagination).
string
continuation
Pagination token from previous response.
string
page_size
Number of reels to return (default 12, max 50).
integer
Responses
Section titled “ Responses ”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
Headers
Section titled “Headers ” 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.
Headers
Section titled “Headers ” Retry-After
integer
Seconds to wait when supplied.