Instagram Stories full API
Fetch a public Instagram account's currently live stories with media, type, dimensions, posting time, and 24-hour expiry by username.
Try it
Make your first request
{
"data": {
"items": [
{
"code": "a1b2c3d4",
"createdUtc": 12.5,
"expiresUtc": 12.5,
"height": 42,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"mediaType": 42,
"username": "alex_rivera",
"videoUrl": "https://example.com/page",
"width": 1024
}
]
},
"found": true
}interface InstagramStoriesFullResponse {
data: {
items: {
code?: string;
createdUtc?: number;
expiresUtc?: number;
height?: number;
id: string;
image?: string;
mediaType?: number;
username?: string;
videoUrl?: string;
width?: number;
}[];
} | null;
found: boolean;
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
Request, response, and price
Last verified 2026-09-17 · uptime and latency measured over 30dcurl -X POST https://api.getanyapi.com/v1/run/instagram.stories_full \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"natgeo"}'| Field | Type | Example value |
|---|---|---|
| Request body | ||
| username | string | "natgeo"Instagram username or handle without the @. |
| Response | ||
| data | object | Wrapper holding the story items array, or null when nothing was found. |
| data.items | object[] | Currently live story records for the requested account, with media, type, dimensions, posting time, and expiry. Populated whenever the provider has data for the entity. |
| data.items[].code | string | Instagram media shortcode. Populated whenever the provider has data for the entity. |
| data.items[].createdUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity. |
| data.items[].expiresUtc | number | Expiry UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity. |
| data.items[].height | integer | Media pixel height. Populated whenever the provider has data for the entity. |
| data.items[].id | string | Story identifier. Populated whenever the provider has data for the entity. |
| data.items[].image | string | Direct URL to the story image (highest resolution). Populated whenever the provider has data for the entity. |
| data.items[].mediaType | integer | Media type: 1 = image, 2 = video. Populated whenever the provider has data for the entity. |
| data.items[].username | string | Owner username. Populated whenever the provider has data for the entity. |
| data.items[].videoUrl | string | Direct URL to the story video, when the story is a video. Populated whenever the provider has data for the entity. |
| data.items[].width | integer | Media pixel width. Populated whenever the provider has data for the entity. |
| found | boolean | True when stories were found; false when the lookup returned nothing. |
| Price | ||
| Price per request | USD | $0.0024 |
| Price /1k req | USD | $2.40 |
FAQ
About the Instagram Stories full API
The AnyAPI Instagram Stories full API returns Instagram stories full data as normalized JSON from one POST call to /v1/run/instagram.stories_full. Fetch a public Instagram account's currently live stories with media, type, dimensions, posting time, and 24-hour expiry by username. AnyAPI returns one normalized schema whichever source serves it. It costs from $2.40 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Instagram stories full calls through AnyAPI succeeded, with a median response time of 3.3 seconds across 5 measured calls.