# Snapchat Vedio Downloder (`datapilot/snapchat-vedio-downloder`) Actor

Just provide the video link. Title, direct URL, thumbnail — all data will be collected and stored directly in your Apify dataset.

Works with residential proxies for stable and reliable scraping.

Fast, accurate, and simple — optimized for video data extraction from Pinterest.

- **URL**: https://apify.com/datapilot/snapchat-vedio-downloder.md
- **Developed by:** [Data Pilot](https://apify.com/datapilot) (community)
- **Categories:** Videos
- **Stats:** 6 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$10.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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

🚀 **Snapchat Video Downloader** is a specialized Apify Actor designed to download **Snapchat Video content** directly from Snapchat URLs. This tool extracts direct video links, thumbnails, and metadata from **Snapchat Video URLs**, enabling easy access to **Snapchat Video content** for research, archiving, or personal use. Whether you're analyzing Snapchat Video trends, saving content, or building media libraries, the Snapchat Video Downloader delivers **Snapchat Video data** efficiently.

With residential proxy support, the Snapchat Video Downloader ensures reliable and undetected downloading of **Snapchat Video content**. It focuses on key **Snapchat Video metrics** like direct URLs, thumbnails, and audio presence, making it an essential tool for **Snapchat Video analysis** and content downloading.

### 🔥 Features

- **Direct Snapchat Video Extraction** – Downloads direct links to **Snapchat Video content** from provided URLs for easy access.
- **Metadata Retrieval** – Extracts **Snapchat Video titles**, thumbnails, and audio information for comprehensive **Snapchat Video data**.
- **Residential Proxy Support** – Uses Apify's residential proxies to bypass restrictions and ensure high success rates for **Snapchat Video downloading**.
- **Error Handling** – Robust logging and fallback mechanisms for failed **Snapchat Video downloads**.
- **Single URL Processing** – Processes one **Snapchat Video URL** per run for precise **Snapchat Video results**.
- **Dataset Integration** – Automatically uploads **Snapchat Video data** to your Apify dataset for easy export and analysis.

---

### ⚙️ How It Works

The Snapchat Video Downloader takes a **Snapchat Video URL** as input and uses  to extract metadata and direct video links without downloading the full content initially. It configures  with residential proxies and custom headers to handle **Snapchat Video extraction** reliably. The downloader returns direct links and metadata on success or error details on failure, providing a fast way to access **Snapchat Video content**.

**Key benefits for Snapchat Video analysis:**

- Quickly retrieve Snapchat Video direct links for viewing or downloading.
- Analyze Snapchat Video metadata like titles and thumbnails.
- Build Snapchat Video archives for content research.
- Track Snapchat Video availability and status.
- Extract Snapchat Video URLs for batch processing.

---

### 📥 Input

The Actor accepts the following input parameters:

| Field                  | Type   | Default                                               | Description |
|------------------------|--------|-------------------------------------------------------|-------------|
| `url`                  | string | required                                              | The Snapchat Video URL to download (e.g., `"https://www.snapchat.com/..."`). |
| `proxyConfiguration`   | object | `{"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}` | Proxy settings, including useApifyProxy and apifyProxyGroups. |

**Example input JSON:**

```json
{
  "url": "https://www.snapchat.com/example-video",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
````

***

### 📤 Output

The downloader outputs **Snapchat Video metadata** and direct links in JSON format. Each record includes:

| Field          | Type   | Description |
|----------------|--------|-------------|
| `title`        | string | Title of the Snapchat Video. |
| `direct_url`   | string | Direct URL to the Snapchat Video content. |
| `thumbnail`    | string | Thumbnail image URL for the Snapchat Video. |
| `music`        | string | Indicates if the Snapchat Video has audio (`"Yes"` or `"No"`). |
| `status`       | string | Status of the Snapchat Video download (success or error message). |
| `url`          | string | Original Snapchat Video URL provided. |
| `fetched_at`   | string | ISO timestamp of the download attempt. |

**Example output for a successful Snapchat Video download:**

```json
{
  "title": "Snapchat Video",
  "direct_url": "https://example.com/video.mp4",
  "thumbnail": "https://example.com/thumbnail.jpg",
  "music": "Yes",
  "status": "Success! Link is active.",
  "url": "https://www.snapchat.com/example-video",
  "fetched_at": "2025-02-14T12:00:00Z"
}
```

**Example error response:**

```json
{
  "url": "https://www.snapchat.com/invalid-video",
  "status": "Error: Unable to extract video link",
  "error": "Video not accessible or has been deleted",
  "fetched_at": "2025-02-14T12:00:00Z"
}
```

***

### 🧰 Technical Stack

- \*\*Core Library:\*\*universal video extraction tool supporting Snapchat.
- **Proxy:** Apify Proxy with RESIDENTIAL support for reliable access.
- **Platform:** Apify Actor – serverless, scalable, integrated with Dataset and Key‑Value Store.
- **Deployment:** One‑click run on Apify Console or via REST API.

***

### 🎯 Use Cases

- **Snapchat Video Archiving** – Save Snapchat Videos for personal archiving and backup.
- **Content Research** – Analyze Snapchat Video content and metadata for research purposes.
- **Snapchat Story Saving** – Extract and save Snapchat Story videos for later viewing.
- **Media Library Building** – Build personal or professional media libraries with Snapchat content.
- **Snapchat Analytics** – Analyze Snapchat Video metrics and trends.
- **Educational Content** – Save educational or tutorial Snapchat Videos.
- **Marketing Research** – Analyze Snapchat Video marketing campaigns and content.
- **Influencer Analysis** – Track Snapchat Video content from influencers.
- **Social Media Research** – Collect Snapchat Video data for social media studies.
- **Personal Documentation** – Document personal events captured on Snapchat.
- **Content Backup** – Create backups of important Snapchat Video content.
- **Creative Projects** – Use Snapchat Videos as source material for creative projects.
- **Brand Monitoring** – Monitor brand-related Snapchat Video content.
- **News and Events** – Archive newsworthy Snapchat Videos from events.

***

### 🚀 Quick Start

1. **Open in Apify Console** – visit the Actor page and click Try for free.
2. **Enter a Snapchat Video URL** in the input field.
3. **Enable residential proxies** – enabled by default for reliable extraction.
4. **Click Start** – the Actor will extract Snapchat Video metadata and direct links.
5. **View Results** – check the dataset for video information and download links.
6. **Export** – download the results as JSON, CSV, or Excel.

You can also call this Actor programmatically via Apify SDK or REST API – ideal for automated Snapchat Video content downloading and archiving.

***

### 💎 Why This Actor?

| Feature | Benefit |
|---------|---------|
| ✅ Direct link extraction | Get direct video URLs without full downloads. |
| ✅ Metadata extraction | Receive titles, thumbnails, and audio information. |
| ✅ Residential proxies | Bypass restrictions – reliable Snapchat access. |
| ✅ Fast extraction | Get links quickly without downloading full videos. |
| ✅ Error handling | Robust fallback mechanisms for reliability. |
| ✅ Easy archiving | Save Snapchat content efficiently. |
| ✅ Batch processing | Process one URL per run with option to chain multiple runs. |
| ✅ Apify ecosystem | Seamless integration with other Actors, triggers, and webhooks. |

### 📦 Changelog

- Initial release with Snapchat Video downloading and extraction.
- Direct video link extraction from Snapchat URLs.
- Metadata extraction (titles, thumbnails, audio presence).
- Residential proxy support for reliable access.
- Error handling with detailed error messages.
- Single URL processing with timestamp tracking.
- Automatic dataset integration.
- Full Apify Actor integration.

***

### 🧑‍💻 Support & Feedback

- **Issues & Ideas:** Open a ticket on the Apify Actor issue tracker.
- **Documentation:** Visit Apify Docs for platform guides.
- **Community:** Join the Apify community forum for discussions and support.

***

### 💰 Pricing

- **Free** for basic usage on Apify platform.
- **Paid plans** available for higher limits and priority support.
- Proxy credits consumed based on residential proxy usage.

# Actor input Schema

## `url` (type: `string`):

Paste your Snapchat link here

## `proxyConfiguration` (type: `object`):

Select Residential Proxy to avoid blocking

## Actor input object example

```json
{
  "url": "https://www.snapchat.com/spotlight/...",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "url": "https://www.snapchat.com/spotlight/..."
};

// Run the Actor and wait for it to finish
const run = await client.actor("datapilot/snapchat-vedio-downloder").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 = { "url": "https://www.snapchat.com/spotlight/..." }

# Run the Actor and wait for it to finish
run = client.actor("datapilot/snapchat-vedio-downloder").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 '{
  "url": "https://www.snapchat.com/spotlight/..."
}' |
apify call datapilot/snapchat-vedio-downloder --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Snapchat Vedio Downloder",
        "description": "Just provide the video link. Title, direct URL, thumbnail — all data will be collected and stored directly in your Apify dataset.\n\nWorks with residential proxies for stable and reliable scraping.\n\nFast, accurate, and simple — optimized for video data extraction from Pinterest.",
        "version": "0.0",
        "x-build-id": "zZWq7x5ARNch2PWRO"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/datapilot~snapchat-vedio-downloder/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-datapilot-snapchat-vedio-downloder",
                "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/datapilot~snapchat-vedio-downloder/runs": {
            "post": {
                "operationId": "runs-sync-datapilot-snapchat-vedio-downloder",
                "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/datapilot~snapchat-vedio-downloder/run-sync": {
            "post": {
                "operationId": "run-sync-datapilot-snapchat-vedio-downloder",
                "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": [
                    "url"
                ],
                "properties": {
                    "url": {
                        "title": "Snapchat URL",
                        "type": "string",
                        "description": "Paste your Snapchat link here"
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Select Residential Proxy to avoid blocking",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
