Posts, Reels, and Stories — with strict aspect ratios.
Instagram supports Posts, Reels, and Stories, each with strict aspect-ratio requirements. Feed posts enforce 4:5 (vertical) or 1:1 (square) for images, while Stories and Reels are 9:16 (vertical).
Supported Content Types
- Posts: 1–10 files (images, videos, or mixed carousels).
- Reels: Vertical video only.
- Stories: Images or videos that expire after 24 hours.
Quirks & Gotchas
Aspect Ratio Rules
Don't try to cheat. If you upload a 16:9 (landscape) video as a Reel, it might technically "work" but it will look terrible.
For non-standard content, two automatic correction options exist (Posts only, and mutually exclusive):
- Fit (
autoFitImage: true): adds padding without losing pixels. - Crop (
autoCropImage: true): center-crops to fit requirements.
Person Tags
- Reels / single-video: usernames only.
- Single images: each tag requires
xandycoordinates (0–1 range). - Carousels: per-item tags only, via
carouselItems[].tagged. - Carousel videos: person tags are not supported.
Trial Reels
Available for professional accounts (~1,000+ followers). Graduation strategies:
MANUAL: manually graduate from the Instagram app.SS_PERFORMANCE: automatic graduation based on performance.
Story Constraints
Stories do not support collaborators or locationId.
Text & Field Limits
| Field | Limit |
|---|---|
text | Max 2,000 characters |
collaborators | Max 3 usernames (30 chars each) |
tagged | Max 20 users per media |
carouselItems | Max 10 items |
locationId | Max 64 characters |
Post Options
Key fields in data.INSTAGRAM:
| Field | Description |
|---|---|
type | POST, REEL, or STORY. |
uploadIds | Media references (1–10 for Posts, 1 for Reels/Stories). |
thumbnailOffset | Video cover frame position, in milliseconds. |
shareToFeed | Reels only; controls feed appearance. |
collaborators | Up to 3 usernames. |
musicSoundInfo | Audio settings for Reels via Facebook Login. |
trialParams | Trial Reels with graduation strategies. |
Misc Endpoints
GET /misc/instagram/tags
Discovers business accounts by username. Requires a FACEBOOK login connection.
Returns exists: false for private or non-business accounts.
GET /misc/instagram/locations
Searches Facebook Pages with location data. Requires a FACEBOOK connection and
the pages_read_engagement permission.
Analytics
Refresh Rates
- Default: every 24 hours.
- Force refresh available (max Teams × 5 per day).
- Data retention: 30 days.
Profile Analytics (30-day rolling window)
Tracks impressions, unique reach, profile views, likes, comments, post count, followers, and following.
Post Analytics (lifetime snapshot)
Measures impressions, unique reach, video plays, likes, comments, shares (Reels only), and saves.
Raw Demographics Data
Includes follower demographics (country, city, gender, age) and engaged-audience demographics broken down by the same dimensions.