Skip to content

List Instagram posts

GET
/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.

username
string

Instagram username (required for first page).

Example
natgeo
user_id
string

Instagram user ID (required for pagination).

cursor
string

Pagination cursor from previous response.

first
integer
default: 12

Number of posts to return (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.