GET/v1/instagram/user/stories
Get user stories
Retrieve a user's active stories. Stories are returned as the `reel.items` array (each item enriched with `url` + `profile_url`); the response is an object, not a bare array. When the user has no active stories, the response is instead `{ status: "ok", message: "Stories not found", profile_url }`.
Parameters
| Name | Type | Description |
|---|---|---|
| username_or_urlrequired | string | — e.g. instagram |
Request
Shell
curl -G "https://social-api.airaa.xyz/v1/instagram/user/stories" \ -H "X-API-KEY: YOUR_KEY" \ -d "username_or_url=instagram"
Try it
Live requestRuns against the real API
X-API-KEY
username_or_urlrequired
Response example
200 OKapplication/json
{
"broadcast": null,
"reel": {
"id": "268083957",
"user": {
"pk": 268083957,
"username": "kritikachoudhary__",
"full_name": "Kritika Choudhary☀️"
},
"media_count": 5,
"expiring_at": 1782883581,
"reel_type": "user_reel",
"items": [
{
"pk": "3930710114835326550",
"id": "3930710114835326550_268083957",
"code": "DaMsAYNy2ZW",
"media_type": 1,
"taken_at": 1782797181,
"expiring_at": 1782883581,
"original_width": 1179,
"original_height": 2096,
"image_versions2": {
"candidates": [
{
"url": "https://scontent.cdninstagram.com/v/...",
"width": 640,
"height": 1137
}
]
},
"url": "https://www.instagram.com/stories/kritikachoudhary__/3930710114835326550/",
"profile_url": "https://instagram.com/kritikachoudhary__"
}
]
},
"unviewable_authors_info": {},
"status": "ok",
"profile_url": "https://instagram.com/kritikachoudhary__"
}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
502Airaa service temporarily unavailable — please try again
504Request timed out — please try again
All error responses follow the shape
{ "error": "message" }