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

Paginated posts.

object
user_id
string
posts
Array<object>
object
id
string
shortcode
string
display_url
string
is_video
boolean
likes
integer
comments
integer
timestamp
integer
caption
string
pagination
object
has_next_page
boolean
end_cursor
string
X-Credits-Used
integer
X-Credits-Remaining
integer

Missing or invalid API key.

object
error

Error message.

string
Example
invalid or inactive api_key

Insufficient credits.

Rate limit exceeded.

object
error

Error message.

string
Example
invalid or inactive api_key
Retry-After
integer

Seconds to wait before retrying.