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.
$2.20/1k req, pay per request, no subscription.
{"id":Â "3993371135160947333","username":Â "nba","mediaType":Â 2,"image":Â "https://scontent.cdninstagram.com/v/t51.71878-15/nba_story_frame.jpg?stp=dst-jpg&_nc_ht=scontent.cdninstagram.com&_nc_cat=1","videoUrl":Â "https://scontent.cdninstagram.com/o1/v/t2/f2/m78/nba_story.mp4?_nc_ht=scontent.cdninstagram.com&_nc_cat=110","width":Â 1080,"height":Â 1920,"durationSeconds":Â 17.466,... 13 more fields}
Pricing and providers
Instagram Stories full API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get Instagram stories full in one request
This sample shows 24 of 25 fields. See every field
{
"found": true,
"data": {
"items": [
{
"id": "3993371135160947333",
"username": "nba",
"mediaType": 2,
"image": "https://scontent.cdninstagram.com/v/t51.71878-15/nba_story_frame.jpg?stp=dst-jpg&_nc_ht=scontent.cdninstagram.com&_nc_cat=1",
"videoUrl": "https://scontent.cdninstagram.com/o1/v/t2/f2/m78/nba_story.mp4?_nc_ht=scontent.cdninstagram.com&_nc_cat=110",
"width": 1080,
"height": 1920,
"durationSeconds": 17.466,
"createdUtc": 1790266907,
"expiresUtc": 1790353307,
"code": "DdrTeO_kRKF",
"userId": "20824486",
"displayName": "NBA",
"avatarUrl": "https://scontent.cdninstagram.com/v/t51.82787-19/nba_profile.jpg?stp=dst-jpg&_nc_ht=scontent.cdninstagram.com&_nc_cat=1",
"verified": true,
"private": false,
"productType": "story",
"paidPartnership": true,
"soundTitle": "Original audio",
"soundAuthor": "footlocker",
"audioId": "28825397337055428"
},
{
"id": "3993398120334519850",
"username": "nba",
"mediaType": 1,
"image": "https://scontent.cdninstagram.com/v/t51.71878-15/nba_story_frame_2.jpg?stp=dst-jpg&_nc_ht=scontent.cdninstagram.com&_nc_cat=1",
"videoUrl": "",
"width": 1080,
"height": 1920,
"createdUtc": 1790270407,
"expiresUtc": 1790356807,
"code": "DdrZmK3kQ7p",
"userId": "20824486",
"displayName": "NBA",
"avatarUrl": "https://scontent.cdninstagram.com/v/t51.82787-19/nba_profile.jpg?stp=dst-jpg&_nc_ht=scontent.cdninstagram.com&_nc_cat=1",
"verified": true,
"private": false,
"productType": "story",
"paidPartnership": false
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- usernamestring
nba
Instagram username or handle without the @.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `soundTitle`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a story that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Response
JSON, one example value per field.
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.
- audioIdstringcan require
28825397337055428
Instagram audio id of the sound; pass it to instagram.audio_reels as audioId to list reels using it. Null when the story has no music sticker or this source does not report it.
- avatarUrlstring
https://scontent.cdninstagram.com/v/t51.82787-19/nba_profile.jpg?stp=dst-jpg&_nc_ht=scontent.cdninstagram.com&_nc_cat=1
Profile picture URL of the story owner.
- codestring
DdrTeO_kRKF
Instagram media shortcode. Populated whenever the provider has data for the entity.
- createdUtcnumber
1790266907
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.
- displayNamestring
NBA
Display name of the story owner.
- durationSecondsnumber
17.466
Video duration in seconds. Null on a photo story, or when this source does not report it.
- expiresUtcnumber
1790353307
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.
- heightinteger
1920
Media pixel height. Populated whenever the provider has data for the entity.
- idstring
3993371135160947333
Story identifier. Populated whenever the provider has data for the entity.
- imagestring
https://scontent.cdninstagram.com/v/t51.71878-15/nba_story_frame.jpg?stp=dst-jpg&_nc_ht=scontent.cdninstagram.com&_nc_cat=1
Direct URL to the story image (highest resolution). Populated whenever the provider has data for the entity.
- mediaTypeinteger
2
Media type: 1 = image, 2 = video. Populated whenever the provider has data for the entity.
- paidPartnershipboolean
true
True when the story is tagged as a paid partnership.
- privateboolean
false
True when the owner's account is private.
- productTypestring
story
Instagram product type of the media, for example story.
- soundAuthorstringcan require
footlocker
Credited author of the sound. Null when the story has no music sticker or this source does not report it.
- soundTitlestringcan require
Original audio
Name of the sound on the story's music sticker. "Original audio" means the creator's own audio rather than a licensed track. Null when the story has no music sticker or this source does not report it.
- userIdstring
20824486
Instagram user id of the story owner.
- usernamestring
nba
Owner username. Populated whenever the provider has data for the entity.
- verifiedboolean
true
True when the owner's account carries a verified badge.
- videoUrlstring
https://scontent.cdninstagram.com/o1/v/t2/f2/m78/nba_story.mp4?_nc_ht=scontent.cdninstagram.com&_nc_cat=110
Direct URL to the story video, when the story is a video. Populated whenever the provider has data for the entity.
- widthinteger
1080
Media pixel width. Populated whenever the provider has data for the entity.
- foundboolean
true
True when stories were found; false when the lookup returned nothing.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
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 routes each request across 2 sources and falls back automatically when one fails. It costs from $2.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 99.9% of Instagram stories full calls through AnyAPI succeeded, with a median response time of 1.2 seconds across 4,425 measured calls.
