# Snapchat Scraper - Profiles, Spotlight, Stories & Transcripts (`topapi/snapchat-scraper`) Actor

Scrape public Snapchat profiles from $0.90 per 1,000: exact subscribers, bio, category, website, dates, related accounts. Spotlight videos with views, shares, comments, AI title, transcripts and top comments; story and highlight snaps; hashtag and keyword discovery; monitor mode. No login.

- **URL**: https://apify.com/topapi/snapchat-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Social media, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 6 total users, 5 monthly users, 78.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 profiles

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

### What does Snapchat Scraper do?

**Snapchat Scraper** extracts public Snapchat data from [snapchat.com](https://www.snapchat.com) and turns usernames, profile links, Spotlight links, hashtags or search terms into structured rows: one row per account with its exact subscriber count, bio, category, website and creation date, one row per Spotlight video with views, shares, comments, boosts and recommends, and one row per story or highlight snap with its media link. Built for influencer marketing teams, brand and social media managers, researchers and lead-generation teams who need Snapchat numbers in a spreadsheet instead of screenshots.

Snapchat profile scraper, Snapchat Spotlight scraper, Snapchat story downloader links, Snapchat transcript extractor.

- **Exact numbers:** 752,100 subscribers, not "752.1k"; Spotlight views, shares, comments, boosts and recommends as integers; real ISO dates for profile creation, last update, uploads and snaps.
- **Four row types in one run:** profiles, Spotlight videos, live story snaps and saved highlight snaps, each switched on separately and priced separately.
- **Discovery:** Spotlight videos by hashtag (`/tag/...`, about 32 per hashtag) and public accounts by keyword (Snapchat's explore search), plus Snapchat's own related accounts.
- **Snapchat's own AI labels and captions:** AI title, AI description, topic keywords and detected language on every video; the WebVTT caption link for free and the transcript as text on request.
- **Top comments free:** up to 25 top comments per video (text, author, time, likes, replies).
- **Engagement metrics:** average, median and best views, engagement rate, posting rate and latest upload per account.
- **Monitor mode:** on a schedule, deliver only new videos and snaps, and an account row only when something changed (with the subscriber change).
- **No login, cookies or Snapchat API key:** the actor reads the pages Snapchat shows every visitor.
- **Pay only for delivered rows:** no start fee; accounts that do not exist, personal accounts, filtered rows and unreadable pages are never charged.
- **Export anywhere:** JSON, CSV, Excel, XML; schedules, webhooks, Make, Zapier, n8n, Google Sheets; callable from AI agents through the Apify API and MCP server.

### What data can you get from Snapchat?

<table>
<tr><td>👤 Username, display name (<code>title</code>)</td><td>👥 Exact subscribers (<code>subscriberCount</code>)</td><td>✅ Verified badge (<code>isVerified</code>)</td></tr>
<tr><td>🏷️ Category and subcategory (59 labels)</td><td>📝 Bio and emails found in it</td><td>🌐 Website, address</td></tr>
<tr><td>📅 Profile created and last updated</td><td>🖼️ Profile picture, hero image, Snapcode</td><td>🤝 Related accounts</td></tr>
<tr><td>🎬 Spotlight views, shares, comments, boosts, recommends</td><td>🤖 AI title, AI description, keywords, language</td><td>🎵 Sound title and author</td></tr>
<tr><td>🎥 MP4 link, thumbnail, duration, resolution</td><td>🎙️ Caption file and transcript</td><td>💬 Top comments</td></tr>
<tr><td>📖 Live story snaps</td><td>⭐ Saved highlights with every snap</td><td>🎭 Lenses</td></tr>
<tr><td>📊 Average / median / max views, engagement rate</td><td>🗓️ Posting rate, latest upload</td><td>🔁 Changed fields (monitor mode)</td></tr>
</table>

Measured on Apify runs on 2026-10-28. Over 137 public accounts found by search and related accounts: every row had its username, name, Snapcode, profile picture, creation and last-update dates; 80% had a bio, 72% a hero image, 60% a visible subscriber count (the rest hide it: `null`, never `0`), 59% a category, 49% an address and 13% a website. Over 437 Spotlight videos: every row had its views, 99% shares, comments, boosts and recommends, 97% an MP4 link, 95% keywords, 85% Snapchat's AI title and description, 80% top comments, 70% a detected language and 30% a caption file. Every one of 427 story snaps and 2,757 highlight snaps had its media link and posting time.

### How to scrape Snapchat with Snapchat Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up): $5 of monthly credit, no card needed.
2. Open [Snapchat Scraper](https://apify.com/TopApi/snapchat-scraper) and click **Try for free**.
3. Paste usernames or links into **Usernames or profile links** (or hashtags, or search terms).
4. Pick the rows you want under **Rows to deliver**: profiles are on by default; add Spotlight videos, story snaps or highlight snaps.
5. Click **Start**. Rows stream into the dataset as each page is read.
6. Open the **Storage** tab and **Export** as JSON, CSV or Excel, or let a schedule run it for you.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `usernames` | List | Usernames, @handles or profile links: `nasa`, `@kyliejenner`, `https://www.snapchat.com/add/fcbarcelona`. |
| `startUrls` | List | Profile, Spotlight video (`/spotlight/<id>`), highlight (`/@user/highlight/<id>`), hashtag (`/tag/<tag>`) or explore (`/explore/<term>`) links. |
| `hashtags` | List | Spotlight videos for each hashtag (about 32 per hashtag), always as Spotlight rows: `fitness`, `#food`. |
| `searchQueries` | List | Find public accounts by keyword on Snapchat's explore search: `pizza`, `fitness coach`. |
| `urlsFromFile` | Text | Link to a text or CSV file with one username or link per line. |
| **📋 Rows to deliver** | | |
| `scrapeProfiles` | Boolean | One row per account. Default `true`. |
| `scrapeSpotlights` | Boolean | One row per Spotlight video of each account. Default `false`. |
| `scrapeStories` | Boolean | One row per snap in the live story. Default `false`. |
| `scrapeHighlights` | Boolean | One row per snap in the saved highlights. Default `false`. |
| `nestContent` | Boolean | Keep videos, highlights (with snaps), story snaps and lenses inside the profile row. Default `true`. |
| **✂️ Refine results** | | |
| `postedAfter` / `postedBefore` | Text | Only videos and snaps in this window: `2026-10-01` or `7 days`. |
| `minViews` | Integer | Skip Spotlight videos with fewer views. |
| `minSubscribers` / `maxSubscribers` | Integer | Subscriber range for accounts (accounts that hide the count fail a minimum). |
| `verifiedOnly`, `withWebsiteOnly`, `withEmailOnly` | Boolean | Keep only verified accounts, accounts with a website, or with an email in the bio. |
| `skipPersonalAccounts` | Boolean | Skip personal (non-public) accounts. Default `false`. |
| `maxSpotlightsPerProfile`, `maxHighlightsPerProfile`, `maxStorySnapsPerProfile` | Integer | Per-account caps; `0` = everything the page shows. |
| **➕ Extra data** | | |
| `includeTranscripts` | Boolean | Spoken words of each Spotlight video as text, charged as **transcript** per video that has one. Default `false`. |
| `maxCommentsPerSpotlight` | Integer | Top comments per video, free. Default `25` (Snapchat's maximum). |
| `relatedProfilesLimit` / `maxRelatedDepth` | Integer | Also scrape Snapchat's related accounts, up to this many, this many hops deep. |
| `addCreatorSubscriberCount` | Boolean | Fill the creator's subscribers on videos found by hashtag, search or link (one extra page per new creator). |
| **🔁 Monitoring** | | |
| `monitorMode` | Boolean | Only new videos and snaps, and account rows only when they changed. Pair with a daily schedule. |
| `monitorStoreName` | Text | One name per watch list. Default `snapchat-monitor`. |
| **📦 Output** | | |
| `maxItems` | Integer | Stop after this many rows in total. `0` = no limit. |
| `maxResultsPerSearch` | Integer | Accounts (and videos) per search term. Default `20`; Snapchat returns about 25. |
| `maxSpotlightsPerHashtag` | Integer | Videos per hashtag; `0` = all shown (about 32). |
| **⚙️ Advanced** | | |
| `maxConcurrency` | Integer | Pages read at once. Default `5`. |
| `proxyConfiguration` | Proxy | Not needed; set your own proxy to use only that. |

#### Input JSON

```json
{
  "usernames": ["nasa", "fcbarcelona", "https://www.snapchat.com/add/kyliejenner"],
  "scrapeProfiles": true,
  "scrapeSpotlights": true,
  "includeTranscripts": true,
  "maxSpotlightsPerProfile": 10
}
```

Hashtag and keyword discovery in one run:

```json
{
  "hashtags": ["fitness", "food"],
  "searchQueries": ["coffee shop"],
  "maxResultsPerSearch": 10,
  "addCreatorSubscriberCount": true
}
```

#### Pick the rows before anything else

A profile row already carries the account's Spotlight videos, highlights (with every snap), story snaps and lenses, so most buyers only need profiles. Switch on **Spotlight video rows**, **story snap rows** or **highlight snap rows** when you want one spreadsheet line per video or snap. **Do:** profiles only for creator vetting · **Don't:** every row type for 1,000 accounts when you only need subscriber counts (it bills thousands of snap rows).

#### Put a hashtag in Hashtags, not in Usernames

`fitness` in **Usernames** reads the account @fitness; in **Hashtags** it reads the Spotlight videos tagged #fitness. A leading `#` in Usernames is read as a hashtag.

### ⬆️ Output

Every row has a `type`: `profile`, `spotlight`, `story` or `highlight`. The dataset has three views: **Profiles**, **Spotlight videos** and **Story and highlight snaps**.

A profile row (nested lists cut to one item here):

```json
{
  "type": "profile",
  "username": "nasa",
  "title": "NASA",
  "url": "https://www.snapchat.com/@nasa",
  "id": "cb983b26-c537-474b-9699-065309205ea2",
  "profileType": "Public Profile",
  "isVerified": true,
  "category": "Businesses & Groups",
  "subcategory": "Government Organization",
  "subscriberCount": 752100,
  "bio": "Explore the universe and discover our home planet with official NASA snaps.",
  "websiteUrl": "https://www.nasa.gov",
  "emails": [],
  "createdAt": "2019-05-22T17:38:27.554Z",
  "lastUpdatedAt": "2026-10-12T16:36:39.508Z",
  "hasActiveStory": false,
  "storySnapCount": 0,
  "highlightCount": 10,
  "highlightSnapCount": 56,
  "spotlightCount": 7,
  "spotlightTotalViews": 333402,
  "spotlightTotalShares": 1296,
  "spotlightTotalComments": 969,
  "spotlightAverageViews": 47629,
  "spotlightMedianViews": 42993,
  "spotlightMaxViews": 70011,
  "spotlightEngagementRate": 0.06918,
  "latestSpotlightAt": "2026-04-10T15:31:29.195Z",
  "spotlightsPerWeek": 0.63,
  "lensCount": 3,
  "relatedAccounts": [{ "username": "ilikerockets", "title": "Destin Smarter Every Day", "url": "https://www.snapchat.com/@ilikerockets", "isVerified": false }],
  "spotlights": [{ "id": "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ", "viewCount": 25125, "shareCount": 165, "commentCount": 125, "boostCount": 2354, "recommendCount": 120, "...": "same fields as a Spotlight row" }],
  "highlights": [{ "id": "ddf02468-ae16-4fc6-b1bc-bde7e1e22218", "title": "Moon Joy", "snapCount": 9, "latestSnapAt": "2026-04-10T15:32:54.000Z", "snaps": [{ "position": 1, "mediaType": "Video", "mediaUrl": "https://cf-st.sc-cdn.net/d/...", "postedAt": "2026-04-10T15:32:54.000Z" }] }],
  "sourceType": "input",
  "scrapedAt": "2026-10-28T04:39:48.560Z"
}
```

A Spotlight video row:

```json
{
  "type": "spotlight",
  "id": "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ",
  "url": "https://www.snapchat.com/@nasa/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ",
  "title": "NASA Crew Celebrates Moon Flyby with 'Moon Joy' & Team Rejoices",
  "aiDescription": "Witness the awe-inspiring journey of NASA astronauts aboard the International Space Station as they witness the full moon...",
  "keywords": ["astronaut", "spacewalk", "exploration", "cosmos", "NASA"],
  "language": "en",
  "creatorUsername": "nasa",
  "creatorSubscriberCount": 752100,
  "uploadedAt": "2026-04-10T15:31:29.195Z",
  "duration": "1:27",
  "width": 540,
  "height": 960,
  "viewCount": 25125,
  "shareCount": 165,
  "commentCount": 125,
  "boostCount": 2354,
  "recommendCount": 120,
  "engagementRate": 0.11001,
  "soundTitle": "Original Sound",
  "mediaUrl": "https://cf-st.sc-cdn.net/d/1z1p5kZtkBheBrRMCmyGi.27.IRZXSOY?mo=...",
  "transcriptUrl": "https://bolt-gcdn.sc-cdn.net/3/Hdz584VwuQVh7GZbqjXeQ.vtt?bo=...",
  "transcript": "It's just everything from the training, but in three dimension and absolutely unbelievable. This is incredible...",
  "comments": [{ "text": "This was an amazing mission great job to nasa for doing this I can't wait for a landing!!!", "author": "Luke", "postedAt": "2026-04-10T15:47:00.628Z", "likeCount": 34, "replyCount": 0 }],
  "commentsCollected": 24,
  "sourceType": "profile",
  "sourceQuery": "nasa"
}
```

A highlight snap row (a story snap row has the same shape with `type: "story"` and a `snapId`):

```json
{
  "type": "highlight",
  "id": "ddf02468-ae16-4fc6-b1bc-bde7e1e22218:wAUDrJs74QBAl504N3DhT",
  "url": "https://www.snapchat.com/@nasa/highlight/ddf02468-ae16-4fc6-b1bc-bde7e1e22218",
  "position": 1,
  "highlightId": "ddf02468-ae16-4fc6-b1bc-bde7e1e22218",
  "highlightTitle": "Moon Joy",
  "mediaType": "Video",
  "mediaUrl": "https://cf-st.sc-cdn.net/d/wAUDrJs74QBAl504N3DhT.1322?mo=...",
  "previewUrl": "https://cf-st.sc-cdn.net/d/wAUDrJs74QBAl504N3DhT.410?mo=...",
  "postedAt": "2026-04-10T15:32:54.000Z",
  "creatorUsername": "nasa",
  "creatorName": "NASA",
  "creatorSubscriberCount": 752100
}
```

A personal (non-public) account comes back as a profile row with `profileType: "Personal Account"`: username, display name, Snapcode and, when set, the Bitmoji avatar. Everything else is `null`, and the row is free.

### How much does it cost to scrape Snapchat?

Pay per event, no start fee, no monthly rent:

| Event | Price | Per 1,000 |
|---|---|---|
| Profile row | $0.0009 | $0.90 |
| Spotlight video row | $0.00027 | $0.27 |
| Story or highlight snap row | $0.00081 | $0.81 |
| Transcript (add-on, only with `includeTranscripts`) | $0.00063 | $0.63 |

Comments, caption links, nested videos and snaps inside a profile row, related accounts and lenses are included. Speed on Apify: 3 accounts in about 2 seconds; 137 accounts in 65 seconds; 30 accounts with every Spotlight video, story snap and highlight snap as rows (3,698 rows) in 26 seconds. Examples: 1,000 accounts as profile rows = $0.90. 100 creators with their ~10 latest Spotlight videos as rows = $0.09 + $0.27 = $0.36. Personal (non-public) accounts are listed free. Accounts that do not exist, rows removed by your filters, and pages that could not be read are not charged. Set **Maximum cost per run** in the run options and the actor stops at that amount.

### Run it on a schedule

1. Save your input as a task, switch on **Monitor mode** and give the watch list a **Monitor store name** (e.g. `brands-weekly`).
2. Add a schedule (Console > Schedules), e.g. every morning at 8:00.
3. Each run delivers only Spotlight videos and snaps it has not delivered before, and an account row only when its subscribers, bio, website, category, story or newest video changed, with `changeType`, `changedFields`, `previousSubscriberCount` and `subscriberChange`.
4. Send the rows on with a webhook, or read them from the API:

```bash
curl -X POST "https://api.apify.com/v2/acts/TopApi~snapchat-scraper/run-sync-get-dataset-items?token=<YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["nasa", "nba"], "scrapeSpotlights": true, "monitorMode": true, "monitorStoreName": "space-weekly"}'
```

AI agents can call it as a tool through Apify's MCP server (`https://mcp.apify.com`).

### Limits

- **Spotlight videos per account:** Snapchat's public page shows an account's most recent Spotlight videos (we measured 2 to 31 per account; `moreSpotlightsOnSnapchat` is `true` when Snapchat holds older ones). Older videos are not on any public page; a daily monitor run builds the history.
- **Highlights:** the profile page lists the first page of saved highlights, each with every snap; `moreHighlightsOnSnapchat` says when there are more. A highlight link reads that highlight in full.
- **Comments:** Snapchat publishes the top 25 comments of each video; `commentCount` is the true total.
- **Transcripts:** only videos Snapchat captioned carry a caption file (30% of the 437 videos we read).
- **Hashtags and searches:** a hashtag page shows about 32 videos; a search shows about 25 accounts.
- **Media links are signed by Snapchat** and expire; download the files soon after the run.
- **Personal accounts** show only a username, display name, Snapcode and Bitmoji to visitors; stories of personal accounts are not public.
- Not shipped because Snapchat's public pages never fill them (empty on every snap, video and account of a 3,656-row run): a sponsored flag, overlay and attachment links, snap location, profile theme colour and publisher type.

### FAQ

**Do I need a Snapchat account, cookie or API key?**
No. The actor reads the pages Snapchat shows any visitor of a public profile.

**Which links work?**
`snapchat.com/add/<user>`, `snapchat.com/@<user>`, `story.snapchat.com/@<user>`, Spotlight links (`/spotlight/<id>` or `/@<user>/spotlight/<id>`), highlight links (`/@<user>/highlight/<id>`), hashtag links (`/tag/<tag>`) and explore links (`/explore/<term>`).

**Why is `subscriberCount` null for some accounts?**
The account hides its count. The actor writes `null`, never a fake `0`.

**What are `aiTitle`, `aiDescription` and `keywords`?**
Labels Snapchat itself generates for each Spotlight video. They are passed through as Snapchat publishes them.

**How do transcripts work?**
Every captioned video carries a link to Snapchat's own WebVTT caption file (`transcriptUrl`, free). With **Spotlight transcripts** on, the actor downloads it and writes the spoken words as plain text in `transcript`, charged once per video.

**Can I get followers or friends of an account?**
No. Snapchat does not show follower lists to visitors.

**What is "related accounts"?**
The accounts Snapchat suggests on a profile page. Each row lists them; `relatedProfilesLimit` also scrapes them as rows.

**How fresh is the data?**
Live: every run reads the pages at that moment. Stories expire after 24 hours, so schedule story runs.

**Can I get the video files?**
The rows carry direct MP4 and image links (`mediaUrl`); download them with any HTTP client.

**What happens with a username that does not exist?**
It is listed in the run summary (`RUN_SUMMARY` in the key-value store) and not charged.

### More scrapers from TopApi

- [Instagram Profile Scraper](https://apify.com/TopApi/instagram-profile-scraper): followers, bio and posts of Instagram accounts.
- [TikTok Scraper](https://apify.com/TopApi/tiktok-scraper): TikTok videos, profiles and hashtags.
- [YouTube Shorts Scraper](https://apify.com/TopApi/youtube-shorts-scraper): Shorts with views, likes and channel data.
- [X Profile Scraper](https://apify.com/TopApi/x-profile-scraper): X (Twitter) profiles and follower counts.

Questions or a missing field? Open an issue on the **Issues** tab with your run ID.

# Actor input Schema

## `usernames` (type: `array`):

Public Snapchat accounts: bare usernames, @handles or profile links, e.g. "nasa", "@kyliejenner", "https://www.snapchat.com/add/fcbarcelona".

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

Profile, Spotlight video, highlight, hashtag (/tag/...) or explore links, e.g. "https://www.snapchat.com/spotlight/W7_EDlXW...", "https://www.snapchat.com/@nasa/highlight/<id>".

## `hashtags` (type: `array`):

Spotlight videos for each hashtag (about 32 per hashtag), e.g. "fitness", "#food". Always delivered as Spotlight video rows.

## `searchQueries` (type: `array`):

Keywords to find public accounts on Snapchat's explore search, e.g. "pizza", "fitness coach". Each account found is scraped like a username.

## `urlsFromFile` (type: `string`):

Link to a plain text or CSV file with one username or Snapchat link per line (e.g. a Google Sheets CSV export link).

## `scrapeProfiles` (type: `boolean`):

One row per account: subscribers, bio, category, website, dates, Spotlight totals, plus its Spotlight videos, highlights, story and lenses nested inside.

## `scrapeSpotlights` (type: `boolean`):

One row per Spotlight video of each account: views, shares, comments, boosts, recommends, AI title and description, sound, MP4 link, top comments.

## `scrapeStories` (type: `boolean`):

One row per snap in each account's live public story (stories expire after 24 hours).

## `scrapeHighlights` (type: `boolean`):

One row per snap in each account's saved highlights, with the highlight's title.

## `nestContent` (type: `boolean`):

Keep the Spotlight videos, highlights (with every snap), story snaps and lenses inside the profile row. Off = profile fields and totals only.

## `postedAfter` (type: `string`):

Only videos and snaps posted on or after this date: "2026-10-01" or relative like "7 days", "24 hours". Pairs with a daily schedule.

## `postedBefore` (type: `string`):

Only videos and snaps posted on or before this date, e.g. "2026-10-31".

## `minViews` (type: `integer`):

Skip Spotlight videos with fewer views. 0 = no minimum.

## `minSubscribers` (type: `integer`):

Skip accounts with fewer subscribers (accounts that hide the count are skipped too). 0 = no minimum.

## `maxSubscribers` (type: `integer`):

Skip accounts with more subscribers, e.g. 100000 for micro-creators. Empty or 0 = no maximum.

## `verifiedOnly` (type: `boolean`):

Only accounts with Snapchat's verified badge.

## `withWebsiteOnly` (type: `boolean`):

Only accounts that list a website.

## `withEmailOnly` (type: `boolean`):

Only accounts whose bio or website field carries an email address.

## `skipPersonalAccounts` (type: `boolean`):

Personal (non-public) accounts only show a username, display name and Snapcode; they are listed free. On = they are left out.

## `maxSpotlightsPerProfile` (type: `integer`):

Most recent Spotlight videos kept per account (rows and nested). Snapchat shows up to about 30. 0 = all shown.

## `maxHighlightsPerProfile` (type: `integer`):

Saved highlights kept per account, in Snapchat's order, each with all its snaps. 0 = all on the profile page.

## `maxStorySnapsPerProfile` (type: `integer`):

Snaps of the live story kept per account. 0 = all.

## `includeTranscripts` (type: `boolean`):

Add the spoken words of each Spotlight video as plain text, from Snapchat's own caption file. Charged per transcript delivered ($0.00063). The caption link is always free.

## `maxCommentsPerSpotlight` (type: `integer`):

Top comments attached to each video (text, author, time, likes, replies). Snapchat publishes up to 25. 0 = none. Free.

## `relatedProfilesLimit` (type: `integer`):

Also scrape the accounts Snapchat lists as related ("Popular accounts like this"), up to this many in total. 0 = off.

## `maxRelatedDepth` (type: `integer`):

1 = related accounts of your accounts; 2 = also their related accounts, and so on.

## `addCreatorSubscriberCount` (type: `boolean`):

Fill creatorSubscriberCount on videos found by hashtag, search or link (one extra page per new creator). Videos read from a profile always carry it.

## `monitorMode` (type: `boolean`):

Deliver only Spotlight videos and snaps not delivered by earlier runs, and profile rows only when something changed (subscribers, bio, website, new video...). Pairs with a daily schedule.

## `monitorStoreName` (type: `string`):

Named key-value store that remembers what was delivered. Use one name per watch list, e.g. "brands-weekly".

## `maxItems` (type: `integer`):

Stop after this many rows in total (all row types). 0 = no limit.

## `maxResultsPerSearch` (type: `integer`):

Accounts taken from each search term (Snapchat returns about 25), and Spotlight videos too when Spotlight rows are on.

## `maxSpotlightsPerHashtag` (type: `integer`):

Spotlight videos taken from each hashtag page (Snapchat shows about 32). 0 = all shown.

## `maxConcurrency` (type: `integer`):

Pages read at the same time.

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

Not needed: the run uses Apify's own connection first and Apify proxy only if Snapchat refuses it. Set your own proxy here to use only that.

## Actor input object example

```json
{
  "usernames": [
    "nasa",
    "fcbarcelona",
    "nba"
  ],
  "scrapeProfiles": true,
  "scrapeSpotlights": false,
  "scrapeStories": false,
  "scrapeHighlights": false,
  "nestContent": true,
  "verifiedOnly": false,
  "withWebsiteOnly": false,
  "withEmailOnly": false,
  "skipPersonalAccounts": false,
  "includeTranscripts": false,
  "maxCommentsPerSpotlight": 25,
  "relatedProfilesLimit": 0,
  "maxRelatedDepth": 1,
  "addCreatorSubscriberCount": false,
  "monitorMode": false,
  "monitorStoreName": "snapchat-monitor",
  "maxResultsPerSearch": 20,
  "maxConcurrency": 5
}
```

# Actor output Schema

## `results` (type: `string`):

One item per account (type "profile"), per Spotlight video ("spotlight") and per story or highlight snap ("story", "highlight").

## `summary` (type: `string`):

Rows delivered per type, accounts not found or filtered out (not charged), links not read, requests per route.

# 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 = {
    "usernames": [
        "nasa",
        "fcbarcelona",
        "nba"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/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 = { "usernames": [
        "nasa",
        "fcbarcelona",
        "nba",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("topapi/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 '{
  "usernames": [
    "nasa",
    "fcbarcelona",
    "nba"
  ]
}' |
apify call topapi/snapchat-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/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/CUjpArOApE6vuJjGS/builds/YVlD2csC2R7KGedmz/openapi.json
