# Snapchat Spotlight, Story Video Downloader & Metadata Extractor (`scrapearchitect/snapchat-spotlight-story-video-downloader-metadata-extractor`)

🚀 Download Snapchat Spotlight 🌟 & Stories 📖 videos 🎥 + metadata 📊! Get titles, durations ⏱️, owner images 👤, HD quality 🖼️ Choose Apify 🔐 or direct links ⚡Bulk URLs 🔄, for devs 🛠️, archivists 📚 Fast ⚡, encrypted 🛡️! ⚡ Snapchat Spotlight, Story Video Downloader & Metadata Extractor 🎥

- **URL**: https://beta-securitybyobscurity.apify.com/scrapearchitect/snapchat-spotlight-story-video-downloader-metadata-extractor.md
- **Developed by:** [Scrape Architect](https://beta-securitybyobscurity.apify.com/scrapearchitect) (community)
- **Categories:** Social media, Videos, Developer tools
- **Stats:** 38 total users, 7 monthly users, 100.0% runs succeeded, NaN 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

# README

***

## 🚀 Snapchat Spotlight & Story Video Downloader + Metadata Extractor – Bulk HD Downloads 📸

**Download Spotlight videos 🌟 & Stories 📖 with rich metadata!** Get owner images 👤, thumbnails 🖼️, HD media 📹. Choose Apify storage 🔐 or direct links ⚡. Bulk processing 🔄!

***

### 🌟 Overview

Capture Snapchat Spotlight videos & Stories effortlessly! This actor delivers:\
✅ **Dual download modes**: Apify storage OR direct links\
✅ **Full metadata**: Titles, durations, owner images\
✅ **Bulk processing**: Handle 100+ URLs per run\
✅ **Multi-media extraction**: All videos/images from Stories

Perfect for influencers 📈, archivists 📚, and social media managers 💼!

> ⚡ Avg. runtime: 30-90 seconds (faster with direct links)\
> 🛡️ Auto proxy rotation & retry mechanisms

***

### 🔥 Key Features

#### 🎥 Media Mastery

- **Spotlight/Story Support**: Handles both content types
- **Multi-File Stories**: Extract ALL videos/images from Story URLs
- **Quality Options**: HD downloads preserved
- **Dual Storage**:
  - 🔐 **Apify Key-Value**: Secure, encrypted links
  - ⚡ **Direct Links**: Faster access (no storage wait)

#### 📊 Metadata Power

- **Owner Profiles**: Account images + titles
- **Duration Stats**: Formatted video lengths
- **Technical Specs**: File sizes, formats, quality tags
- **Thumbnails Included**: Preview images for every item

#### 🛠️ Enterprise-Grade

- **Proxy Ready**: Residential IP support
- **Auto-Type Detection**: Spotlight vs Story URLs
- **Validation**: Rejects invalid/broken links

***

### ⚙️ Input Configuration

```json
{
  "useKeyValueStore": true,
  "video_urls": [
    "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY3dvoHZ4bnBoAZRwevftAZRwevfbAAAAAQ",
    "https://www.snapchat.com/add/mr_yashuuu09"
  ]
}
```

#### 📋 Input Fields

| Parameter | Type | Description |\
|-----------|------|-------------|\
| `video_urls` | Array | Snapchat Spotlight/Story URLs |\
| `useKeyValueStore` | Boolean | `true`=Apify storage, `false`=Direct links |

***

### 📤 Output Examples

#### Spotlight Result

```json
{
  "original_url": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY3dvoHZ4bnBoAZRwevftAZRwevfbAAAAAQ",
  "type": "spotlight",
  "title": "hamidalijutt208 | Spotlight on Snapchat",
  "thumbnail_link": "https://api.apify.com/.../thumb_5e89b3ec17c14633a408c729844738e2.jpg",
  "metadata": {
    "duration": "01:36:40",
    "medias": [
      {
        "url": "https://api.apify.com/.../media_91a280b0b6e441229d00b6d82304ade7.mp4",
        "formattedSize": "427.42 KB",
        "quality": "HD"
      }
    ]
  }
}
```

#### Story Result (Multi-Media)

```json
{
  "original_url": "https://www.snapchat.com/add/mr_yashuuu09",
  "type": "story",
  "videos": [
    "https://api.apify.com/.../video_8cf4f51cd2b245ff95f2d15daec3c130.mp4",
    "https://api.apify.com/.../video_baf4f53d2fe74a21a858e7be8fb587fe.mp4"
  ],
  "owner_images": [
    "https://api.apify.com/.../img_6c8bec2b332e421a98d00f8a35ea6d8e.jpg",
    "https://api.apify.com/.../img_c69df58b2e904e54b7c37f1af2e837d7.jpg"
  ],
  "metadata": {
    "medias": [
      {
        "url": "https://api.apify.com/.../media_f1de78df8fa7491a98d59253550b78b1.mp4",
        "formattedSize": "1000.18 KB"
      },
      {
        "url": "https://api.apify.com/.../media_8ffadb6f3f30471eaa348189e69a68b0.mp4",
        "formattedSize": "764.26 KB"
      }
    ]
  }
}
```

***

### 🆚 Why This Actor?

| Feature | 🚀 This Actor | 🐌 Others |\
|---------|---------------|-----------|\
| Story Support | Multi-File Extraction | Single Videos |\
| Metadata Depth | Owner Images + Specs | Basic Titles |\
| Storage Options | Apify/Direct Choice | Limited |\
| Snapchat API | Native Integration | Browser Emulation |\
| Bulk Handling | 100+ URLs | Manual Processing |

***

### 🛠️ How It Works

1️⃣ **Add URLs** – Spotlight videos or Story pages\
2️⃣ **Choose Mode**:

- 🔐 **Apify Storage**: Secure but slower
- ⚡ **Direct Links**: Faster but temporary\
  3️⃣ **Run Actor** – Auto-detects content type\
  4️⃣ **Get**:
- 📹 Videos + 🖼️ Images (for Stories)
- 👤 Owner profile data
- 📏 File sizes & quality specs

***

### 💡 Use Cases

📱 **Influencers** – Archive viral Spotlight content\
🔍 **Brands** – Monitor UGC Stories\
📂 **Archivists** – Preserve disappearing Stories\
🛠️ **Developers** – Build Snapchat-integrated apps\
📊 **Analysts** – Track video performance metrics

***

### 🧩 Related Tools

#### 🎥 YouTube Suite

- [Video Captions Scraper](https://apify.com/scrapearchitect/youtube-video-captions-scraper)
- [Video Transcripts](https://apify.com/scrapearchitect/youtube-video-transcript-scraper)
- [Format Explorer](https://apify.com/scrapearchitect/youtube-video-formats-scraper)

#### 🎵 Spotify Suite

- [Artist Scraper](https://apify.com/scrapearchitect/spotify-artist-scraper)
- [Playlist Downloader](https://apify.com/scrapearchitect/spotify-playlists-scraper)
- [High-Speed Music Grab](https://apify.com/scrapearchitect/spotify-tracks-music-downloader-fast)

***

### ❓ Troubleshooting

**Issue**: "Invalid URL" Error\
**Fix**:

- Use official Snapchat share links
- Format: `snapchat.com/spotlight/...` or `snapchat.com/add/...`

**Issue**: Missing Owner Images\
**Fix**:

- Account must have public profile
- Retry with `useKeyValueStore: true`

***

### 🚀 Deploy Now!

*First run initializes proxies - allow 1-2 minutes ⏳*

***

# Actor input Schema

## `video_urls` (type: `array`):

List of Snapchat URLs to process.

## `useKeyValueStore` (type: `boolean`):

If ON, uploads video & thumbnail to KV Store and returns those URLs. If OFF, returns direct links.

## Actor input object example

```json
{
  "video_urls": [
    "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYbGtmendmeGFzAZVnZlhyAZVnZjNYAAAAAw",
    "https://www.snapchat.com/add/mr_yashuuu09"
  ],
  "useKeyValueStore": false
}
```

# 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 = {
    "video_urls": [
        "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYbGtmendmeGFzAZVnZlhyAZVnZjNYAAAAAw",
        "https://www.snapchat.com/add/mr_yashuuu09"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapearchitect/snapchat-spotlight-story-video-downloader-metadata-extractor").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 = { "video_urls": [
        "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYbGtmendmeGFzAZVnZlhyAZVnZjNYAAAAAw",
        "https://www.snapchat.com/add/mr_yashuuu09",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("scrapearchitect/snapchat-spotlight-story-video-downloader-metadata-extractor").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 '{
  "video_urls": [
    "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYbGtmendmeGFzAZVnZlhyAZVnZjNYAAAAAw",
    "https://www.snapchat.com/add/mr_yashuuu09"
  ]
}' |
apify call scrapearchitect/snapchat-spotlight-story-video-downloader-metadata-extractor --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Snapchat Spotlight, Story Video Downloader & Metadata Extractor",
        "description": "🚀 Download Snapchat Spotlight 🌟 & Stories 📖 videos 🎥 + metadata 📊! Get titles, durations ⏱️, owner images 👤, HD quality 🖼️ Choose Apify 🔐 or direct links ⚡Bulk URLs 🔄, for devs 🛠️, archivists 📚 Fast ⚡, encrypted 🛡️! ⚡ Snapchat Spotlight, Story Video Downloader & Metadata Extractor 🎥",
        "version": "1.0",
        "x-build-id": "t1O2TFGMLtlwqRO9r"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapearchitect~snapchat-spotlight-story-video-downloader-metadata-extractor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapearchitect-snapchat-spotlight-story-video-downloader-metadata-extractor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scrapearchitect~snapchat-spotlight-story-video-downloader-metadata-extractor/runs": {
            "post": {
                "operationId": "runs-sync-scrapearchitect-snapchat-spotlight-story-video-downloader-metadata-extractor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scrapearchitect~snapchat-spotlight-story-video-downloader-metadata-extractor/run-sync": {
            "post": {
                "operationId": "run-sync-scrapearchitect-snapchat-spotlight-story-video-downloader-metadata-extractor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "video_urls",
                    "useKeyValueStore"
                ],
                "properties": {
                    "video_urls": {
                        "title": "Snapchat URLs",
                        "type": "array",
                        "description": "List of Snapchat URLs to process.",
                        "items": {
                            "type": "string",
                            "pattern": "^https://www\\.snapchat\\.com\\/(spotlight|add)\\/"
                        }
                    },
                    "useKeyValueStore": {
                        "title": "Store in Key‑Value Store? It Will Take More Time Depending On The Video Length",
                        "type": "boolean",
                        "description": "If ON, uploads video & thumbnail to KV Store and returns those URLs. If OFF, returns direct links.",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
