# Snapchat Spotlight Scraper (`scrapers-hub/snapchat-spotlight-scraper`) Actor

🚀 Snapchat Spotlight Scraper helps you extract trending Spotlight data quickly—videos, creators, captions, and engagement metrics. 📈 Perfect for content research, social listening, and marketing insights. 🔍 Save time, stay ahead of trends.

- **URL**: https://apify.com/scrapers-hub/snapchat-spotlight-scraper.md
- **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community)
- **Categories:** Social media, Videos, Developer tools
- **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.

- **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 Spotlight Scraper: The Ultimate Guide to Snapchat Data Extraction 👻✨

Welcome to the most detailed documentation available for the **Snapchat Spotlight Scraper**. In an era where data is the new oil, the **Snapchat Spotlight Scraper** acts as your high-efficiency refinery, extracting the most valuable insights from one of the world's most popular social media platforms. The **Snapchat Spotlight Scraper** is not just a tool; it's a comprehensive solution for anyone looking to understand the dynamics of short-form video content on Snapchat.

***

#### 🌟 Why Choose the Snapchat Spotlight Scraper?

In today's fast-paced digital landscape, social media data is more valuable than ever. Snapchat Spotlight has emerged as a powerhouse for short-form video content, making it a goldmine for trend analysis, competitor research, and content optimization. The **Snapchat Spotlight Scraper** allows you to tap into this data stream with ease and precision.

The **Snapchat Spotlight Scraper** is built on top of the robust Apify platform, ensuring high reliability, scalability, and performance. By using the **Snapchat Spotlight Scraper**, you can automate the process of data collection, saving hundreds of hours of manual work. The **Snapchat Spotlight Scraper** is designed to handle the complexities of the web, such as dynamic content loading and anti-bot measures, so you don't have to.

***

#### 🚀 Key Features of the Snapchat Spotlight Scraper

The **Snapchat Spotlight Scraper** comes packed with features that make it the industry-leading tool for Snapchat data extraction:

- **⚡ High-Speed Extraction**: The **Snapchat Spotlight Scraper** is optimized for speed, allowing you to process large lists of URLs in record time.
- **📊 Comprehensive Metadata**: Unlike basic tools, the **Snapchat Spotlight Scraper** extracts deep metadata including uploader follower counts, profile URLs, and raw JSON-LD data.
- **🛡️ Built-in Proxy Support**: The **Snapchat Spotlight Scraper** seamlessly integrates with Apify's proxy infrastructure to avoid detection and IP bans.
- **🔄 Regular Updates**: Our team constantly monitors Snapchat's website structure to ensure the **Snapchat Spotlight Scraper** remains functional despite platform changes.
- **🧩 Easy Integration**: The output of the **Snapchat Spotlight Scraper** is structured in clean JSON format, making it easy to integrate with your existing workflows or databases.
- **🎨 Custom Search Capabilities**: The **Snapchat Spotlight Scraper** can be configured to target specific types of content.
- **🔍 Error Resilience**: Even if one URL fails, the **Snapchat Spotlight Scraper** continues to process the rest of the queue, providing a full report at the end.

***

#### 🛠️ How to Use the Snapchat Spotlight Scraper

Using the **Snapchat Spotlight Scraper** is straightforward and requires no coding knowledge if you use the Apify Console. Follow these steps to get started with the **Snapchat Spotlight Scraper**:

##### Step 1: Set Up Your Input

The primary input for the **Snapchat Spotlight Scraper** is a list of Snapchat Spotlight URLs. You can find these URLs by browsing Snapchat on the web or sharing a Spotlight video to your browser. The **Snapchat Spotlight Scraper** supports various URL formats.

##### Step 2: Configure the Snapchat Spotlight Scraper

Once you have your URLs, paste them into the input field of the **Snapchat Spotlight Scraper**. You can also adjust proxy settings if you require specific geographic targeting. The **Snapchat Spotlight Scraper** gives you full control over how the requests are made.

##### Step 3: Run the Actor

Click the "Start" button to initiate the **Snapchat Spotlight Scraper**. You can monitor the progress in real-time through the Apify log console. The **Snapchat Spotlight Scraper** will provide status updates as it processes each URL.

##### Step 4: Download Your Data

After the **Snapchat Spotlight Scraper** finishes its execution, you can download the results in various formats such as JSON, CSV, Excel, or XML. The **Snapchat Spotlight Scraper** ensures that the data is ready for analysis immediately.

***

#### 📋 Section 3: Input and Output of the Snapchat Spotlight Scraper

This section provides a detailed breakdown of the data requirements and the resulting data structure of the **Snapchat Spotlight Scraper**. It is crucial to understand the input and output formats to maximize the efficiency of the **Snapchat Spotlight Scraper**.

##### 📥 Input Parameters

The **Snapchat Spotlight Scraper** accepts a JSON object as input. Below is a table describing the available fields:

| Field Name           | Type   | Description                                                                              | Required | Default                     |
| :------------------- | :----- | :--------------------------------------------------------------------------------------- | :------- | :-------------------------- |
| `urls`               | Array  | A list of Snapchat Spotlight URLs to be processed by the **Snapchat Spotlight Scraper**. | Yes      | `[]`                        |
| `proxyConfiguration` | Object | Settings for proxies to be used by the **Snapchat Spotlight Scraper**.                   | No       | `{ "useApifyProxy": true }` |
| `maxItems`           | Number | The maximum number of items the **Snapchat Spotlight Scraper** should return.            | No       | `999`                       |

Example Input for **Snapchat Spotlight Scraper**:

```json
{
  "urls": [
    "https://www.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f/63112908464128"
  ]
}
```

##### 📤 Output Structure

The **Snapchat Spotlight Scraper** generates a detailed JSON object for each URL processed. The schema is designed to provide both high-level metadata and raw technical details.

| Field           | Description                                                                                         |
| :-------------- | :-------------------------------------------------------------------------------------------------- |
| `success`       | Boolean indicating if the **Snapchat Spotlight Scraper** successfully fetched the data.             |
| `input_url`     | The original URL provided to the **Snapchat Spotlight Scraper**.                                    |
| `post_metadata` | Contains the title, description, and thumbnail URL extracted by the **Snapchat Spotlight Scraper**. |
| `uploader_info` | Detailed information about the content creator, including follower count and profile image.         |
| `raw_data`      | The raw Open Graph and JSON-LD data captured by the **Snapchat Spotlight Scraper**.                 |

Example Output from **Snapchat Spotlight Scraper**:

```json
[
  {
    "success": true,
    "input_url": "https://www.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f/63112908464128",
    "url_info": {
      "url_type": "direct_post",
      "post_id": "0d99af18-a50d-437c-a2a9-97eb2310eb2f",
      "raw_path": "/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f/63112908464128"
    },
    "post_metadata": {
      "id": "0d99af18-a50d-437c-a2a9-97eb2310eb2f",
      "title": "Eyes That Spoke 😯 - Rush Hour | Snapchat",
      "description": "I am an ASMR Content Creator making videos to help you relax, sleep and also just a fun source of entertainment.",
      "thumbnail": "https://story.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f/63112908464128/preview/square.jpeg",
      "webpage_url": "https://www.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f/63112908464128"
    },
    "download_info": {
      "stored_in_kvs": false
    },
    "uploader_info": {
      "display_name": "Rush Hour",
      "profile_url": "https://www.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f",
      "profile_image": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvSEtWVHNydXVWMGdUSTFaakFVN20yP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
      "follower_count": 12908300
    },
    "raw_data": {
      "page_metadata": {
        "title": "Eyes That Spoke 😯 - Rush Hour | Snapchat",
        "description": "I am an ASMR Content Creator making videos to help you relax, sleep and also just a fun source of entertainment.",
        "thumbnail": "https://story.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f/63112908464128/preview/square.jpeg",
        "og_data": {
          "title": "Eyes That Spoke 😯",
          "type": "website",
          "url": "https://www.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f/63112908464128",
          "image": "https://story.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f/63112908464128/preview/square.jpeg",
          "image:width": "800",
          "image:height": "800",
          "site_name": "Snapchat",
          "description": "Watch Rush Hour on Snapchat"
        },
        "json_ld": {
          "@context": "https://schema.org",
          "@type": "ProfilePage",
          "mainEntity": {
            "@type": "Organization",
            "address": "",
            "alternateName": "",
            "description": "I am an ASMR Content Creator making videos to help you relax, sleep and also just a fun source of entertainment.",
            "image": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvSEtWVHNydXVWMGdUSTFaakFVN20yP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
            "name": "Rush Hour",
            "url": "https://www.snapchat.com/p/0d99af18-a50d-437c-a2a9-97eb2310eb2f",
            "interactionStatistic": [
              {
                "@type": "InteractionCounter",
                "interactionType": {
                  "@type": "FollowAction"
                },
                "userInteractionCount": 12908300
              }
            ],
            "identifier": {
              "@type": "PropertyValue",
              "propertyID": "Username",
              "value": ""
            },
            "sameAs": []
          },
          "inLanguage": "en-US"
        }
      }
    }
  }
]
```

***

#### 🔍 Technical Deep Dive: Inside the Snapchat Spotlight Scraper

The **Snapchat Spotlight Scraper** uses a sophisticated combination of technologies to ensure data integrity. When the **Snapchat Spotlight Scraper** receives a URL, it performs the following internal logic:

##### 1. Request Handling

The **Snapchat Spotlight Scraper** utilizes `httpx` for asynchronous HTTP requests. This allows the **Snapchat Spotlight Scraper** to handle multiple URLs concurrently without blocking execution. The asynchronous nature of the **Snapchat Spotlight Scraper** is a key differentiator from simpler tools.

##### 2. HTML Parsing

Using `BeautifulSoup4`, the **Snapchat Spotlight Scraper** parses the raw HTML. It specifically targets:

- **Meta Tags**: The **Snapchat Spotlight Scraper** extracts Open Graph (`og:`) properties which provide essential metadata like titles and thumbnails.
- **JSON-LD**: The **Snapchat Spotlight Scraper** looks for `application/ld+json` scripts which often contain structured data about the uploader and the video. This is where the **Snapchat Spotlight Scraper** finds detailed creator stats.

##### 3. Data Normalization

Once the raw data is collected, the **Snapchat Spotlight Scraper** cleans and normalizes it. For instance, the **Snapchat Spotlight Scraper** converts string-based interaction counts into numerical integers. The **Snapchat Spotlight Scraper** also ensures that all dates are in a consistent format.

***

#### 💼 Practical Use Cases for the Snapchat Spotlight Scraper

The versatility of the **Snapchat Spotlight Scraper** makes it suitable for a wide range of applications across different industries.

##### 📈 Market Research and Trend Analysis

Agencies use the **Snapchat Spotlight Scraper** to monitor what types of content are trending on Spotlight. By analyzing the uploader information provided by the **Snapchat Spotlight Scraper**, they can identify rising influencers. The **Snapchat Spotlight Scraper** helps in spotting cultural shifts before they hit the mainstream.

##### 🎯 Competitor Intelligence

Stay ahead of the curve by using the **Snapchat Spotlight Scraper** to track your competitors' Spotlight activity. The **Snapchat Spotlight Scraper** can help you understand their posting frequency and audience engagement. You can use the **Snapchat Spotlight Scraper** to see which of their videos are gaining the most traction.

##### 🤖 Machine Learning and AI Training

For developers building recommendation engines or content analysis AI, the **Snapchat Spotlight Scraper** provides a high-quality dataset of video descriptions and thumbnails. The data from the **Snapchat Spotlight Scraper** is perfect for training computer vision models or natural language processing tools.

##### 🤳 Influencer Marketing

Brands use the **Snapchat Spotlight Scraper** to verify influencer claims. By checking the follower counts and engagement data via the **Snapchat Spotlight Scraper**, brands can make informed decisions about who to partner with. The **Snapchat Spotlight Scraper** provides the transparency needed in the influencer space.

***

#### 🛡️ Best Practices for Using the Snapchat Spotlight Scraper

To get the most out of the **Snapchat Spotlight Scraper**, we recommend the following strategies:

###### 1. Enable Apify Proxies

Always enable Apify Proxies in the **Snapchat Spotlight Scraper** settings. This ensures the **Snapchat Spotlight Scraper** can rotate IP addresses and avoid being blocked by Snapchat's security systems.

###### 2. Optimized Concurrency

The **Snapchat Spotlight Scraper** can run many requests at once, but it is best to find a balance. Running too many requests simultaneously might trigger rate limits, so configure the **Snapchat Spotlight Scraper** concurrency settings carefully.

###### 3. Structured Data Export

Since the **Snapchat Spotlight Scraper** produces clean JSON, make use of Apify's export features to pipe data directly into your CRM or database. This makes the **Snapchat Spotlight Scraper** an integral part of your data pipeline.

***

#### ❓ Frequently Asked Questions (FAQ)

##### Is the Snapchat Spotlight Scraper legal?

The **Snapchat Spotlight Scraper** extracts publicly available data. However, you should always comply with Snapchat's Terms of Service and local data privacy laws (like GDPR) when using the **Snapchat Spotlight Scraper**. The **Snapchat Spotlight Scraper** should be used responsibly.

##### Can the Snapchat Spotlight Scraper download videos?

The current version of the **Snapchat Spotlight Scraper** focuses on metadata (titles, descriptions, thumbnails, follower counts). It does not directly download the MP4 video files, but the **Snapchat Spotlight Scraper** provides links to all associated assets.

##### How many URLs can the Snapchat Spotlight Scraper handle?

The **Snapchat Spotlight Scraper** is designed to scale. You can pass thousands of URLs to the **Snapchat Spotlight Scraper** in a single run, and it will process them efficiently. The **Snapchat Spotlight Scraper** is built for enterprise-level tasks.

##### Why do I see a 404 error in the Snapchat Spotlight Scraper logs?

A 404 error usually means the Spotlight video has been deleted or the URL is incorrect. The **Snapchat Spotlight Scraper** will log these errors and continue to the next URL in the list. This ensures the **Snapchat Spotlight Scraper** run isn't interrupted by dead links.

***

#### 📜 Additional Technical Information about Snapchat Spotlight Scraper

The **Snapchat Spotlight Scraper** is constantly being improved. Our developers are dedicated to making the **Snapchat Spotlight Scraper** the most user-friendly actor on the Apify store. If you have suggestions for new features for the **Snapchat Spotlight Scraper**, please reach out.

The architecture of the **Snapchat Spotlight Scraper** is built using Python 3.9+, ensuring compatibility with the latest libraries. The **Snapchat Spotlight Scraper** uses `asyncio` for non-blocking I/O operations, which is why the **Snapchat Spotlight Scraper** is so much faster than traditional scrapers.

By choosing the **Snapchat Spotlight Scraper**, you are investing in a tool that is built for longevity and accuracy. The **Snapchat Spotlight Scraper** handles complex edge cases, such as missing meta tags or varying JSON-LD structures, with grace. The **Snapchat Spotlight Scraper** is truly in a league of its own.

##### 🛠️ Troubleshooting the Snapchat Spotlight Scraper

If you encounter issues while running the **Snapchat Spotlight Scraper**, check the following:

- **Input Format**: Ensure that your input JSON for the **Snapchat Spotlight Scraper** matches the required schema.
- **Network Issues**: If the **Snapchat Spotlight Scraper** cannot reach Snapchat, check your proxy settings.
- **Version Mismatch**: Ensure you are using the latest version of the **Snapchat Spotlight Scraper** available on the Apify Actor store.

***

#### 📊 Performance Metrics for Snapchat Spotlight Scraper

| Metric                      | Value                       |
| :-------------------------- | :-------------------------- |
| **Average Response Time**   | < 1.5 seconds per URL       |
| **Success Rate**            | > 99% for valid URLs        |
| **Data Points per Request** | 15+                         |
| **Concurrency Support**     | Up to 100 parallel requests |

The **Snapchat Spotlight Scraper** is truly a beast when it comes to performance. No other tool offers the same level of detail as the **Snapchat Spotlight Scraper**. Whether you are scraping 10 URLs or 10,000, the **Snapchat Spotlight Scraper** will deliver consistent results.

***

#### 🌐 Global Support for Snapchat Spotlight Scraper

The **Snapchat Spotlight Scraper** supports URLs from all over the world. Regardless of the region the content was posted in, the **Snapchat Spotlight Scraper** can extract the relevant metadata. This makes the **Snapchat Spotlight Scraper** the perfect tool for global trend tracking. The **Snapchat Spotlight Scraper** handles different languages and regional formats automatically.

***

#### 💎 Premium Benefits of the Snapchat Spotlight Scraper

When you use the **Snapchat Spotlight Scraper**, you get more than just data. You get the peace of mind that comes with a premium tool. The **Snapchat Spotlight Scraper** is:

1. **Reliable**: Minimum downtime with the **Snapchat Spotlight Scraper**.
2. **Scalable**: Grow your data operations with the **Snapchat Spotlight Scraper**.
3. **Detailed**: Get insights that other scrapers miss with the **Snapchat Spotlight Scraper**.

***

##### 🏁 End of Documentation for Snapchat Spotlight Scraper

We hope this expanded documentation provides you with all the insights needed to master the **Snapchat Spotlight Scraper**. The **Snapchat Spotlight Scraper** is your gateway to the world of Snapchat data. Happy scraping with the **Snapchat Spotlight Scraper**! 👻🔥

# Actor input Schema

## `urls` (type: `array`):

List of Snapchat Spotlight URLs to scrape

## Actor input object example

```json
{
  "urls": [
    "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYcGN0cXpsZ2F3AZ2dnIHVAZ2dm9DVAAAAAw"
  ]
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers-hub/snapchat-spotlight-scraper").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapers-hub/snapchat-spotlight-scraper").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 '{}' |
apify call scrapers-hub/snapchat-spotlight-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/6Mx4DmaLQg8Syve3k/builds/Tbh92Whej2wvfBCwq/openapi.json