Instagram Stories API Reference
Currently live stories for a public handle.
Maintained by the InScrape API team · Last reviewed 2026-09-19
GET /v1/instagram/stories1 credit per requestRequest examples
Choose your language
All examples call the same REST endpoint.
curl "https://api.inscrape.dev/v1/instagram/stories?handle=iamsydneythomas" \
-H "x-api-key: $INSCRAPE_KEY"Response examples
Explore the response
Switch tabs to inspect representative payloads.
{ "success": true, "credits_charged": 1, "credits_remaining": 843, "processing_time_ms": 1842, "requested_at": "2026-09-13T14:32:18Z", "query": { "username": "iamsydneythomas" }, "data": { "stories": [ { "id": "1234567890123456789_1751818088", "pk": "1234567890123456789", "mediaType": 1, "takenAt": "2026-09-27T01:52:37.000Z", "taken_at": 1790473957, "imageUrl": "https://cdn.example.com/stories/example-1.heic", "videoUrl": null, "width": 1440, "height": 2560, "original_width": 1440, "original_height": 2560, "videoDuration": 0, "has_audio": null, "number_of_qualities": null, "caption": null, "accessibility_caption": null, "link": null, "carousel_media_count": null, "carousel_media": null, "media_overlay_info": null, "story_music_stickers": null, "story_bloks_stickers": null, "story_link_stickers": null, "story_hashtags": null, "story_locations": null, "story_bloks_tappables": null, "story_feed_media": null, "text_post_share_to_ig_story_stickers": null, "story_countdowns": null, "story_questions": null, "story_sliders": null, "story_cta": null, "visual_comment_reply_sticker_info": null, "reel_media_background": null, "reshared_story_media_author": null, "sponsor_tags": null, "is_paid_partnership": false, "has_liked": false, "boosted_status": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas" } }, { "id": "1234567890123456790_1751818088", "pk": "1234567890123456790", "mediaType": 1, "takenAt": "2026-09-27T08:28:42.000Z", "taken_at": 1790497722, "imageUrl": "https://cdn.example.com/stories/example-2.heic", "videoUrl": null, "width": 1440, "height": 2560, "original_width": 1440, "original_height": 2560, "videoDuration": 0, "has_audio": null, "number_of_qualities": null, "caption": null, "accessibility_caption": null, "link": null, "carousel_media_count": null, "carousel_media": null, "media_overlay_info": null, "story_music_stickers": null, "story_bloks_stickers": [ { "x": 0.6110814, "y": 0.6400653, "width": 0.20270549, "height": 0.022913478, "rotation": 0, "bloks_sticker": { "sticker_data": { "ig_mention": { "full_name": "Instagram", "username": "instagram" } }, "id": "bloks_sticker_example" }, "id": "17901234567890123" } ], "story_link_stickers": null, "story_hashtags": null, "story_locations": null, "story_bloks_tappables": null, "story_feed_media": null, "text_post_share_to_ig_story_stickers": null, "story_countdowns": null, "story_questions": null, "story_sliders": null, "story_cta": null, "visual_comment_reply_sticker_info": null, "reel_media_background": null, "reshared_story_media_author": null, "sponsor_tags": null, "is_paid_partnership": false, "has_liked": false, "boosted_status": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas" } } ] }}Headers
| Name | Type | Required | Description |
|---|---|---|---|
| x-api-key | string | Yes | Your API key. All keys on a team share one credit pool. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| handle | string | Yes | Instagram username, without the @ |
Errors
| Status | Code | When |
|---|---|---|
400 | INVALID_PARAMS | A required parameter is missing or the wrong type. |
401 | INVALID_API_KEY | The key is unknown or has been revoked. |
402 | INSUFFICIENT_CREDITS | Balance is below this endpoint's cost. |
402 | KEY_LIMIT_REACHED | This API key has reached its credit limit. |
404 | ENDPOINT_NOT_FOUND | The API endpoint does not exist. Check the API URL and endpoint path. No credits are charged. |
500 | SCRAPE_FAILED | Upstream fetch failed after retries. |
503 | SERVICE_UNAVAILABLE | The API is temporarily unavailable. Check credits_charged; failures before resource use are free. |
504 | UPSTREAM_TIMEOUT | The upstream scraper timed out. |
Completed lookups return 200 and are charged at the endpoint rate, including private accounts and confirmed missing targets. Empty or missing targets return empty lists; an unavailable Profile is null. Documented empty next-page responses remain free. Check credits_charged on every response.