> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/instagram/v2-instagram-stories-storyid>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/instagram/v2-instagram-stories-storyid.mdx>

---

# 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}` 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`.

## Request

- **Endpoint:** `GET /v2/instagram/stories/{storyId}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by story id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v2/instagram/stories/storyid/get)
- **Platform page:** [/platforms/instagram](https://www.socialfetch.dev/platforms/instagram)

## 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.
