# Snapchat Story Downloader (`kingscraper/snapchat-story-downloader`) Actor

📥Download Snapchat stories with audio,📝titles, thumbnails 🖼️& Apify storage 🔗URLs. Get MP4🎬 files with metadata including 📊file size &⚡automatic audio injection.🔊

- **URL**: https://apify.com/kingscraper/snapchat-story-downloader.md
- **Developed by:** [King Scraper](https://apify.com/kingscraper) (community)
- **Categories:** Social media, Videos, Automation
- **Stats:** 103 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

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

## 📸 Snapchat Story Downloader - Ultimate Media Preservation Tool

**Effortlessly download Snapchat stories with our powerful **Snapchat Story Downloader**! This Apify actor enables you to batch download public Snapchat story content while preserving video, audio, metadata, and direct Apify storage access.**

***

### 📋 Overview

Need to archive disappearing Snapchat content or repurpose stories? This **Snapchat Story Downloader** delivers:

- 🎥 **Video+Audio Merge**: Automatically adds audio tracks to silent videos
- 📦 **Apify Cloud Storage**: Secure, encrypted download URLs
- 📝 **Rich Metadata**: Titles, descriptions, thumbnails
- ⚡ **Bulk Processing**: Download multiple stories per run
- 🔍 **Auto-Detection**: Automatically identifies story vs spotlight content

Perfect for content curators 🎨, social media managers 📱, digital archivists 💾, and marketing researchers 📊!

***

### ⭐ Core Capabilities / Key Features

#### 🎬 Media Processing

- **Smart Audio Injection**: Automatically adds missing audio tracks to stories
- **Single Format Output**: Clean MP4 files with integrated audio
- **High-Quality Thumbnails**: Preserve story cover images
- **Batch Mode**: Process 100+ story URLs in one execution

#### 📊 Metadata Excellence

- **Story Titles**: Extracts original captions and titles
- **Content Descriptions**: Preserves Snapchat descriptions
- **URL Type Detection**: Auto-identifies story vs other content types
- **File Size Tracking**: Get exact byte counts for storage planning

#### 🔧 Advanced Technology

- **Apify Native Storage**: Direct integration with Apify key-value store
- **CDN Acceleration**: Fast downloads from Snapchat's content delivery network
- **Zero Proxy Required**: Works without proxy configuration
- **Automatic Fallback**: Graceful handling of unavailable content

***

### 🎯 Input Configuration

Simply enter the Snapchat story URL(s) in the Input Section, toggle video download preference, then click "Start". URLs follow this format:

```json
{
    "download_video": true,
    "post_urls": [
        {
            "url": "https://www.snapchat.com/p/50dbd8bb-5a90-4864-9366-2b9d86cc3c4c/1536486778769408"
    }
  ]
}
```

#### 📥 Input Specifications

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `download_video` | Boolean | Yes | Enable/disable video downloading (true = download) |
| `post_urls` | Array | Yes | Snapchat story URLs to process |
| `url` | String | Yes | Valid Snapchat story URL (p/ format) |

***

### 📤 Output Structure

Your **Snapchat Story Downloader** produces clean, structured output like this:

```json
[
  {
    "input_url": "https://www.snapchat.com/p/50dbd8bb-5a90-4864-9366-2b9d86cc3c4c/1536486778769408",
    "url_type": "story",
    "title": "Like Mom Like Daughter 🧿🌈 (1)",
    "description": "Watch Beauty Point on Snapchat",
    "thumbnail": "https://cf-st.sc-cdn.net/d/8P4vHKdlXYNanoHLaIF3I.410?mo=GmsaBzIBBFAFYAFQH1oeTG9uZ2Zvcm1WaWRlb1RodW1ibmFpbFZhcmlhbnRzogEWCJoDIhEKDToBfUIGCOTuzc4GSAISAKIBFgikAyIRCg06AX1CBgjk7s3OBkgCEgCiAQsIASIHCgUyAX1IAQ%3D%3D&uc=5",
    "webpage_url": "https://www.snapchat.com/p/50dbd8bb-5a90-4864-9366-2b9d86cc3c4c/1536486778769408",
    "audio_added": true,
    "video_download_url": "https://api.apify.com/v2/key-value-stores/LMj0jdICALWirGUaX/records/Like_Mom_Like_Daughter_____1.mp4",
    "video_filename": "Like_Mom_Like_Daughter_____1.mp4",
    "video_size_bytes": 4291416
  }
]
```

#### 📋 Output Field Documentation

**📌 Content Information**
| Field | Description |
|-------|-------------|
| `input_url` | Original Snapchat story URL provided |
| `url_type` | Content type detection (story, spotlight, etc.) |
| `title` | Story title/caption from Snapchat |
| `description` | Extended description text |
| `thumbnail` | Direct URL to story cover image |

**🎥 Media Assets**
| Field | Description |
|-------|-------------|
| `video_download_url` | Apify-hosted download link (encrypted) |
| `video_filename` | Sanitized filename with story title |
| `video_size_bytes` | Exact file size in bytes |
| `audio_added` | Boolean indicating if audio was injected |

**🔗 Source Data**
| Field | Description |
|-------|-------------|
| `webpage_url` | Original Snapchat webpage URL |

***

### 🎨 Unique Features (Not Available in Other Downloaders)

Unlike generic scrapers, this **Snapchat Story Downloader** offers:

1. **🎵 Audio Restoration** - Automatically detects and adds missing audio tracks to silent story videos
2. **📦 Native Apify Storage** - No external CDN dependencies, all files stored securely in your Apify account
3. **🔍 Smart URL Detection** - Automatically identifies story types without manual configuration
4. **📊 Byte-Level Tracking** - Get precise file sizes for bandwidth and storage management
5. **🧹 Clean Filename Sanitization** - Automatically removes special characters for cross-platform compatibility

***

### 💼 Use Cases

- 🎬 **Content Creators** – Repurpose Snapchat stories for TikTok, Reels, or YouTube Shorts
- 📈 **Social Media Managers** – Archive client stories for reporting and analytics
- 🏢 **Brands & Agencies** – Monitor competitor story campaigns
- 📚 **Digital Archivists** – Preserve disappearing content before it expires
- 🔬 **Market Researchers** – Analyze story trends and engagement patterns
- 🛡️ **Compliance Teams** – Store story content for regulatory requirements

***

### ✅ Why Choose This Snapchat Story Downloader?

- **⚡ One-Click Simplicity** – Just paste URLs and run
- **🔊 Audio Intelligence** – Automatically fixes silent videos (unique feature!)
- **☁️ Cloud-Native Storage** – Direct integration with Apify ecosystem
- **🆓 No Proxy Costs** – Works without residential proxies
- **🔄 Regular Updates** – Maintained to work with Snapchat's evolving platform
- **📦 Bulk Ready** – Process hundreds of stories in a single execution

***

### ⚠️ Limitations

- Only works with **public** Snapchat stories (private accounts not accessible)
- Stories must be **currently available** (24-hour expiration window)
- Maximum file size limited by Snapchat's original upload limits
- Requires valid Snapchat CDN access (automatic)

***

### 🔗🛠 Related Actors (Content Preservation 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)

#### ☁️ Storage & Processing:

- **Apify S3 Uploader** – Transfer downloads to AWS S3
- **Metadata Enricher** – Add custom tags and categories

***

### 📧 Need Customization?

Want **higher resolution downloads**, **automatic scheduling**, or **custom filename patterns**?

✉️ Email **mehedy7613@gmail.com** for tailored solutions!

***

# Actor input Schema

## `post_urls` (type: `array`):

List of public Snapchat URLs to scrape. Supports:
Story/Post  - snapchat.com/p/{uuid}/{id}
Profile     - snapchat.com/@{username}
Spotlight   - snapchat.com/@{username}/spotlight/{id}

## `max_profile_items` (type: `integer`):

When scraping a profile URL, the maximum number of content items (stories/spotlights) to extract media from. Ignored for non-profile URLs.

## `download_video` (type: `boolean`):

If enabled, the actor downloads the video (using yt-dlp + ffmpeg for proper mp4 muxing), checks for audio, adds a silent track if missing, then uploads to the Key-Value store as video/mp4. Opening the video\_download\_url in a browser shows the native video player with play/pause/seek controls and a download button.

## Actor input object example

```json
{
  "post_urls": [
    {
      "url": "https://www.snapchat.com/p/50dbd8bb-5a90-4864-9366-2b9d86cc3c4c/1536486778769408"
    },
    {
      "url": "https://www.snapchat.com/@badgalriri"
    }
  ],
  "max_profile_items": 10,
  "download_video": true
}
```

# 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 = {
    "post_urls": [
        {
            "url": "https://www.snapchat.com/p/50dbd8bb-5a90-4864-9366-2b9d86cc3c4c/1536486778769408"
        },
        {
            "url": "https://www.snapchat.com/@badgalriri"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("kingscraper/snapchat-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "post_urls": [
        { "url": "https://www.snapchat.com/p/50dbd8bb-5a90-4864-9366-2b9d86cc3c4c/1536486778769408" },
        { "url": "https://www.snapchat.com/@badgalriri" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("kingscraper/snapchat-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 '{
  "post_urls": [
    {
      "url": "https://www.snapchat.com/p/50dbd8bb-5a90-4864-9366-2b9d86cc3c4c/1536486778769408"
    },
    {
      "url": "https://www.snapchat.com/@badgalriri"
    }
  ]
}' |
apify call kingscraper/snapchat-story-downloader --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=kingscraper/snapchat-story-downloader",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/1UqsxryV0qM2RhIZn/builds/2eojYR79omDe7sdDT/openapi.json