Skip to content

List Instagram posts (POST)

POST
/v1/instagram-posts

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

Credits: 1 per request.

Accepts the same fields as JSON instead of query parameters.

object
username

Instagram username (required for first page).

string
user_id

Instagram user ID (required for pagination).

string
cursor

Pagination cursor from previous response.

string
first

Number of posts to return (default 12).

integer
default: 12

Extracted data.

object
user_id
string
posts
Array<object>
object
id
string
shortcode
string
display_url
string
is_video
boolean
likes
number
comments
number
timestamp
number
caption
string
pagination
object
has_next_page
boolean
end_cursor
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.