GET/v1/instagram/user/reels
Get user reels
Retrieve reels with play counts and engagement data. Each entry in `items` wraps the reel under `media` and adds `url` + `profile_url`. Pass `pagination_info.cursor` back as `cursor` for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| usernamerequired | string | Instagram username e.g. instagram |
| cursor | string | Pagination cursor from previous response (`pagination_info.cursor`) |
Request
Shell
curl -G "https://social-api.airaa.xyz/v1/instagram/user/reels" \ -H "X-API-KEY: YOUR_KEY" \ -d "username=instagram" \ -d "cursor=cursor"
Try it
Live requestRuns against the real API
X-API-KEY
usernamerequired
cursor
Response example
200 OKapplication/json
{
"items": [
{
"media": {
"pk": "3856265417640109548",
"id": "3856265417640109548_1334850329",
"code": "DWENPdKD-Xs",
"media_type": 2,
"product_type": "clips",
"play_count": 5145,
"like_count": 101,
"comment_count": 4,
"taken_at": 1773924550,
"caption": {
"text": "Traveling with 2 kids under 4 …"
},
"image_versions2": {
"candidates": [
{
"url": "https://scontent.cdninstagram.com/v/...",
"width": 720,
"height": 1280
}
]
}
},
"url": "https://instagram.com/reel/DWENPdKD-Xs",
"profile_url": "https://instagram.com/wherevermyheartgoes"
}
],
"pagination_info": {
"cursor": "QVFEMlREbkt3TXVLcFhEUmNXTEp6TXQx...",
"has_more": true
},
"profile_url": "https://instagram.com/wherevermyheartgoes",
"status": "ok"
}Response codes
200Reels 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
502Airaa service temporarily unavailable — please try again
504Request timed out — please try again
All error responses follow the shape
{ "error": "message" }