# Snapchat Video Downloader (Spotlight ) (`alpha-scraper/snapchat-video-downloader-spotlight`) Actor

✅ Snapchat Video Downloader (Spotlight ), Full HD Video  allows you to download public Snapchat Spotlight videos quickly and easily using simple URLs. Just paste one or multiple Spotlight links, run the actor, and get clean structured output with direct video download links and useful metadata.

- **URL**: https://apify.com/alpha-scraper/snapchat-video-downloader-spotlight.md
- **Developed by:** [Alpha Scraper](https://apify.com/alpha-scraper) (community)
- **Categories:** Videos, Social media, Other
- **Stats:** 15 total users, 0 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 Video Downloader (Spotlight )

Download public Snapchat Spotlight videos quickly, easily, and in bulk using simple links. This actor is designed to be beginner-friendly, reliable, and efficient for collecting video data from Snapchat Spotlight.

***

### 🚀 Overview

The **Snapchat Spotlight Video Downloader** allows you to input one or multiple Snapchat Spotlight video URLs and get direct downloadable video links along with useful metadata in a clean structured output.

Whether you are:

- Collecting content for research 📊
- Archiving videos 🗂️
- Analyzing trends 📈
- Or managing media assets 🎬

This actor helps you do it **fast and without hassle**.

***

### 📦 What Data This Actor Provides

For each Snapchat Spotlight video URL, this actor provides:

- Video ID
- Video title
- Video description
- Thumbnail image link
- Direct video download URL
- Original source URL
- Success or error status

All data is returned in a structured JSON format.

***

### 📤 What Outputs It Generates

For every input URL, the actor generates **one output object** containing:

| Field                | Description                                  |
| -------------------- | -------------------------------------------- |
| `success`            | Whether the video was processed successfully |
| `id`                 | Unique ID of the Snapchat video              |
| `title`              | Title of the video                           |
| `description`        | Video description (if available)             |
| `thumbnail`          | Thumbnail image URL                          |
| `video_download_url` | Direct downloadable video link               |
| `original_url`       | Original Snapchat Spotlight URL              |
| `input_url`          | Input URL (only in case of error)            |
| `error`              | Error message (only if failed)               |

***

### 🧾 Output Field Explanation (Detailed)

#### `success`

- `true` → Video data was successfully extracted
- `false` → Something went wrong for this URL

***

#### `id`

Unique identifier of the Snapchat video. Useful for:

- Deduplication
- Database storage
- Tracking

***

#### `title`

The public title of the Spotlight video.

***

#### `description`

The description text provided by the video creator (if available).

***

#### `thumbnail`

Direct link to the video thumbnail image.
Useful for:

- Previews
- UI display
- Image analysis

***

#### `video_download_url`

The **most important field** 🎯
This is the **direct playable & downloadable video link**.

***

#### `original_url`

The original Snapchat Spotlight page link for reference.

***

#### `input_url`

Only appears if `success = false`.
Shows which URL failed.

***

### 🧩 Features & Highlights

- ✅ Supports **multiple URLs at once**
- ✅ Clean structured JSON output
- ✅ Works with **public Spotlight links**
- ✅ No login required
- ✅ Fast execution
- ✅ Simple input format
- ✅ Beginner friendly
- ✅ Reliable retry support

***

### 💎 Benefits & Advantages

#### ⚡ Time Saving

No need to manually open each video. Just paste links and run.

***

#### 📊 Perfect for Automation

Easily integrate the output with:

- Data pipelines
- Content management systems
- Analysis tools

***

#### 🧠 Easy to Understand Output

Clear field names and consistent structure make it easy to use in:

- Python
- Node.js
- Excel
- Databases

***

#### 📥 Bulk Processing

Add hundreds of links and process them in one run.

***

### 📥 Input Format

The input expects an array called `startUrls`.

Each item must contain a `url` field.

#### Example Input

```json
{
  "startUrls": [
    {
      "url": "https://www.snapchat.com/@rominagafur/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYaW9qcnJ2enVlAZai-N0TAZai-M2pAAAAAQ"
    },
    {
      "url": "https://www.snapchat.com/@evidenztech/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYa2F5ZWNuamdzAZRh2yZLAZRh2yY0AAAAAQ"
    }
  ]
}
```

***

### 📤 Output Sample

```json
[
  {
    "success": true,
    "id": "W7_EDlXWTBiXAEEniNoMPwAAYaW9qcnJ2enVlAZai-N0TAZai-M2pAAAAAQ-1",
    "title": "47.2K likes, 4.7K comments, and 42.7K shares | Rapping over music with urban lifestyle theme. | Romina Gafur (@rominagafur) | Posted May 6, 2025 | Spotlight (1)",
    "description": "Explore the vibrant Lower East Side of NYC with a raw, unfiltered glimpse into street life, set to the provocative beat of Kendrick Lamar's 'Not Like Us.' This short captures the energy and attitude of the city, offering a taste of real-world experiences.",
    "thumbnail": "https://cf-st.sc-cdn.net/d/593UbJ0eeF5VxmppiNLSs.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46",
   
    "video_download_url": "https://cf-st.sc-cdn.net/d/593UbJ0eeF5VxmppiNLSs.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjz5U8gAUoOCgl4MU8qQkZHQzcQ9ANoAiILEgAqB0lSWlhTT1mQA8Re&uc=46",
    
    "original_url": "https://www.snapchat.com/@rominagafur/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYaW9qcnJ2enVlAZai-N0TAZai-M2pAAAAAQ"
  },
  {
    "success": true,
    "id": "W7_EDlXWTBiXAEEniNoMPwAAYa2F5ZWNuamdzAZRh2yZLAZRh2yY0AAAAAQ-1",
    "title": "164.3K likes, 1.4K comments, and 6.5K shares | Showcasing the iPhone 14 features with music. | Evidenz Tech (@evidenztech) | Posted Jan 13, 2025 | Spotlight (1)",
    "description": "Witness a hilarious and relatable journey through the evolution of mobile phones as one person and their mom upgrade (or downgrade!) over the years! From vintage iPhones to the latest models, see how technology and personal preferences collide in this funny comparison.",
    "thumbnail": "https://cf-st.sc-cdn.net/d/ZfVl7Z4coOXJaCpOCWcOt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46",
    
    "video_download_url": "https://cf-st.sc-cdn.net/d/ZfVl7Z4coOXJaCpOCWcOt.27.IRZXSOY?mo=GmMaCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBPwgbEi4KLAj2ul4gAUoiCh1sQyYsIB88Mk8lPTIjEkU2XRItMyElLiVLJz04OxD0A2gCIgsSACoHSVJaWFNPWZAD0nQ%3D&uc=46",
    
    "original_url": "https://www.snapchat.com/@evidenztech/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYa2F5ZWNuamdzAZRh2yZLAZRh2yY0AAAAAQ"
  }
]
```

***

### 🛠️ Best Practices for Using It

#### 1️⃣ Always Use Public Links

Private or restricted videos may fail.

***

#### 2️⃣ Use Valid Spotlight URLs Only

Make sure the link contains `/spotlight/` in it.

***

#### 3️⃣ Batch Your URLs

Instead of running many times, add all URLs in one input.

***

#### 4️⃣ Handle Errors Gracefully

Check `success` field before using data.

***

#### 5️⃣ Store Results Properly

Save output to:

- Database
- CSV
- JSON file
  for future use.

***

### ⚠️ Possible Causes of Errors & How to Avoid Them

#### ❌ Invalid URL Format

**Cause:** URL is broken or incomplete
**Solution:** Always copy full Spotlight link

***

#### ❌ Private or Deleted Video

**Cause:** Video is no longer public
**Solution:** Use only publicly accessible videos

***

#### ❌ Temporary Network Issue

**Cause:** Connection problem during run
**Solution:** Simply rerun the actor

***

#### ❌ Rate Limiting

**Cause:** Too many requests at once
**Solution:** Split URLs into smaller batches

***

#### ❌ Unsupported Link

**Cause:** Link is not a Spotlight video
**Solution:** Ensure it is a Spotlight video link

***

### 🧪 When to Re-run the Actor

You should rerun if:

- Some videos failed ❌
- Network issue occurred 🌐
- You updated the input list 🔁

Rerunning is safe and recommended.

***

### 📈 Use Cases

- 📊 Data analysis of viral content
- 🎯 Marketing research
- 📥 Content archiving
- 🧠 AI training datasets
- 📱 Social media monitoring
- 📰 Journalism research

***

### 🤝 Support

If you face any problem, feel free to contact:

📧 **<alphascraper69@gmail.com>**

***

### ⭐ Final Notes

This actor is designed to be:

- **Simple**
- **Powerful**
- **Reliable**
- **Beginner-friendly**
- **Production-ready**

Just paste your links, run it, and get clean data. 💪

***

## Here my another actors:

### Youtube Iteams:

- [🎶 Youtube Audio Downloader (Video/Shorts)](https://console.apify.com/actors/lTUPL4gmLTDNXBeWw/source)
- [Youtube Video Downloader Advanced](https://console.apify.com/actors/XOpQsUkgGZLGSCJd0/source)
- [Youtube Video Downloader ( Soundless )](https://console.apify.com/actors/gFsczW1QplIquv9eL/source)
- [Youtube Video Downloader](https://console.apify.com/actors/9kZQcUlHZRKp1ilZA/source)
- [Youtube Video Details Scraper](https://console.apify.com/actors/On4VfiWjGnT79clm1/source)
- [Youtube Transcript Ninja (Subtitles) ](https://console.apify.com/actors/eWrsJHhdeEbVHChpX/source)
- [Youtube Thumbnails Downloader & Scraper](https://console.apify.com/actors/YShot3wkL0HJdRkD0/source)
- [Youtube Tags or Hashtags Scraper](https://console.apify.com/actors/O1FU99ID2ccR5wcS8/source)
- [Youtube Tags Scraper](https://console.apify.com/actors/1wVokAhQLbbeeFVfR/source)
- [Youtube Shorts Scraper lite](https://console.apify.com/actors/bOyWDt1IbXZsadWRp/source)
- [Youtube Shorts Downloader Pro](https://console.apify.com/actors/bN1AjNRMops81rGkg/source)
- [Youtube Shorts Comments Scraper](https://console.apify.com/actors/ON1C4qgHaEQEhhEmI/source)
- [Youtube Community Posts Scraper](https://console.apify.com/actors/X38E51BParHFNaCw1/source)
- [Youtube Channel Id Scraper Pro](https://console.apify.com/actors/2uuIEovgGHcYjEKyN/source)
- [Youtube Video Transcript  Scraper ( Subtitles )](https://console.apify.com/actors/IEmSN6FkNn0tw10BA/source)
- [Youtube Video Comments Scraper](https://console.apify.com/actors/URh4zBT1aesfE8QKc/source)
- [Youtube Shorts Scraper  Pro](https://console.apify.com/actors/G4McyHJJzc2TbUSo6/source)
- [Youtube Shorts Scraper](https://console.apify.com/actors/XP0WgKweF1M83FnmR/source)
- [Youtube Channel Scraper](https://console.apify.com/actors/ufMZfwMgyHeaoDdAd/source)
- [YouTube Video Description Extractor](https://console.apify.com/actors/Xqae3CmxqT3HfHaJ5/source)
- [YouTube Hashtag Scraper](https://console.apify.com/actors/d4bYqQ0LWuczEgumx/source)
- [YouTube Description Scraper pro](https://console.apify.com/actors/OVymx0bku0C8gowB0/source)
- [YouTube Comments Scraper | Pay Per Result](https://console.apify.com/actors/ict6AecoJ85T4RthZ/source)
- [YouTube Channel ID Scraper](https://console.apify.com/actors/P9XlG8ylMGqfoelOg/source)

### Tiktok Iteams:

- [Tiktok Video Downloader](https://console.apify.com/actors/dlyQGIrqOracdqOeb/source)
- [Tiktok Video Details Scraper Pro](https://console.apify.com/actors/kZMMAHBehLOdG2FBb/source)
- [Tiktok Profile Scraper](https://console.apify.com/actors/C9mdCvPs7mDV8AYdd/source)
- [TikTok Video Scraper](https://console.apify.com/actors/7NjipRJbS73X9Io90/source)
- [TikTok Profile Videos Scraper](https://console.apify.com/actors/F6ar6Hu5STLp5mdAf/source)
- [TikTok Profile Scraper pro](https://console.apify.com/actors/3fmkMmoCBQ4SBIIAN/source)
- [TikTok Audio Downloader 🎵](https://console.apify.com/actors/jHipu7fQihSVhBE3x/source)

### Snapchat Iteams:

- [Snapchat Video Downloader (Spotlight )](https://console.apify.com/actors/yKz99HNmn4AgmhPOf/source)
- [Snapchat Video  Details Scraper (Spotlight)](https://console.apify.com/actors/fyV48EkRqcNoeq2kH/source)
- [Snapchat Followers Scraper](https://console.apify.com/actors/PxBiNYw0mgZOagGyD/source)
- [Snapchat Profile     Scraper](https://console.apify.com/actors/siCUsZdm6xmc3g7HF/source)
- [Snapchat Profile Scraper  Mini](https://console.apify.com/actors/qhkQO51Cv6iHJxdAs/source)

### Instagram Iteams:

- [Instagram video Downloader + Scraper](https://console.apify.com/actors/zIpixF6ZjlbelQDrY/source)
- [Instagram Video Downloader (Soundlss)](https://console.apify.com/actors/QQkJuhIQp4pexakls/source)
- [Instagram Thumbnail Scraper Video & Reels](https://console.apify.com/actors/z8JOosBY8hlqiUthl/source)
- [Instagram Reels  Downloader](https://console.apify.com/actors/VRbovYCWXTZXuVaN2/source)
- [Instagram Profile URL to Username Converter & Extractor](https://console.apify.com/actors/FOApkedA1VuG6ncno/source)
- [Instagram Profile Scraper](https://console.apify.com/actors/5dvorBkg7ccX95wAg/source)
- [Instagram Post Videos Downloader](https://console.apify.com/actors/h95ZexZ0ifOX4JEYQ/source)
- [Instagram Followers Scraper](https://console.apify.com/actors/c55pdH9mCE02sj7Dg/source)
- [Instagram Audio Downloader](https://console.apify.com/actors/MQRNuEHUqKreEi8gI/source)
- [Instagram Video Scraper + Downloader](https://console.apify.com/actors/63Z5eSy3IxgdIEYOX/source)
- [Instagram Video  scraper Advanced](https://console.apify.com/actors/79ng2nukXLzUn0aWg/source)
- [Instagram Video Details  scraper](https://console.apify.com/actors/VLyBXSwQpHTFwUcds/source)
- [Instagram Reels Details scraper](https://console.apify.com/actors/oGR3xfeXTuIirhdlZ/source)
- [Instagram Followers Scraper Pro](https://console.apify.com/actors/MqW3EtUZXm6OHdvcI/source)

### Facebook Iteams:

- [Facebook reels Downloader  (Separate audio or video)](https://console.apify.com/actors/nuvIRaMeRIzz3cfxK/source)
- [Facebook Video Downloader advanced](https://console.apify.com/actors/2SU8ZuABbAVFNKMZa/source)
- [Facebook Video Details Scraper Advanced](https://console.apify.com/actors/umYouAXm92472jIdY/source)
- [Facebook Video Details Scraper](https://console.apify.com/actors/cQi4k63arffL6Cn0m/source)
- [Facebook Transcript & Subtitle scraper](https://console.apify.com/actors/hMNe1QYDOtcTc95qI/source)
- [Facebook Thumbnail Downloader Video & Reels](https://console.apify.com/actors/9SmYiqGTUia29Yd1Y/source)
- [Facebook Reels Downloader Advanced](https://console.apify.com/actors/3Zdnp9TnvltdoC44T/source)
- [Facebook Reels Details Scraper  Best and  Affordable](https://console.apify.com/actors/nuzr418MKJltywrCh/source)
- [Facebook Reels Details Scraper](https://console.apify.com/actors/OGBA89e5Ki6Y5amko/source)
- [Facebook Page Details Scraper](https://console.apify.com/actors/PL9nP9BrKDSsKwSZF/source)
- [Facebook Audio Downloader](https://console.apify.com/actors/uVrcf4OJ9VW8iCybQ/source)

### Amazon Iteams:

- [Amazon Search Scraper](https://console.apify.com/actors/YcgJR1WP1cHJhHzvH/source)
- [Amazon Product Details Scraper ](https://console.apify.com/actors/1twpltijc10KFaVeb/source)

# Actor input Schema

## `startUrls` (type: `array`):

List of one or more Snapchat Spotlight video URLs

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.snapchat.com/@rominagafur/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYaW9qcnJ2enVlAZai-N0TAZai-M2pAAAAAQ"
    },
    {
      "url": "https://www.snapchat.com/@evidenztech/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYa2F5ZWNuamdzAZRh2yZLAZRh2yY0AAAAAQ"
    }
  ]
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.snapchat.com/@rominagafur/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYaW9qcnJ2enVlAZai-N0TAZai-M2pAAAAAQ"
        },
        {
            "url": "https://www.snapchat.com/@evidenztech/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYa2F5ZWNuamdzAZRh2yZLAZRh2yY0AAAAAQ"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("alpha-scraper/snapchat-video-downloader-spotlight").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 = { "startUrls": [
        { "url": "https://www.snapchat.com/@rominagafur/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYaW9qcnJ2enVlAZai-N0TAZai-M2pAAAAAQ" },
        { "url": "https://www.snapchat.com/@evidenztech/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYa2F5ZWNuamdzAZRh2yZLAZRh2yY0AAAAAQ" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("alpha-scraper/snapchat-video-downloader-spotlight").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 '{
  "startUrls": [
    {
      "url": "https://www.snapchat.com/@rominagafur/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYaW9qcnJ2enVlAZai-N0TAZai-M2pAAAAAQ"
    },
    {
      "url": "https://www.snapchat.com/@evidenztech/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYa2F5ZWNuamdzAZRh2yZLAZRh2yY0AAAAAQ"
    }
  ]
}' |
apify call alpha-scraper/snapchat-video-downloader-spotlight --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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