Insight Social
GET /v1/instagram/story/downloadbeta

Instagram Story Download API

Returns the full resolution image or video URLs and metadata for one specific story.

50 credits a call · single call · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/instagram/story/download?user_id=<user_id>&story_id=<story_id>" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "instagram",
"endpoint": "/v1/instagram/story/download",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it after stories: pass the author's user_id plus the story_id it returned to pull that one story's media.

Parameters

Query parameters for GET /v1/instagram/story/download. Send your key in the x-api-key header.

NameRequiredDescription
user_idYesInstagram numeric user ID of the story's author.
story_idYesID of the individual story to download.
safe_urlNoWhen true, returns URL-safe media links suitable for embedding.

Response

This endpoint returns the platform's own fields in data, in snake_case, rather than a unified post or profile. The reference page lists them.

Every field, error and example is in the Instagram Story Download API reference.

How much does the Instagram Story Download API cost?

50 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Instagram Story Download API: frequently asked questions

Send GET /v1/instagram/story/download with the user_id and story_id parameters and your key in the x-api-key header. Returns the full resolution image or video URLs and metadata for one specific story.