# Snapchat Video Downloader (`solid-scraper/snapchat-video-downloader`) Actor 📲 Download Snapchat videos fast with our Snapchat Video Downloader! Save stories and clips in seconds, in high quality. Simple, secure, and user-friendly—perfect for creators, fans, and sharing enthusiasts. 🚀 - **URL**: https://apify.com/solid-scraper/snapchat-video-downloader.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Videos, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ready-to-run Apify actor that extracts **Snapchat Spotlight and video metadata** from a list of public Snapchat URLs—returning **direct MP4 links** plus a few useful identifiers so you can download and reuse content faster. Whether you’re a marketer, researcher, or developer looking to **download Snapchat videos**, **save Snapchat video online**, or build a **Snapchat video downloader app** workflow, this actor automates the heavy lifting at scale—saving you hours of manual work. --- ### Why choose Snapchat Video Downloader? | Feature | Benefit | | --- | --- | | ✅ **Spotlight and video URL support** | Scrapes video metadata from a list of Snapchat Spotlight or video URLs in one run | | ✅ **Built-in proxy support for reliable scraping** | Improves consistency when accessing public web data across different batches | | ✅ **Fallback extraction logic** | Uses multiple extraction approaches to pull the direct media URL when available | | ✅ **Structured output with direct `videoUrl`** | Produces clean JSON results that are easy to export and plug into downstream tools | | ✅ **Scales to batch workflows** | Process multiple URLs from `startUrls` without manual copy-paste | | ✅ **Dataset-ready results** | Pushes results to the actor dataset only when extraction succeeds | --- ### Key features - 🔍 **Direct MP4 link extraction**: Returns a `videoUrl` for each successfully processed Snapchat Spotlight/video page - 🌐 **Flexible `startUrls` input**: Feed in multiple Snapchat Spotlight or video URLs to batch-download content - 🧩 **Robust metadata parsing**: Extracts video media via JSON-LD and fallback patterns when needed - 🛡️ **Resilience with proxy support**: Uses proxy configuration to help maintain stable access to publicly available pages - 💾 **Clean JSON dataset output**: Produces a simple array of objects designed for easy analysis and export - ⚙️ **Quality selection support**: Lets you choose the desired `quality` (for example, **720p (HD)** or **1080p (Full HD)**) --- ### Input Provide input via an `input.json` file. Example structure: ```json { "startUrls": [ "https://www.snapchat.com/@tylaspacee/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYYnNjdGlrdXZnAZVCGyF8AZVCGxu-AAAAAQ" ], "quality": "480p (SD)" } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `startUrls` | Yes | List of Snapchat Spotlight or video URLs to scrape. Add one or many links you want to download (for example, Spotlight pages). | | `quality` | No | Select the desired video quality. Choose from: `360p (SD)`, `480p (SD)`, `720p (HD)`, `1080p (Full HD)`, `1440p (2K)`, `2160p (4K)`. Default is `480p (SD)`. | *** ### Output The actor returns extracted media details in a JSON array. If at least one URL is successfully processed, it pushes the collected results to the dataset. ```json [ { "id": "unknown", "url": "https://www.snapchat.com/@example/spotlight/EXAMPLE_ID", "videoUrl": "https://.../media.mp4" } ] ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `id` | string | Spotlight/video identifier extracted from the input URL path (or `unknown` if not found) | | `url` | string | The original Snapchat Spotlight/video URL used for scraping | | `videoUrl` | string | Direct media URL for the extracted video (with `\\u0026` and similar encodings normalized) | *** ### How to use Snapchat Video Downloader (via Apify Console) 1. **Open Apify Console**\ Log in at https://console.apify.com and navigate to the **Actors** tab. 2. **Find the actor**\ Search for **Snapchat Video Downloader** and open its actor page. 3. **Go to the INPUT panel**\ Use the built-in form (or switch to a JSON input) to provide your `startUrls`. 4. **Add your Snapchat Spotlight or video URLs**\ Paste one or more links into `startUrls`. These are the pages the actor will scrape to download Snapchat videos. 5. **Set video quality (optional)**\ Choose `quality` such as `720p (HD)` or `1080p (Full HD)`. If you don’t set it, the actor uses `480p (SD)`. 6. **Run the actor**\ Click **Run**. During the run, you’ll see logs indicating which URL is being scraped and whether extraction succeeds or fails. 7. **Review dataset results**\ After completion, open the **OUTPUT** tab and open the dataset created by the run. Each successful record includes `id`, `url`, and `videoUrl`—useful for workflows like Snapchat video saver and Snapchаt video link downloader. No coding required — get accurate results in minutes with Snapchat Video Downloader. *** ### Advanced features & SEO optimization - 🚀 **Engineered for Spotlight workflows**: Built specifically for Spotlight and video URL scraping so your **Snapchat story video downloader** and **Snapchat reels video downloader** use cases stay streamlined - 🔄 **Extraction fallbacks**: Improves success by attempting multiple ways to locate the direct `contentUrl` / media source when the page layout varies - 🧰 **Quality-ready input**: Includes a `quality` selector (e.g., **Snapchat video downloader HD** presets like `1080p (Full HD)` and `1440p (2K)`) for your preferred output settings - 📝 **Structured, export-friendly output**: Results are pushed as a JSON array so you can export to JSON/CSV from the dataset without reshaping fields - 🌐 **Public web data focus**: Collects from publicly accessible sources, pairing well with lead research, content archiving, and dataset building *** ### Best use cases - 📊 **Content researchers**: Download and catalog Spotlight videos by batching `startUrls` into a single run - 🎯 **Marketing teams**: Save video assets for competitor analysis and campaign inspiration with direct `videoUrl` outputs - 🧾 **Data analysts**: Build structured datasets of Snapchat media links for further processing and reporting - 💼 **Lead gen operators**: Use the scraped media link data as context for outreach lists and profiling workflows - 🛠️ **Developers**: Integrate a reliable Snapchat video downloader pipeline into automation jobs and scheduled tasks - 📱 **Creator operations**: Streamline how to download Snapchat videos for archiving or republishing workflows (when permitted) - 🔍 **Investigative teams**: Quickly assemble link-based media references from multiple public Spotlight URLs for review *** ### Technical specifications - **Supported Input Formats**\ ✅ `startUrls` (array of Snapchat Spotlight or video URLs)\ ✅ `quality` (string, one of: `360p (SD)`, `480p (SD)`, `720p (HD)`, `1080p (Full HD)`, `1440p (2K)`, `2160p (4K)`) - **Proxy Support**\ ✅ Built-in proxy configuration support for improved scraping reliability on public web pages - **Retry Mechanism**\ ❌ Not specified in the available actor code excerpt (no explicit retry counts documented here) - **Dataset Structure**\ ✅ JSON array of objects with `id`, `url`, and `videoUrl`\ ✅ Only successfully extracted results are pushed - **Rate Limits & Performance**\ ⚠️ Performance varies depending on page accessibility and network conditions; extraction is performed per URL in the provided `startUrls` list. - **Limitations**\ ❌ If the actor cannot extract a direct media URL from the page content, it will log a warning and skip that URL (no record is pushed for it) *** ### FAQ #### Can I use Snapchat Video Downloader to download Snapchat videos in batches? ✅ Yes. Provide multiple links in the `startUrls` array and the actor will process them one by one, pushing only successful results to the dataset. #### What types of links does it accept? ✅ It accepts a list of Snapchat Spotlight or video URLs in `startUrls`. These are the pages the actor scrapes to extract the direct media link. #### What video qualities are supported? ✅ The `quality` field supports: `360p (SD)`, `480p (SD)`, `720p (HD)`, `1080p (Full HD)`, `1440p (2K)`, and `2160p (4K)`. If you omit it, the default is `480p (SD)`. #### What does the actor output contain? ✅ Each successful result includes three fields: `id`, `url`, and `videoUrl`. This makes it easy to export and use in downstream workflows. #### Does it work if a video page layout changes? ✅ It includes fallback extraction logic to locate the direct media URL when the expected structured data isn’t present in the page HTML. #### Is an API key required? ✅ No—when using Apify Console, you just provide the actor input and run. For API-based usage, follow Apify’s standard actor execution model (the actor itself expects input fields described above). #### Do I need to write any code? ✅ No coding is required for basic usage in Apify Console. You can export the dataset after the run to get the `videoUrl` values. #### Where can I report issues or request improvements? You can contact support at . *** ### Support & feature requests If you’re using Snapchat Video Downloader and run into issues—or want enhancements for your Snapchat video downloader app workflow—tell us what you need. - 💡 **Feature Requests**: Ideas like additional output metadata fields, better dataset shaping, or more flexible export options can help improve how people use a Snapchat video saver at scale - 📧 **Contact**: Email - Your feedback directly shapes what we improve next for Snapchat Video Downloader. *** ### *Snapchat Video Downloader* — Final thoughts *Snapchat Video Downloader is a practical, SEO-friendly actor for extracting direct Snapchat Spotlight media links and structuring results in a JSON-ready dataset.*\ *Run it with your `startUrls`, choose your preferred `quality`, and save time compared to manual scraping every single time.* *** ### Disclaimer **This tool accesses publicly accessible sources only** and does not access private profiles, authenticated content, or password-protected data. It is your responsibility to ensure your use complies with applicable laws (including GDPR/CCPA), relevant spam regulations, and each platform’s terms of service. If you need to request data removal, contact . Please use Snapchat Video Downloader responsibly, ethically, and for legitimate purposes only. # Actor input Schema ## `startUrls` (type: `array`): List of Snapchat Spotlight or video URLs to scrape. ## `quality` (type: `string`): Select the desired video quality. ## Actor input object example ```json { "startUrls": [ "https://www.snapchat.com/@tylaspacee/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYYnNjdGlrdXZnAZVCGyF8AZVCGxu-AAAAAQ" ], "quality": "480p (SD)" } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.snapchat.com/@tylaspacee/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYYnNjdGlrdXZnAZVCGyF8AZVCGxu-AAAAAQ" ] }; // Run the Actor and wait for it to finish const run = await client.actor("solid-scraper/snapchat-video-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://www.snapchat.com/@tylaspacee/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYYnNjdGlrdXZnAZVCGyF8AZVCGxu-AAAAAQ"] } # Run the Actor and wait for it to finish run = client.actor("solid-scraper/snapchat-video-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 '{ "startUrls": [ "https://www.snapchat.com/@tylaspacee/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYYnNjdGlrdXZnAZVCGyF8AZVCGxu-AAAAAQ" ] }' | apify call solid-scraper/snapchat-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/snapchat-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Snapchat Video Downloader", "description": "📲 Download Snapchat videos fast with our Snapchat Video Downloader! Save stories and clips in seconds, in high quality. Simple, secure, and user-friendly—perfect for creators, fans, and sharing enthusiasts. 🚀", "version": "1.0", "x-build-id": "ydEIGi5yHxpBk335a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~snapchat-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-snapchat-video-downloader", "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/solid-scraper~snapchat-video-downloader/runs": { "post": { "operationId": "runs-sync-solid-scraper-snapchat-video-downloader", "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/solid-scraper~snapchat-video-downloader/run-sync": { "post": { "operationId": "run-sync-solid-scraper-snapchat-video-downloader", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Snapchat Spotlight or video URLs to scrape.", "items": { "type": "string" } }, "quality": { "title": "Video quality", "enum": [ "360p (SD)", "480p (SD)", "720p (HD)", "1080p (Full HD)", "1440p (2K)", "2160p (4K)" ], "type": "string", "description": "Select the desired video quality.", "default": "480p (SD)" } } }, "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 } } } } } } } } } } ```