GET/v1/instagram/user/stories
Get user stories
Retrieve a user's currently active stories.
`type` is `image` or `video`; both resolve to a single `media_url`. `mentions[]` is present only when the story carries an account-mention sticker.
Parameters
| Name | Type | Description |
|---|---|---|
| username_or_urlrequired | string | Instagram username or profile URL e.g. instagram |
Request
Shell
curl -G "https://socialapi.airaa.xyz/v1/instagram/user/stories" \ -H "X-API-KEY: YOUR_KEY" \ -d "username_or_url=instagram"
Try it
Live requestRelayed through this site — your key is never stored
X-API-KEY
username_or_urlrequired
Response example
200 OKapplication/json
{
"user": {
"id": "25025320",
"username": "instagram",
"profile_url": "https://www.instagram.com/instagram/",
"full_name": "Instagram",
"profile_picture_url": "https://scontent-hel3-1.cdninstagram.com/v/t51.82787-19/550891366_18667771684001321.jpg",
"is_private": false,
"is_verified": true
},
"stories": [
{
"id": "3978141365058783467",
"shortcode": "Dc1Mn6Sncjr",
"story_url": "https://www.instagram.com/stories/instagram/3978141365058783467/",
"type": "video",
"published_at": "2026-09-03T16:03:42.000Z",
"expires_at": "2026-09-04T16:03:42.000Z",
"media_url": "https://scontent-hel3-1.cdninstagram.com/o1/v/t2/f2/m78/AQNl1m_uGI8W.mp4",
"width": 720,
"height": 1280,
"mentions": [
{
"id": "238683970",
"username": "isaacperrins",
"full_name": "IsaacPerrins",
"profile_url": "https://www.instagram.com/isaacperrins/",
"profile_picture_url": "https://scontent-hel3-1.cdninstagram.com/v/t51.2885-19/315107553.jpg"
}
]
}
]
}Response codes
200Active stories
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" }