GET/v1/instagram/user/stories
Get user stories
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
[
{
"id": "3875322197246433847_25025320",
"pk": "3875322197246433847",
"code": "DXH6QGND1o3",
"media_type": 2,
"taken_at": 1776194408,
"expiring_at": 1776280808,
"has_audio": true,
"video_duration": 21.5,
"original_width": 1080,
"original_height": 1920,
"image_versions2": {
"candidates": [
{
"url": "https://scontent.cdninstagram.com/v/...",
"width": 640,
"height": 1136
}
]
},
"video_versions": [
{
"url": "https://scontent.cdninstagram.com/o1/v/...",
"width": 720,
"height": 1280
}
]
}
]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" }