GET/v1/instagram/user/posts
Get user posts
Retrieve a paginated post feed. Pass `pagination.next_cursor` back as `cursor` for the next page.
`type` is one of `image`, `video`, `carousel`, or `reel`. Every post carries a `media[]` array — one entry per carousel item, one entry for a single image or video. `view_count` and `duration_seconds` appear only on videos and reels.
Parameters
| Name | Type | Description |
|---|---|---|
| usernamerequired | string | Instagram username e.g. instagram |
| cursor | string | Pagination cursor from the previous response (`pagination.next_cursor`) |
Request
Shell
curl -G "https://socialapi.airaa.xyz/v1/instagram/user/posts" \ -H "X-API-KEY: YOUR_KEY" \ -d "username=instagram" \ -d "cursor=cursor"
Try it
Live requestRelayed through this site — your key is never stored
X-API-KEY
usernamerequired
cursor
Response example
200 OKapplication/json
{
"user": {
"id": "25025320",
"username": "instagram",
"full_name": "Instagram",
"profile_url": "https://www.instagram.com/instagram/",
"profile_picture_url": "https://scontent-hel3-1.cdninstagram.com/v/t51.82787-19/550891366_18667771684001321.jpg",
"is_private": false,
"is_verified": true
},
"posts": [
{
"id": "3978138686356503349",
"shortcode": "Dc1MA7jhLs1",
"post_url": "https://www.instagram.com/reel/Dc1MA7jhLs1/",
"type": "reel",
"caption": "Side quest: unlocked 🐌",
"published_at": "2026-09-03T15:59:53.000Z",
"like_count": 466112,
"comment_count": 8112,
"view_count": 77565342,
"duration_seconds": 10.47,
"width": 720,
"height": 1280,
"media": [
{
"type": "video",
"url": "https://scontent-hel3-1.cdninstagram.com/o1/v/t2/f2/m86/AQOS0F94tlH8.mp4",
"thumbnail_url": "https://scontent-hel3-1.cdninstagram.com/v/t51.82787-15/791906484.jpg",
"width": 720,
"height": 1280,
"duration_seconds": 10.47
}
]
}
],
"pagination": {
"next_cursor": "QVFCUEFXbUFpR3ZhNzdYRVBQYkhYNDMycE9sSzR0eFpKOEEx",
"has_more": true
}
}Response codes
200Posts list
400Missing or invalid query parameter
401Missing or invalid `X-API-KEY` header
429Request quota exceeded — contact light@airaa.xyz to upgrade your plan
500Server misconfiguration — API key environment variable not set
502Upstream provider temporarily unavailable — please try again
504Request timed out — please try again
All error responses follow the shape
{ "error": "message" }