Skip to main content
POST /v1/data/instagram/posts/run Pricing: $0.002 per post ($2.00 per 1,000). Pull a profile’s posts, reels, or tagged tab; look up specific post URLs; pull recent posts under a hashtag; or search Reels by keyword.

Ways to call it

  • Handle: set handles (optional: tab, maxResults, onlyPostsNewerThan)
  • Post URL: set postUrls
  • Hashtag: set hashtags (optional: maxResults, onlyPostsNewerThan)
  • Keyword (Reels): set query (optional: maxPages)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
Instagram username (e.g. natgeo) or profile URL to pull posts from.Format e.g. https://www.instagram.com/natgeo/.
string
default:"posts"
Which profile tab to pull: the posts grid (photos + videos), the Reels tab, or posts the profile is tagged in.Allowed values: posts (Posts tab), reels (Reels tab), tagged (Tagged tab).
string[]
Instagram post or reel URLs, one per line. Returns the full record for each.
string
Hashtag to pull recent posts from, without the # (e.g. travel).
string
Search keyword. Returns matching Reels from Instagram search.
integer
default:"3"
Keyword-search result pages to fetch (~10-12 reels per page, capped at 8).
integer
Number of posts to return in total. Use 0 for all.
date
Only get posts newer than this date (YYYY-MM-DD). Pinned posts may appear even if older.

Example

Response fields

Each row in data is one post, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For account-level data (bio, follower count, business info) use instagram/profiles; for the comments on a post use instagram/comments.