Instagram hub

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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.