API referenceInstagram
Stories
The stories a profile currently has live.
Returns the stories a profile has live right now. Stories expire after 24 hours, so an empty list means the account has nothing live at the moment rather than that the account could not be read.
Instagram publishes a post's view count only for video. Photo and carousel posts return null rather than zero, because zero would be a claim we cannot support.
Share and save counts are not public on Instagram, so they are not returned.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/instagram_story" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.instagram.com/stories/martingarrix/" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "message": "Successfully scraped active stories", "profile_id": "30464350", "status": "ok", "stories": [ { "id": "3969682528270419691", "media_category": "image", "media_sources": [ { "resolution": "1320x2346", "type": "image", "url": "https://scontent-ord5-1.cdninstagram.com/v/t51.82787-15/781804799_18635232505000351_8711828663842843825_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzk2OTY4MjUyODI3MDQxOTY5MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&_nc_aid=0&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnhwaWRzLjEzMjAuc2RyLnJlZ3VsYXJfcGhvdG8uQzMifQ%3D%3D&_nc_ohc… (+258 chars)" }, { "resolution": "1080x1919", "type": "image", "url": "https://scontent-ord5-1.cdninstagram.com/v/t51.82787-15/781804799_18635232505000351_8711828663842843825_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_cat=1&ig_cache_key=Mzk2OTY4MjUyODI3MDQxOTY5MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&_nc_aid=0&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnhwaWRzLjEzMjAuc2RyLnJlZ3VsYXJfcGhvdG8uQzMifQ%3D… (+269 chars)" }, "… 12 more items in the full response" ], "original_height": 2346, "original_width": 1320, "taken_at": 1787443055, "video_duration_seconds": null }, { "id": "3969685087263939738", "media_category": "video", "media_sources": [ { "resolution": "640x1136", "type": "image", "url": "https://scontent-ord5-1.cdninstagram.com/v/t51.71878-15/780181263_1020083381007912_13748228522196261_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=1&ig_cache_key=Mzk2OTY4NTA4NzI2MzkzOTczOA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnhwaWRzLjY0MC5zZHIudmlkZW9fZGVmYXVsdF9jb3Zlcl9mcmFtZS5DMyJ9&_nc_ohc=Rd76… (+253 chars)" }, { "resolution": "480x852", "type": "image", "url": "https://scontent-ord5-1.cdninstagram.com/v/t51.71878-15/780181263_1020083381007912_13748228522196261_n.jpg?stp=dst-jpg_e15_p480x480_tt6&_nc_cat=1&ig_cache_key=Mzk2OTY4NTA4NzI2MzkzOTczOA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnhwaWRzLjY0MC5zZHIudmlkZW9fZGVmYXVsdF9jb3Zlcl9mcmFtZS5DMyJ9&_nc… (+262 chars)" }, "… 8 more items in the full response" ], "original_height": 1920, "original_width": 1080, "taken_at": 1787443355, "video_duration_seconds": 28.791 } ], "success": true, "username": "martingarrix" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "instagram_story", "billable": true, "duration_ms": 8724 }}