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 underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Instagram username (e.g. natgeo) or profile URL to pull posts from.Format e.g.
https://www.instagram.com/natgeo/.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).Example
Response fields
Each row indata is one post, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For account-level data (bio, follower count, business info) useinstagram/profiles; for the comments on a post use instagram/comments.