# Facebook Story Downloader (`codenest/facebook-story-downloader`) Actor Download high-quality Facebook Stories instantly with this powerful tool! Extract videos & images in multiple resolutions, get direct CDN links 🚀 and batch process multiple stories effortlessly! Perfect for archiving and content repurposing.🚀Facebook Story Downloader. - **URL**: https://apify.com/codenest/facebook-story-downloader.md - **Developed by:** [CodeNest](https://apify.com/codenest) (community) - **Categories:** Social media, Videos, Automation - **Stats:** 45 total users, 6 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event + usage 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 ## Facebook Story Downloader 📥 - Professional Facebook Story Extraction Tool **Effortlessly download Facebook Stories with our enterprise-grade powerful actor! This Apify actor enables you to batch download Stories content while preserving high video quality and supporting both single and multiple story modes.** *** ### 🎯 Overview Need to archive Facebook content or repurpose Stories? This **Facebook Story Downloader** delivers: - **Multiple Qualities**: 720p, 480p, and original resolutions - **Dual Format Support**: Video (MP4) and Image (JPG) downloads - **Batch Processing**: Handle multiple story URLs in one run - **Smart Detection**: Auto-recognition of single vs. multiple stories - **Direct CDN Access**: Bypass intermediaries for faster downloads Perfect for social media managers 📱, content agencies 🎬, and digital archivists 📊! ### ⚡ Core Capabilities/Key Features #### 📁 Media Options - **Quality Selection**: Multiple resolution options per story - **Format Support**: MP4 for videos, JPG for images - **Bulk Download**: Process multiple stories from single URLs - **Single Story Mode**: Direct download for individual stories #### 🏷️ Metadata Mastery - **Story Enumeration**: Numbered organization (Story No: 1, 2, 3...) - **Type Classification**: Clear video vs. image identification - **Quality Labels**: 720p, 480p, original designations - **Success Tracking**: Individual URL success status #### 🔧 Advanced Tech - **Direct Links**: Authentic Facebook CDN URLs - **Smart Parsing**: Handle both single and multi-story URLs - **Error Resilience**: Built-in failure handling - **Efficient Batching**: Optimized for multiple story downloads *** ### ⚙️ Input Configuration Just enter the Facebook Story URLs in the Input Section then click the "start" button and wait for the results. This **Facebook Story Downloader** supports both single stories and story collections: ```json { "story_urls": [ { "url": "https://www.facebook.com/stories/185179642966326/?view_single=false" }, { "url": "https://www.facebook.com/stories/185179642966326/UzpfSVNDOjExNzM0MjkxNTE2MTMzODI=/?view_single=1" } ] } ``` #### 📋 Input Specifications | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `story_urls` | Array | Yes | Facebook Story URLs to process | | `url` | String | Yes | Valid Facebook Story URL (stories/ format) | **URL Formats Supported by this Facebook Story Downloader:** - Multi-story collections: `https://www.facebook.com/stories/{ID}/?view_single=false` - Single stories: `https://www.facebook.com/stories/{ID}/{HASH}/?view_single=1` *** ### 📊 Output Structure You will see output like this comprehensive structure from the **Facebook Story Downloader**: ```json [ { "url": "https://www.facebook.com/stories/185179642966326/?view_single=false", "success": true, "stories": [ { "Story No": 1, "type": "video", "qualities": [ { "quality": "720p", "url": "https://video-lis1-1.xx.fbcdn.net/.../video.mp4", "format": "MP4" } ] } ], "total_story_count": 6, "metadata": { "uploader": {} } } ] ``` #### 📝 Output Field Documentation **Status & Metadata Section** | Field | Description | |-------|-------------| | `url` | Original Facebook Story URL processed | | `success` | Boolean indicating successful extraction | | `total_story_count` | Total number of stories found | | `single_story_mode` | Indicates if URL was single story mode | | `metadata.uploader` | Uploader information (expanded in future updates) | **Story Content Details** | Field | Description | |-------|-------------| | `Story No` | Sequential story number (1-based indexing) | | `type` | Media type: "video" or "image" | | `qualities` | Array of available quality options | **Quality Options** | Field | Description | |-------|-------------| | `quality` | Resolution/quality label (720p, 480p, original) | | `url` | Direct download URL from Facebook CDN | | `format` | File format (MP4, JPG) | *** ### 🎨 Quality Tiers Available This **Facebook Story Downloader** automatically detects and provides multiple quality options: #### 🎥 Video Stories 1. **High Definition** - 1280x720 (720p) with optimal compression 2. **Standard Definition** - 854x480 (480p) for bandwidth efficiency 3. **Progressive Formats** - Adaptive streaming support #### 🖼️ Image Stories 1. **Original Quality** - Maximum resolution as uploaded 2. **Optimized Delivery** - CDN-optimized for fast downloads Each quality tier is delivered with direct Facebook CDN links for maximum reliability. *** ### 🔬 Technical Features #### 🔄 Advanced Format Detection - Automatic video vs. image classification - Multiple quality level extraction - Direct CDN link resolution - Format compatibility verification #### 📈 Smart Processing - Batch URL processing optimization - Single/multi-story mode auto-detection - Parallel download capability - Memory-efficient streaming #### 🛡️ Reliability Features - Direct Facebook CDN access - Comprehensive error handling - URL validation and normalization - Rate limit awareness - Retry logic for transient failures *** ### 💼 Use Cases - **Social Media Managers** – Archive client Stories content - **Content Creators** – Repurpose Stories for other platforms - **Digital Archivists** – Preserve ephemeral social media content - **Researchers** – Study storytelling patterns and engagement - **Marketers** – Analyze competitor Story strategies - **App Developers** – Build Story-powered applications Using this **Facebook Story Downloader** ensures you have reliable access to Facebook Stories for all these applications. *** #### ✅ Why Choose Our Facebook Story Downloader? - **Professional Grade**: Enterprise-level reliability and performance - **User-Friendly**: Simple interface requiring only story URLs - **Comprehensive**: Handles both single and multiple stories - **Direct Access**: Uses official Facebook CDN links - **Regular Updates**: Maintained for Facebook API changes - **Batch Processing**: Efficient multi-story handling This **Facebook Story Downloader** is designed to be the most reliable tool for Facebook Story extraction on Apify. *** #### ⚠️ Limitations - Only works with public Facebook Stories - May be subject to Facebook's rate limiting - Requires valid story URLs with proper permissions - Download availability depends on Facebook's content policies ### 🔗🛠 Related Actors (Full Content Scraping Suite) Explore our full scraping suite for enhanced social media scraping: #### Zillow Specialized Actors: - [Zillow Agent Profile Scraper](https://apify.com/codenest/zillow-agent-profile-scraper) - [Zillow Property & Apartment Scraper Pro](https://apify.com/codenest/zillow-property-apartment-scraper-pro) - [Zillow Property & Apartment Scraper](https://apify.com/codenest/zillow-property-apartment-scraper) #### 📘 Facebook Scrapers: - [Facebook Reels Downloader](https://apify.com/codenest/facebook-reels-downloader) #### 🎥 YouTube Scrapers: - [YouTube Video Scraper](https://apify.com/codenest/youtube-video-scraper) - [YouTube Video Transcript Scraper](https://apify.com/codenest/youtube-video-transcript-scraper) - [YouTube Video Extractor](https://apify.com/codenest/youtube-video-extractor) *** ### 📧 Need Customization? Want \*higher resolutions, \*\*automated scheduling, or \**metadata enhancements* for this **Facebook Story Downloader**? ✉ Email ** for tailored solutions! *** *Note: This **Facebook Story Downloader** is designed for legitimate content archiving and research purposes. Always respect copyright and terms of service when downloading content.* # Actor input Schema ## `story_urls` (type: `array`): A list of public Facebook Stories URLs. Each item can be a string URL or an object with {"url": "https://..."}. ## `language` (type: `string`): Language code for the API (default: en) ## `delayBetweenRequests` (type: `number`): Delay in seconds between API requests to avoid rate limiting (default: 5) ## `maxRetries` (type: `number`): Maximum number of retries for rate-limited requests (default: 3) ## `proxy` (type: `object`): Proxy settings for the actor. Default uses US Residential proxies. ## Actor input object example ```json { "story_urls": [ { "url": "https://www.facebook.com/stories/171905157633541/UzpfSVNDOjEzMTgzNjY0NzM2ODc5MDg=/" } ], "language": "en", "delayBetweenRequests": 5, "maxRetries": 3, "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 = { "story_urls": [ { "url": "https://www.facebook.com/stories/171905157633541/UzpfSVNDOjEzMTgzNjY0NzM2ODc5MDg=/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("codenest/facebook-story-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 = { "story_urls": [{ "url": "https://www.facebook.com/stories/171905157633541/UzpfSVNDOjEzMTgzNjY0NzM2ODc5MDg=/" }] } # Run the Actor and wait for it to finish run = client.actor("codenest/facebook-story-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 '{ "story_urls": [ { "url": "https://www.facebook.com/stories/171905157633541/UzpfSVNDOjEzMTgzNjY0NzM2ODc5MDg=/" } ] }' | apify call codenest/facebook-story-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=codenest/facebook-story-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/Of4W4BioHZO1cehJO/builds/xkv35FC0TmxlY0l4J/openapi.json