Instagram Story API
Get one live story by its id or its instagram.com/stories link, with its files and stickers.
GET /v2/instagram/stories/{storyId}1 credit Failed requests are free
About this endpoint
GET /v2/instagram/stories/{storyId} takes a story id, or the story's instagram.com/stories/{handle}/{id} URL (URL-encode it in the path). It returns the story as the media object the profile stories list uses: kind: story, the image or video URLs, the owner, and under story its expiry, link stickers, mentions and any post it shares. Read data.lookupStatus first (found, private or not_found), then data.media.
Stories last 24 hours: after that, and for an id that never existed, the answer is not_found with media: null. A story kept only in a highlight is read with the highlight endpoint instead. Each lookup costs 1 credit, found or not. meta.version is v2.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Instagram Story API FAQ
How do I get one Instagram story?
Call GET /v2/instagram/stories/{storyId} with your Social Fetch API key (x-api-key) and the story id, or the story URL encoded in the path. Read data.lookupStatus, then data.media.
How much does the Instagram story API cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Where do I find a story id?
In the id of each story from GET /v2/instagram/profiles/{profile}/stories, or in a story link: instagram.com/stories/{handle}/{id}.
Why is a story not_found?
It has expired (stories last 24 hours) or never existed. Stories saved to a highlight are read with GET /v2/instagram/highlights/{highlightId}.
Is the story the same object as in the stories list?
Yes. It is the shared v2 media object with kind: story, the same as each item of the profile stories list.
Other Instagram endpoints
- ProfileGET /v2/instagram/profiles/{profile}
- Profile mediaGET /v2/instagram/profiles/{profile}/media
- Profile highlightsGET /v2/instagram/profiles/{profile}/highlights
- Profile storiesGET /v2/instagram/profiles/{profile}/stories
- Similar profilesGET /v2/instagram/profiles/{profile}/similar
- Profile followingGET /v2/instagram/profiles/{profile}/following
- Profile followersGET /v2/instagram/profiles/{profile}/followers
- Search profile followersGET /v2/instagram/profiles/{profile}/followers/search