Facebook Story Downloader

An Apify actor for downloading Facebook Stories. It extracts video and image content directly from Facebook's CDN, supporting batch processing and multiple quality options.

Overview

This actor takes Facebook Story URLs as input and returns direct download links for the media. It handles both single stories and collections of multiple stories from a single URL. Output is structured JSON containing metadata and the CDN URLs for downloading.

Key Features

• Media Download: Downloads Facebook Stories as MP4 (video) or JPG (image) files.
• Quality Options: Fetches available resolutions, typically including 720p, 480p, and original quality.
• Batch Processing: Can process multiple story URLs in a single run.
• URL Type Detection: Automatically handles URLs for single stories (view_single=1) and multi-story collections (view_single=false).
• Direct CDN Links: Retrieves authentic URLs from Facebook's content delivery network for reliable downloads.
• Structured Metadata: Output includes story numbering, media type, quality labels, and success status for each URL.

How to Use

Provide an array of Facebook Story URLs in the actor's input. The actor will parse each URL, fetch the available media, and return the download links and metadata.

Input Configuration

The input must be a JSON object with a story_urls array. Each item in the array is an object containing a single url key.

{
  "story_urls": [
    {
      "url": "https://www.facebook.com/stories/185179642966326/?view_single=false"
    },
    {
      "url": "https://www.facebook.com/stories/185179642966326/UzpfSVNDOjExNzM0MjkxNTE2MTMzODI=/?view_single=1"
    }
  ]
}

Supported URL Formats:
* Multi-story collection: https://www.facebook.com/stories/{ID}/?view_single=false
* Single story: https://www.facebook.com/stories/{ID}/{HASH}/?view_single=1

Input/Output

Input Specification

Output Structure

The actor returns an array of result objects, one for each input URL.

[
  {
    "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 Reference

Result-Level Fields
| Field | Description |
| :--- | :--- |
| url | The original Facebook Story URL that was processed. |
| success | Boolean indicating if the extraction was successful. |
| total_story_count | Total number of stories found at the URL. |
| stories | Array containing the details for each story found. |

Story Object Fields
| Field | Description |
| :--- | :--- |
| Story No | Sequential number of the story (1-based). |
| type | Media type, either "video" or "image". |
| qualities | Array of available download options for the story. |

Quality Object Fields
| Field | Description |
| :--- | :--- |
| quality | Resolution label (e.g., "720p", "480p", "original"). |
| url | Direct download URL from Facebook's CDN. |
| format | File format ("MP4" or "JPG"). |