# Instagram Stories Downloader (`kingscraper/instagram-stories-downloader`) Actor Get video URL, metadata (likes/comments/uploader), thumbnail, and multiple quality formats (1080p,720p,audio and video) from Instagram Stories. Batch download with engagement analytics. - **URL**: https://apify.com/kingscraper/instagram-stories-downloader.md - **Developed by:** [King Scraper](https://apify.com/kingscraper) (community) - **Categories:** Social media, Videos, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 scraped videos This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 📸 Instagram Stories Downloader - Ultimate Story Saving & Archiving Tool **Effortlessly download and preserve Instagram Stories with our powerful **Instagram Stories Downloader**! This Apify actor enables you to batch download Stories content while preserving high video quality, comprehensive engagement metrics, and direct CDN access.** *** ### 📌 Overview Need to archive disappearing Instagram Stories or analyze content performance? This **Instagram Stories Downloader** delivers: - 🔄 **Batch Processing**: Download multiple Stories in one run - 📊 **Engagement Analytics**: Extract likes, comments, and viral metrics - 🎵 **Audio Separation**: Get standalone audio tracks from Stories - 🖼️ **High-Res Thumbnails**: Preserve cover images with metadata - 🌐 **Proxy-Ready**: Bypass geo/IP restrictions seamlessly Perfect for social media managers 📈, content archivists 🗄️, marketing analysts 📊, and digital agencies 🎯! *** ### ⭐ Key Features of Our Instagram Stories Downloader #### 🎥 Media Extraction Capabilities - **Multiple Format Support**: MP4 video + M4A audio separation - **Quality Tiers**: 1080x1920 (Full HD), 720x1280 (HD), 640x1136 (Standard) - **Smart Fallback**: Auto-selects best available resolution - **Bulk Mode**: Process 100+ Story URLs per run #### 📈 Story Analytics & Metadata - **Creator Intelligence**: Uploader name, handle, and channel ID - **Viral Metrics**: Like counts, comment volumes, engagement rates - **Temporal Data**: Upload date (YYYYMMDD), Unix timestamp, duration (seconds) - **Content Analysis**: Hashtags, mentions, and description extraction #### 🔧 Advanced Technical Features - **CDN-Level Access**: Direct download URLs from Instagram's servers - **Audio/Video Splitting**: Separate tracks for editing workflows - **Multi-Quality Dashboard**: Available formats with resolution specs - **Apify Storage Ready**: Encrypted download links with toggle option *** ### 📝 Input Configuration Using this **Instagram Stories Downloader** is simple - just provide your Story URLs in JSON format: ```json { "reel_urls": [ { "url": "https://www.instagram.com/reel/DWqjm_VD4qU/?utm_source=ig_web_copy_link&igsh=NTc4MTIwNjQ2YQ==" }, { "url": "https://www.instagram.com/reel/DWTF_XqkR-w/?utm_source=ig_web_copy_link&igsh=NTc4MTIwNjQ2YQ==" } ] } ``` #### 📋 Input Specifications | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `reel_urls` | Array | ✅ Yes | Instagram Story/Reel URLs to process | | `url` | String | ✅ Yes | Valid Instagram URL (reel/ or stories/ format) | | `method` | String | ❌ No | HTTP method (GET recommended, optional) | *** ### 📤 Output Structure Your **Instagram Stories Downloader** produces comprehensive JSON output for each processed Story: ```json [ { "input_url": "https://www.instagram.com/reel/DWqjm_VD4qU/...", "canonical_url": "https://www.instagram.com/reel/DWqjm_VD4qU/", "shortcode": "DWqjm_VD4qU", "metadata": { "download_url": "https://scontent.cdninstagram.com/.../video.mp4", "has_sound": true, "id": "DWqjm_VD4qU", "title": "Video by itsme_raiihana", "description": "Your mom cut u a fruit 🍋‍🟩 #fruit #funny #viral", "duration": 20.48, "like_count": 563806, "comment_count": 3070, "upload_date": "20260403", "uploader": "Raihana Islam", "uploader_id": "75483500989", "channel": "itsme_raiihana", "thumbnail": "https://scontent.cdninstagram.com/.../thumbnail.jpg", "width": 1080, "height": 1920, "ext": "mp4", "available_formats": [...] } } ] ``` #### 📊 Output Field Documentation **Core Story Information** | Field | Description | |-------|-------------| | `shortcode` | Unique Instagram identifier for the Story | | `canonical_url` | Clean URL without tracking parameters | | `title` | Auto-generated title with creator name | | `description` | Caption with hashtags and mentions | **Creator & Engagement Metrics** | Field | Description | |-------|-------------| | `uploader` | Content creator's display name | | `channel` | Instagram handle/username | | `uploader_id` | Unique numeric user identifier | | `like_count` | Total likes (563K+ example) | | `comment_count` | User engagement volume | | `upload_date` | Publication date in YYYYMMDD format | | `timestamp` | Unix epoch timestamp | | `duration` | Story length in seconds (decimal precision) | **Media Assets** | Field | Description | |-------|-------------| | `download_url` | Primary video download URL (CDN direct) | | `thumbnail` | High-quality preview image URL | | `width` | Horizontal resolution in pixels | | `height` | Vertical resolution in pixels | | `ext` | Container format (mp4, m4a) | | `has_sound` | Boolean audio availability indicator | #### 🎬 Available Formats Array Each Story includes multiple quality options through the `available_formats` array: | Field | Description | |-------|-------------| | `format_id` | Unique identifier (dash-xxx or numeric) | | `resolution` | Video dimensions (e.g., "1080x1920") | | `type` | Content type (video\_only, audio\_only, video+audio) | | `has_sound` | Audio track presence | | `url` | Direct download URL for specific format | *** ### 🎯 Quality Tiers Available Your **Instagram Stories Downloader** automatically detects and provides: 1. **📱 Full HD (1080x1920)** - Maximum quality for professional editing 2. **💻 HD Ready (720x1280)** - Standard high definition 3. **📲 Mobile Optimized (640x1136)** - Bandwidth-efficient option 4. **🎵 Audio Only (M4A)** - Separate audio track extraction 5. **🔊 Video Only (No Audio)** - Silent visual track Each format includes technical specifications (codec, bitrate, filesize) for production workflows. *** ### 💼 Use Cases for Instagram Stories Downloader - **🏢 Brand Archivists** – Preserve disappearing Stories for compliance - **📈 Social Media Analysts** – Track viral metrics and engagement trends - **🎨 Content Creators** – Repurpose Stories for other platforms - **🔍 Competitive Intelligence** – Monitor competitor Story strategies - **📚 Educational Researchers** – Study ephemeral content patterns - **🎬 Video Editors** – Access raw video/audio tracks for remixing - **🤖 AI Training Teams** – Build datasets with authentic social content *** ### 🚀 Why Choose This Instagram Stories Downloader? - **⚡ Blazing Fast** – Optimized CDN-level downloads - **🔒 Privacy-Focused** – No login required for public Stories - **📊 Data-Rich** – Get engagement metrics other tools miss - **🔄 Regular Updates** – Maintained for Instagram API changes - **💸 Cost-Effective** – Batch processing reduces compute time - **🎯 Precision Extraction** – Handles tracking parameters automatically - **🌍 Global Access** – Proxy support for international content *** ### ⚠️ Limitations - Only works with **public Instagram Stories** and Reels - Private account content requires authentication (not supported) - Rate limits may apply based on Instagram's restrictions - Deleted Stories cannot be recovered after 24-hour expiry - Like count may show -1 for age-restricted or hidden content *** ### 🔗 Related Actors in Our Social Media Suite #### 🎥 **Linkedin Tools** - [LinkedIn Video Downloader](https://apify.com/kingscraper/youtube-video-downloader) #### 🎥 **YouTube Tools** - [YouTube Video Downloader](https://apify.com/kingscraper/youtube-video-downloader) - [YouTube Shorts Downloader](https://apify.com/kingscraper/youtube-shorts-downloader) - [YouTube Mp3/Thumbnail & Audio Scraper](https://apify.com/kingscraper/youtube-mp3-thumbnail-audio-scraper) - [Youtube Video and MP3 Downloader](https://apify.com/kingscraper/youtube-video-and-mp3-downloader) #### 📘 **Snapchat Tools** - [Snapchat Story Downloader](https://apify.com/kingscraper/snapchat-story-downloader) - [Snapchat Spotlight Downloader](https://apify.com/kingscraper/snapchat-spotlight-downloader) #### 📘 **Facebook Scraper Tools** - [Facebook Post Scraper](https://apify.com/kingscraper/facebook-post-scraper) - [Facebook Reels Downloader](https://apify.com/kingscraper/facebook-reels-downloader) - [Facebook Video Post Downloader](https://apify.com/kingscraper/facebook-video-post-downloader) - [Facebook Reels And Thumbnail Downloader](https://apify.com/kingscraper/facebook-reels-and-thumbnail-downloader) #### 📘 **Instagram Scraper Tools** - [Instagram Reels Scraper](https://apify.com/kingscraper/instagram-reels-scraper) - [Instagram Photo Scraper](https://apify.com/kingscraper/instagram-photo-scraper) - [Instagram Video Downloader](https://apify.com/kingscraper/instagram-video-downloader) #### 📘 **Pinterest Scraper Tools** - [Pinterest Video and Image Downloader](https://apify.com/kingscraper/pinterest-video-and-image-downloader) #### 📘 **TikTok Scraper Tools** - [TikTok Thumbnail & Audio Scraper](https://apify.com/kingscraper/tiktok-thumbnail-audio-scraper) - [Tiktok Video And Thumbnail Downloader](https://apify.com/kingscraper/tiktok-video-and-thumbnail-downloader) *** ### 📧 Need Customization for Your Instagram Stories Downloader? Want *higher resolutions*, *API integration*, *automated scheduling*, or *custom output formats*? ✉ **Email**: for tailored enterprise solutions! *** **⭐ Pro Tip**: This **Instagram Stories Downloader** works best when you provide clean URLs without tracking parameters (utm\_source, igsh), though it automatically handles them via canonical URL extraction! *** # Actor input Schema ## `reel_urls` (type: `array`): A list of public Instagram Reel URLs to scrape. Each item can be a plain string URL or an object with {"url": "https://..."}. ## `proxy` (type: `object`): Apify proxy settings. Residential proxies are enabled by default to avoid Instagram rate-limits. ## Actor input object example ```json { "reel_urls": [ { "url": "https://www.instagram.com/reel/DVfAlwnDSjl/?utm_source=ig_web_copy_link" } ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "reel_urls": [ { "url": "https://www.instagram.com/reel/DVfAlwnDSjl/?utm_source=ig_web_copy_link" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("kingscraper/instagram-stories-downloader").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "reel_urls": [{ "url": "https://www.instagram.com/reel/DVfAlwnDSjl/?utm_source=ig_web_copy_link" }] } # Run the Actor and wait for it to finish run = client.actor("kingscraper/instagram-stories-downloader").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "reel_urls": [ { "url": "https://www.instagram.com/reel/DVfAlwnDSjl/?utm_source=ig_web_copy_link" } ] }' | apify call kingscraper/instagram-stories-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kingscraper/instagram-stories-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/xzYOqBkeaZqTzJLsU/builds/Z49cUjhsAIUvH6eDk/openapi.json