# Snapchat Scraper: Profiles, Spotlight Views & Lenses (`transparent_meteorite/snapchat-scraper`) Actor

Scrape public Snapchat profiles: subscribers, bio, category, Spotlight videos with views and engagement, highlights, lenses, related accounts. No login, no API key.

- **URL**: https://apify.com/transparent_meteorite/snapchat-scraper.md
- **Developed by:** [Detroit Web Agent - Open Data](https://apify.com/transparent_meteorite) (community)
- **Categories:** Social media, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.10 / 1,000 profile scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Snapchat Scraper: Profiles, Spotlight Views & Lenses

Scrape public Snapchat profiles without a login, cookies or API key. Give it usernames or profile links and get one row per profile: display name, verified badge, subscriber count, bio, website, category, Spotlight videos with views, shares, comments and engagement rate, curated highlight stories with media links, lenses and related accounts.

It reads the public page Snapchat publishes at `snapchat.com/@<username>` for anyone who is not logged in, so there is no account, no session and no proxy to set up. One page request returns the whole profile, which keeps runs fast and cheap.

### Run in 30 seconds

1. Open the **Input** tab. The prefilled list reads 26 public profiles.
2. Click **Start**.
3. Open the **Profiles** table in the Output tab, or export as JSON, CSV or Excel.
4. Replace the usernames with your own list and run again.

### What does this Actor do?

For each username it opens the public profile page, reads the data Snapchat embeds in it and returns a clean, flat row. Spotlight videos, highlights, lenses and related accounts come as tidy lists inside the same row, so there is nothing to join.

| Group | Fields |
|---|---|
| Identity | `username`, `displayName`, `profileType`, `verified`, `businessProfileId`, `sourceUrl` |
| Audience | `subscriberCount` |
| Profile | `bio`, `websiteUrl`, `category`, `subcategory`, `address`, `publisherType`, `profilePictureUrl`, `heroImageUrl`, `snapcodeUrl` |
| Dates | `profileCreatedAt`, `profileUpdatedAt`, `lastUpdatedText`, `scrapedAt` (all ISO 8601 where a date is known) |
| Bio extras | `bioEmails`, `bioLinks`, `bioHashtags`, `bioMentions` |
| Flags | `hasStory`, `hasSpotlight`, `hasHighlights` |
| Spotlight summary | `spotlightCount`, `totalSpotlightViews`, `avgSpotlightViews`, `avgEngagementRate`, `topSpotlightUrl` |
| Spotlight videos | `spotlights[]` with `url`, `title`, `description`, `uploadedAt`, `durationSec`, `views`, `shares`, `comments`, `boosts`, `recommends`, `engagementRate`, `videoUrl`, `thumbnailUrl`, `keywords`, `hashtags`, `sound` |
| Stories | `highlights[]` (curated stories with title, snap count and every snap with media type, media link and post time) and `liveStory[]` (current story snaps when the account has one) |
| Lenses | `lenses[]` with name, creator, unlock link, preview image and video, last update |
| Network | `relatedAccounts[]` with username, display name, profile link and verified flag |
| Run | `input`, `status`, `reason` |

Every input gets a row. If a username does not exist, or the account is personal and has no public profile page, you get a **status row** (`status` is `not_found` or `no_public_profile`, with a plain-language `reason`) and you are not charged for it.

### Use cases

- **Influencer and creator marketing:** shortlist creators by subscribers, average Spotlight views and engagement rate, then pull the bio email or website for outreach.
- **Brand and competitor monitoring:** schedule a weekly run on a list of brand accounts and compare subscribers and Spotlight views from one run to the next.
- **Media and agencies:** audit official publisher accounts, their highlights and their lenses in one export.
- **Lead generation:** collect websites, emails and categories of business accounts for a niche.
- **Researchers and journalists:** snapshot public accounts and their Spotlight reach with ISO timestamps and the source link on every row.

### Limits

- Only public profiles can be read. Personal accounts without a public profile page, private accounts and Snaps shared only with friends are not available and are never requested.
- Snapchat shows a limited set of Spotlight videos and highlights on each public page (typically up to about 10 of each). The Actor returns what the page shows. It does not log in to see more.
- Subscriber counts are the numbers Snapchat shows on the page. Very large accounts may show a rounded figure.
- Media fields are links to Snapchat's own preview files. The Actor does not download videos.
- Snapchat can change its page at any time. If a field disappears, the row still returns with `null` for it and the rest of the data intact.
- Snapchat may slow requests down. The Actor retries with a pause. If a run reaches its time limit it stops cleanly and lists unread usernames in `notChecked` in the `OUTPUT` record.

### Input

| Field | What it does |
|---|---|
| `profiles` | Usernames, @handles or profile links, one per line. Duplicates are read once. |
| `maxProfiles` | Stop after this many profiles from the list. Default 100000. |

### Example input

```json
{
  "profiles": ["nasa", "https://www.snapchat.com/@therock", "@taylorswift"],
  "maxProfiles": 100
}
```

### Example output

```json
{
  "input": "nasa",
  "sourceUrl": "https://www.snapchat.com/@nasa",
  "status": "ok",
  "username": "nasa",
  "displayName": "NASA",
  "profileType": "public",
  "verified": true,
  "subscriberCount": 751400,
  "bio": "Explore the universe and discover our home planet with official NASA stories.",
  "websiteUrl": "https://www.nasa.gov",
  "category": "business-group",
  "subcategory": "government-org",
  "spotlightCount": 7,
  "totalSpotlightViews": 118000,
  "avgSpotlightViews": 16857,
  "avgEngagementRate": 0.1,
  "highlightCount": 10,
  "lensCount": 3,
  "spotlights": [
    { "title": "NASA Crew Celebrates Moon Flyby", "views": 25225, "shares": 165, "comments": 145, "boosts": 2360, "engagementRate": 0.1059, "uploadedAt": "2026-04-10T16:11:29.195Z", "videoUrl": "https://cf-st.sc-cdn.net/d/..." }
  ],
  "highlights": [{ "title": "Moon Joy", "snapCount": 9, "snaps": [{ "mediaType": "image", "mediaUrl": "https://cf-st.sc-cdn.net/d/..." }] }],
  "lenses": [{ "name": "NASA-ORION", "unlockUrl": "https://www.snapchat.com/unlock/?type=SNAPCODE&uuid=..." }],
  "relatedAccounts": [{ "username": "whitehouse", "displayName": "The White House", "verified": true }],
  "scrapedAt": "2026-11-17T12:00:00.000Z"
}
```

Values above are shortened for display. Real rows carry every field in the table.

### Pricing and cost control

Pay per profile: **$0.0018 per profile on the free plan, $0.0011 on the Gold plan** (Bronze $0.00168, Silver $0.00143), plus a $0.002 start fee per run. That is $1.80 per 1,000 profiles on the free plan. Missing usernames and personal accounts with no public profile come back as free status rows. Use **Maximum cost per run** or **Max profiles** to cap spend.

### Integrations and scheduling

Run it on a schedule to track subscribers and Spotlight views over time, then send results to Google Sheets, Slack, email, Make, Zapier or n8n with the Apify integrations, or call it through the REST API and the Python and JavaScript clients. Save your username list as a task, add a weekly schedule, and each run becomes a new dated snapshot because every row carries `scrapedAt`.

### Use with the API, n8n, Make, Zapier or AI agents

**API** (one call, returns the rows as JSON):

```bash
curl -X POST "https://api.apify.com/v2/acts/transparent_meteorite~snapchat-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" -H "Content-Type: application/json" -d '{"profiles":["nasa","therock"]}'
```

**Python**

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("transparent_meteorite/snapchat-scraper").call(run_input={"profiles": ["nasa", "therock"]})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["username"], row["subscriberCount"], row["avgSpotlightViews"])
```

- **n8n, Make, Zapier:** use the Apify app's "Run Actor" step with actor `transparent_meteorite/snapchat-scraper`, paste the input JSON, then map the dataset items to your sheet or CRM.
- **AI agents (MCP):** connect the Apify MCP server at `https://mcp.apify.com?tools=transparent_meteorite/snapchat-scraper` to Claude, Cursor or any MCP client, and your agent can run this Actor as a tool.

### Fair use and legal

The Actor reads only information Snapchat already shows publicly to visitors who are not logged in. It does not log in, use cookies, read private accounts, messages or friends-only Snaps, or get around any access control. Public profiles can still describe real people, so privacy laws such as GDPR may apply to what you collect and how you use it. Collect only what you need and respect creators' rights. This is an independent tool, not affiliated with Snap Inc.

### FAQ

**Do I need a Snapchat account or API key?** No.

**Can it read private accounts or friends-only Snaps?** No. Only public profile pages.

**Why did a username return a status row instead of data?** Either the account does not exist (`not_found`) or it is a personal account with no public profile page (`no_public_profile`). Status rows are free.

**How many Spotlight videos and stories do I get?** The ones Snapchat shows on the public page, typically up to about 10 of each, with views, shares, comments and boosts for the Spotlight videos.

**What is the engagement rate?** For each Spotlight video: (shares + comments + boosts) divided by views. The profile row also shows the average across the returned videos.

**Can I get emails?** Emails and links that the creator wrote in the public bio or website field are extracted into `bioEmails` and `bioLinks`. Nothing is guessed or looked up elsewhere.

**Does it download videos?** No. Media fields are direct links to Snapchat's own files.

**How fast is it?** About one profile per second per worker, with several profiles read in parallel.

**What if Snapchat changes its page?** Missing fields come back as `null` and the rest of the row still works. Report it on the Issues tab and it gets fixed.

### Support

Found a profile that reads badly? Open an issue on the Issues tab with the run URL and the username.

### Related actors

- [TikTok Public Profile Scraper](https://apify.com/transparent_meteorite/tiktok-public-profile-scraper) for the same creators' TikTok audience and videos.
- [Website Email Extractor](https://apify.com/transparent_meteorite/website-contact-extractor) for emails and contact details from the websites found in bios.
- [YouTube Comments Scraper](https://apify.com/transparent_meteorite/youtube-comments-scraper) for audience feedback on creators' YouTube videos.

### Changelog

- **0.1**: First private build. Profiles, subscribers, bio extras, Spotlight views and engagement, highlights, lenses, related accounts, status rows.

# Actor input Schema

## `profiles` (type: `array`):

Usernames, @handles or profile links, one per line: nasa, @therock or https://www.snapchat.com/@nasa. Only public profiles can be read. Personal accounts without a public profile are listed as a status row and not charged.

## `maxProfiles` (type: `integer`):

Stops after this many profiles from the list. Each profile is one page request.

## Actor input object example

```json
{
  "profiles": [
    "nasa",
    "therock",
    "taylorswift",
    "selenagomez",
    "nickiminaj",
    "mrbeast",
    "nba",
    "nfl",
    "kyliejenner",
    "justinbieber",
    "snoopdogg",
    "theweeknd",
    "kimkardashian",
    "cristiano",
    "khaby00",
    "cnn",
    "theddlovato",
    "itsgigihadid",
    "moonlightbae",
    "newyorkgiants",
    "pewdiepie.off",
    "guinatrevo",
    "eagles",
    "mr.beastgames",
    "kendalljenner",
    "whitehouse"
  ],
  "maxProfiles": 100
}
```

# Actor output Schema

## `profiles` (type: `string`):

No description

# 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 = {
    "profiles": [
        "nasa",
        "therock",
        "taylorswift",
        "selenagomez",
        "nickiminaj",
        "mrbeast",
        "nba",
        "nfl",
        "kyliejenner",
        "justinbieber",
        "snoopdogg",
        "theweeknd",
        "kimkardashian",
        "cristiano",
        "khaby00",
        "cnn",
        "theddlovato",
        "itsgigihadid",
        "moonlightbae",
        "newyorkgiants",
        "pewdiepie.off",
        "guinatrevo",
        "eagles",
        "mr.beastgames",
        "kendalljenner",
        "whitehouse"
    ],
    "maxProfiles": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("transparent_meteorite/snapchat-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 = {
    "profiles": [
        "nasa",
        "therock",
        "taylorswift",
        "selenagomez",
        "nickiminaj",
        "mrbeast",
        "nba",
        "nfl",
        "kyliejenner",
        "justinbieber",
        "snoopdogg",
        "theweeknd",
        "kimkardashian",
        "cristiano",
        "khaby00",
        "cnn",
        "theddlovato",
        "itsgigihadid",
        "moonlightbae",
        "newyorkgiants",
        "pewdiepie.off",
        "guinatrevo",
        "eagles",
        "mr.beastgames",
        "kendalljenner",
        "whitehouse",
    ],
    "maxProfiles": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("transparent_meteorite/snapchat-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "profiles": [
    "nasa",
    "therock",
    "taylorswift",
    "selenagomez",
    "nickiminaj",
    "mrbeast",
    "nba",
    "nfl",
    "kyliejenner",
    "justinbieber",
    "snoopdogg",
    "theweeknd",
    "kimkardashian",
    "cristiano",
    "khaby00",
    "cnn",
    "theddlovato",
    "itsgigihadid",
    "moonlightbae",
    "newyorkgiants",
    "pewdiepie.off",
    "guinatrevo",
    "eagles",
    "mr.beastgames",
    "kendalljenner",
    "whitehouse"
  ],
  "maxProfiles": 100
}' |
apify call transparent_meteorite/snapchat-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,transparent_meteorite/snapchat-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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