# Facebook Story Scraper (`codenest/facebook-story-scraper`) Actor

Input Facebook story URLs (single or story tray). Outputs all stories with story IDs, media type, thumbnails, multi-quality video downloads (720p/480p MP4), original images, Reel download URLs, and uploader name, ID, and profile URL.

- **URL**: https://apify.com/codenest/facebook-story-scraper.md
- **Developed by:** [CodeNest](https://apify.com/codenest) (community)
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 downloads

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 📖 Facebook Story Scraper - Ultimate Story Downloader & Data Extractor

**Effortlessly download Facebook Stories with our powerful **Facebook Story Scraper**! This Apify actor enables bulk story extraction, high-quality video/image downloads, and complete metadata collection from any public Facebook story URL.**

***

### 📋 Overview

Need to archive Facebook Stories before they disappear? This **Facebook Story Scraper** delivers:

- 📥 **Video & Image Downloads** - Extract both story types seamlessly
- 🎥 **Multiple Video Qualities** - 720p and 480p MP4 options
- 🔗 **Direct Download URLs** - CDN links for instant downloads
- 👤 **Uploader Information** - Name, ID, and profile URL
- 📊 **Complete Metadata** - Story IDs, timestamps, and counts
- 📱 **Bulk Story Extraction** - Process multiple story URLs at once

Perfect for social media managers 📈, content archivists 📚, marketers 🎯, and researchers 🔬!

***

### ⭐ Core Capabilities of Facebook Story Scraper

#### 🎬 Story Media Extraction

- **Video Story Downloads** - Multiple quality options (720p, 480p)
- **Image Story Downloads** - Original high-resolution images
- **Thumbnail Extraction** - High-quality preview images
- **Direct CDN URLs** - Instant download links

#### 📊 Complete Story Metadata

- **Story Identification** - Unique story IDs
- **Sequential Numbering** - "Story No" for ordered extraction
- **Media Type Detection** - Video or image classification
- **Format Information** - MP4, JPG format details

#### 👤 Uploader Intelligence

- **Uploader Name** - Display name of story creator
- **Uploader ID** - Unique Facebook profile identifier
- **Profile URL** - Direct link to uploader's profile
- **Story ID** - Unique story identifier

#### 📁 Batch Processing

- **Multiple Story URLs** - Process several stories in one run
- **Bucket Count Support** - Extract full story trays
- **Single Story Mode** - Individual story extraction
- **Success Tracking** - Per-URL success status

***

### ⚙️ Input Configuration

Simply enter your Facebook story URLs and click "Start". Input looks like this:

```json
{
  "story_urls": [
    {
      "url": "https://web.facebook.com/stories/172339350930615/UzpfSVNDOjE3NjQzMjkxNjgxNTY1Mjk=/?bucket_count=9&source=story_tray"
    },
    {
      "url": "https://web.facebook.com/stories/171537161002174/UzpfSVNDOjE5MDgwMzA0OTA1NTUyMTg=/?view_single=1"
    }
  ]
}
```

#### 📝 Input Specifications

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `story_urls` | Array | ✅ Yes | - | Facebook story URLs to scrape |
| `story_urls[].url` | String | ✅ Yes | - | Valid Facebook story URL |

#### 📌 URL Format Options

| Format | Example | Description |
|--------|---------|-------------|
| Story Tray | `?bucket_count=9&source=story_tray` | Extracts multiple stories |
| Single Story | `?view_single=1` | Extracts single story |

***

### 📤 Output Structure

Your **Facebook Story Scraper** produces comprehensive story data with download URLs:

```json
[
  {
    "url": "https://web.facebook.com/stories/172339350930615/...",
    "success": true,
    "stories": [
      {
        "Story No": 1,
        "story_id": "2447753995633615",
        "type": "video",
        "thumbnail": "https://scontent-hkg4-2.xx.fbcdn.net/...",
        "qualities": [
          {
            "quality": "720p",
            "url": "https://video-hkg1-2.xx.fbcdn.net/...",
            "format": "MP4"
          },
          {
            "quality": "480p",
            "url": "https://video-hkg4-1.xx.fbcdn.net/...",
            "format": "MP4"
          }
        ],
        "reel_url": "https://www.facebook.com/reel/2447753995633615",
        "reel_download_url": "https://video-hkg1-2.xx.fbcdn.net/..."
      }
    ],
    "total_story_count": 6,
    "metadata": {
      "story_id": "1764329168156529",
      "timestamp": "2026-10-09T12:49:45Z",
      "uploader": {
        "name": "Komal Jha",
        "id": "172339350930615",
        "profile_url": "https://www.facebook.com/172339350930615"
      }
    }
  }
]
```

#### 📖 Output Field Documentation

**🔹 Story Identification**
| Field | Description |
|-------|-------------|
| `Story No` | Sequential story number |
| `story_id` | Unique story identifier |
| `type` | Media type (video or image) |

**🔹 Media Assets**
| Field | Description |
|-------|-------------|
| `thumbnail` | High-quality preview image URL |
| `qualities` | Array of available quality options |
| `qualities[].quality` | Quality label (720p, 480p, original) |
| `qualities[].url` | Direct download URL |
| `qualities[].format` | File format (MP4, JPG) |

**🔹 Video-Specific Fields**
| Field | Description |
|-------|-------------|
| `reel_url` | Facebook Reel URL |
| `reel_download_url` | Direct video download URL |

**🔹 Story Metadata**
| Field | Description |
|-------|-------------|
| `total_story_count` | Total stories found |
| `single_story_mode` | Single story extraction flag |

**🔹 Uploader Information**
| Field | Description |
|-------|-------------|
| `uploader.name` | Display name |
| `uploader.id` | Facebook profile ID |
| `uploader.profile_url` | Direct profile URL |

**🔹 Response Metadata**
| Field | Description |
|-------|-------------|
| `url` | Original input URL |
| `success` | Scrape success status |
| `timestamp` | Scrape timestamp (ISO 8601) |

***

### 🎨 Key Features of This Facebook Story Scraper

#### 🎥 Multi-Quality Video Downloads

- **720p HD Quality** - High-definition video extraction
- **480p Standard Quality** - Optimized for bandwidth
- **Direct CDN Access** - No authentication required
- **MP4 Format Support** - Universal compatibility

#### 🖼️ Image Story Support

- **Original Resolution** - Full-quality image downloads
- **JPG Format** - Standard image format
- **High-Resolution Thumbnails** - Preview images
- **Direct URLs** - Instant download links

#### 📊 Comprehensive Metadata

- **Story Identification** - Unique story IDs
- **Sequential Ordering** - Preserves story sequence
- **Timestamp Tracking** - Scrape time recording
- **Success Status** - Per-URL success tracking

#### 🚀 Performance Features

- **Bulk Processing** - Multiple URLs in one run
- **Story Tray Support** - Extract entire story buckets
- **Single Story Mode** - Focused extraction
- **Efficient Extraction** - Optimized performance

***

### 💡 Use Cases for Facebook Story Scraper

- **📈 Social Media Managers** - Archive client stories
- **📚 Content Archivists** - Preserve disappearing content
- **🎯 Marketing Teams** - Track brand stories
- **🔬 Researchers** - Study story content patterns
- **📱 App Developers** - Power story-related applications
- **💰 Influencer Agencies** - Monitor influencer stories
- **📊 Competitor Analysis** - Track competitor stories
- **🎬 Content Creators** - Save inspiration and references

***

### ✨ Why Choose Our Facebook Story Scraper?

- **⚡ Fast & Efficient** - Quick story extraction and downloads
- **🎯 100% Accurate** - Preserves all media without alteration
- **📦 Complete Data** - Everything from media to uploader info
- **🔄 Regular Updates** - Adapts to Facebook changes
- **🛡️ Production Ready** - Reliable with thousands of stories
- **💰 Cost Efficient** - Optimized for minimal compute time
- **🔒 Privacy Focused** - Only public story data extracted

***

### ⚠️ Limitations

- Only works with public Facebook Stories
- Private stories are not accessible
- Story availability depends on Facebook's retention
- Some stories may have limited quality options
- Rate limits may apply for high-volume scraping

### 🔗🛠 Related Actors (Full Content Suite)

Explore our full scraping suite for enhanced content extraction:

#### 🎥 YouTube Scrapers:

- [YouTube Video Scraper](https://apify.com/codenest/youtube-video-scraper)
- [YouTube Video Search Scraper](https://apify.com/codenest/youtube-video-search-scraper)
- [YouTube Video Extractor](https://apify.com/codenest/youtube-video-extractor)
- [YouTube Shorts & Video Downloader](https://apify.com/codenest/youtube-shorts-video-downloader)
- [YouTube Video Downloader](https://apify.com/codenest/youtube-video-downloader)
- [YouTube Shorts Scraper & Downloader](https://apify.com/codenest/youtube-shorts-scraper-downloader)
- [YouTube Shorts Downloader](https://apify.com/codenest/youtube-shorts-downloader)
- [YouTube Thumbnail Scraper & Downloader](https://apify.com/codenest/youtube-thumbnail-scraper-downloader)
- [YouTube Video  Scraper & Downloader](https://apify.com/codenest/youtube-video-scraper-downloader)
- [YouTube Image Post Scraper](https://apify.com/codenest/youtube-image-post-scraper)

#### Facebook Scrapers:

- [Facebook Page Scraper](https://apify.com/codenest/facebook-page-scraper)
- [Facebook Reels Downloader](https://apify.com/codenest/facebook-reels-downloader)
- [Facebook Reels Audio Downloader](https://apify.com/codenest/facebook-reels-audio-downloader)
- [Facebook Thumbnail Downloader](https://apify.com/codenest/facebook-thumbnail-downloader)
- [Facebook Post Scraper](https://apify.com/codenest/facebook-post-scraper)
- [Facebook Reels Scraper & Reels Downloader](https://apify.com/codenest/facebook-reels-scraper-reels-downloader)
- [Facebook Story Downloader](https://apify.com/codenest/facebook-story-downloader)
- [Facebook Post Downloader](https://apify.com/codenest/facebook-post-downloader)
- [Facebook Reels Scraper](https://apify.com/codenest/facebook-reels-scraper)
- [Facebook Story Scraper](https://apify.com/codenest/facebook-story-scraper)

#### 📱 Instagram Scrapers:

- \[Instagram Story Downloader]\(https://apify.com/codenest/instagram-story-downloader
- [Instagram Story Scraper](https://apify.com/codenest/instagram-story-scraper)
- [Instagram Video Search Scraper](https://apify.com/codenest/instagram-video-search-scraper)
- [Instagram Post Downloader (Image & Video)](https://apify.com/codenest/instagram-post-downloader-image-video)
- [Instagram Reels Scraper & Downloader](https://apify.com/codenest/instagram-reels-downloader-scraper)
- [Instagram Reels Audio Downloader](https://apify.com/codenest/instagram-reels-audio-downloader)
- [Instagram Profile Scraper](https://apify.com/codenest/instagram-profile-scraper)
- [Instagram Post Scraper](https://apify.com/codenest/instagram-post-scraper)
- [Instagram Reels Scraper Pro](https://apify.com/codenest/instagram-reels-scraper-pro)
- [Instagram Profile List Scraper](https://apify.com/codenest/instagram-profile-list-scraper)
- [Instagram Post Comments Scraper](https://apify.com/codenest/instagram-post-comments-scraper)
- [Instagram Post Scraper Pro](https://apify.com/codenest/instagram-post-scraper-pro)

#### 🏭 Supplier Scrapers:

- [Made In China Supplier/Company Scraper](https://apify.com/codenest/made-in-china-supplier-company-scraper) - YOU ARE HERE
- [Zillow Agent Profile Scraper](https://apify.com/codenest/zillow-agent-profile-scraper)

#### 📊 Product Scrapers:

- [Made in China Product Scraper](https://apify.com/codenest/made-in-china-product-scraper)
- [Made In China Top Ranking Product Scraper](https://apify.com/codenest/made-in-china-top-ranking-product-scraper)
- [Zillow Property Scraper](https://apify.com/codenest/zillow-property-scraper)
- [Alibaba Product Scraper](https://apify.com/codenest/alibaba-product-scraper)
- [Amazon Product Scraper](https://apify.com/codenest/amazon-product-scraper)
- [Amazon Deals Scraper](https://apify.com/codenest/amazon-deals-scraper)
- [Zillow Property & Apartment Scraper](https://apify.com/codenest/zillow-property-apartment-scraper)
- [Made In China Product & Company Details Scraper](https://apify.com/codenest/made-in-china-product-company-details-scraper)

#### 📊 Wellfound Scrapers:

- [Wellfound Job & Company Details Scraper](https://apify.com/codenest/wellfound-job-company-details-scraper)
- [Wellfound Startup Company Scraper](https://apify.com/codenest/wellfound-startup-company-scraper)
- [Wellfound Job Listings Scraper](https://apify.com/codenest/wellfound-job-listings-scraper)
- [Alibaba Product Scraper](https://apify.com/codenest/alibaba-product-scraper)

#### 📊 Alibaba Scrapers:

- [Alibaba Supplier/Company Details Scraper](https://apify.com/codenest/alibaba-supplier-company-details-scraper)
- [Alibaba Product Listings Scraper](https://apify.com/codenest/alibaba-product-listings-scraper)
- [Alibaba Supplier/Company Listings Scraper](https://apify.com/codenest/alibaba-supplier-company-listings-scraper)
- [Alibaba Product Scraper](https://apify.com/codenest/alibaba-product-scraper)

#### Linkedin Specialized Actors:

- [Linkedin Post Scraper](https://apify.com/codenest/linkedin-post-scraper)
- [Linkedin Profile Scraper](https://apify.com/codenest/linkedin-profile-scraper)
- [Linkedin Job Search Scraper](https://apify.com/codenest/linkedin-job-search-scraper)
- [Linkedin Company Scraper](https://apify.com/codenest/linkedin-company-scraper)

#### 📱 TikTok Scrapers:

- [TikTok Video Scraper & Downloader](https://apify.com/codenest/tiktok-video-scraper-downloader)
- [TikTok Scraper](https://apify.com/codenest/tiktok-scraper)
- [TikTok Profile Scraper](https://apify.com/codenest/tiktok-profile-scraper)
- [TikTok Hashtag Scraper](https://apify.com/codenest/tiktok-hashtag-scraper)

#### 🐦 Twitter/X.com Specialized Actors:

- [Twitter (X.com) Video Post Scraper](https://apify.com/codenest/twitter-x-com-video-post-scraper)
- [Twitter (X.com) Image Downloader](https://apify.com/codenest/twitter-x-com-image-downloader)
- [Twitter(X.com) Tweets Scraper](https://apify.com/codenest/twitter-x-com-tweets-scraper)
- [Twitter (X.com) mp3/Audio Downloader](https://apify.com/codenest/twitter-x-com-mp3-audio-downloader)

##### 📱 Snapchat Scrapers:

- [Snapchat Story Scraper](https://apify.com/codenest/snapchat-story-scraper)
- [Snapchat Spotlight Scraper](https://apify.com/codenest/snapchat-spotlight-scraper)

#### Reddit Scrapers:

- [Reddit Video & Image Post Scraper](https://apify.com/codenest/reddit-video-image-post-scraper)

#### Dailymotion Scrapers:

- [Dailymotion Video Downloader](https://apify.com/codenest/dailymotion-video-downloader)

#### Spotify Scrapers:

- [Spotify Track Music Downloader](https://apify.com/codenest/spotify-track-music-downloader)
- [Spotify Music/Mp3 Downloader](https://apify.com/codenest/spotify-music-mp3-downloader)

#### Tumblr Scrapers:

- [Tumblr Scraper](https://apify.com/codenest/tumblr-scraper)

#### Loom Scrapers:

- [Loom Video Downloader](https://apify.com/codenest/loom-video-downloader)

#### VK Scrapers:

- [VK Video Downloader](https://apify.com/codenest/vk-video-downloader)

***

### 📧 Need Custom Features for Your Facebook Story Scraper?

Want **additional quality options**, **specific metadata fields**, **custom output formats**, **automated monitoring**, or **enterprise integrations**?

✉️ Email **<codenest2.0@gmail.com>** for tailored enterprise solutions!

***

# 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: 1)

## `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.

## `cookies` (type: `string`):

Optional Facebook cookies (Netscape format or key=value string) for authenticated story extraction.

## Actor input object example

```json
{
  "story_urls": [
    {
      "url": "https://www.facebook.com/stories/171905157633541/UzpfSVNDOjEzMTgzNjY0NzM2ODc5MDg=/"
    }
  ],
  "language": "en",
  "delayBetweenRequests": 1,
  "maxRetries": 3,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Default dataset containing extracted Facebook stories, playable media URLs, thumbnails, qualities, and author metadata.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,codenest/facebook-story-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/sEiDJiXdkMuXehZsM/builds/F6VSSPmjbsA5hV8xF/openapi.json