# Snapchat Scraper — Profiles, Stories, Spotlights & Lenses (`brilliant_gum/snapchat-scraper`) Actor

Scrape public Snapchat profiles: display name, snapcode, bio, subscribers, category, website, stories, spotlights (views/hashtags), highlights, lenses, related accounts + analytics. No login.

- **URL**: https://apify.com/brilliant\_gum/snapchat-scraper.md
- **Developed by:** [Yuliia Kulakova](https://apify.com/brilliant_gum) (community)
- **Categories:** Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.007 / profile scraped

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/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

![Snapchat Scraper](https://api.apify.com/v2/key-value-stores/IuFu0Cw6PpOkNkDV7/records/snapchat-banner)

Scrape **public Snapchat profiles** and their public content without logging in. Give it a list of usernames or profile URLs and get structured data: profile metadata, subscriber counts, stories, spotlights (with view counts and hashtags), curated highlights, AR lenses, related accounts, and a ready-made analytics summary.

### What it scrapes

For each public profile (`https://www.snapchat.com/add/<username>`):

- **Profile:** display name, handle, verified badge, category & subcategory, subscriber count, bio, location, website, avatar, snapcode, business profile id, linked social accounts, creation/last-update timestamps.
- **Stories:** public Story snaps — media URL, preview URL, media type, timestamp.
- **Spotlights:** each highlight with **view count**, share count, duration, dimensions, hashtags, keywords, creator, context cards, and its snaps.
- **Curated highlights:** saved Story highlights and their snaps.
- **Lenses:** creator AR lenses — name, preview image/video, icon, unlock URL.
- **Related accounts:** suggested public accounts with subscriber counts.
- **Analytics:** totals, total/average/max spotlight views, unique + top hashtags.

### Input

| Field | Type | Description |
|---|---|---|
| `profiles` | array (required) | Usernames or profile URLs, e.g. `fcbarcelona` or `https://www.snapchat.com/add/nba`. |
| `includeStories` | boolean | Include public Story snaps (default `true`). |
| `includeSpotlights` | boolean | Include Spotlight highlights + metadata (default `true`). |
| `includeHighlights` | boolean | Include curated highlights (default `true`). |
| `includeLenses` | boolean | Include creator lenses (default `true`). |
| `includeRelatedAccounts` | boolean | Include related accounts (default `true`). |
| `maxSnapsPerItem` | integer | Cap snaps per story/spotlight/highlight, `0` = all. |
| `computeAnalytics` | boolean | Attach analytics summary (default `true`). |
| `maxConcurrency` | integer | Parallel requests (default `10`). |
| `proxyConfiguration` | object | Apify Proxy (datacenter by default; residential selectable). |

### Output (per profile)

Includes simple flat keys (`profileUrl`, `username1`, `username2`, `profileImageUrl`, `profileDescription`, `profileLocation`, `subscribers`, `category`, `websiteUrl`, `snapcodeImageUrl`, `stories`, `spotlights`) **plus** the extras listed above (`verified`, `subcategory`, `subscribersCount`, `curatedHighlights`, `lenses`, `relatedAccounts`, `sameAsLinks`, `links`, `analytics`, timestamps, and richer per-snap / per-spotlight fields).

Non-public results are still reported: personal accounts get `profileType: "personal"`, and missing handles get `profileType: "not_found"`.

**Note on subscriber counts:** Snapchat publishes a subscriber count for many creator/brand profiles but not all; when a profile does not display one, `subscribers` is `0`. Counts that are shown are returned exactly as Snapchat reports them.

### Pricing

This actor runs on a **pay-per-event** model:

- **Actor start** — $0.01, charged once when a run starts.
- **Profile scraped** — $0.007 per public profile delivered, including its stories, spotlights, curated highlights, lenses, related accounts and analytics.

Personal accounts, not-found handles and error records are **not** charged. There is no monthly rental — you pay only for the public profiles a run actually returns.

### Support & feedback

Found a rough edge or need another field? Open an issue on the actor's **Issues** tab — requests and bug reports are welcome and shape the roadmap. If this actor saves you time, a rating on the Store page genuinely helps.

### Notes

Only public, unauthenticated profile pages are read — the same content a logged-out visitor sees. No login, cookies, or private data. Respect Snapchat's Terms of Service and applicable law.

# Actor input Schema

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

One or more Snapchat usernames or profile URLs to scrape. Accepts plain handles (e.g. fcbarcelona) or full URLs (e.g. https://www.snapchat.com/add/fcbarcelona or https://www.snapchat.com/@fcbarcelona).

## `includeStories` (type: `boolean`):

Scrape the profile's public Story snaps (media URLs, previews, timestamps).

## `includeSpotlights` (type: `boolean`):

Scrape Spotlight highlights together with their metadata (view counts, hashtags, creator, duration).

## `includeHighlights` (type: `boolean`):

Scrape curated Story highlights saved on the profile (extra).

## `includeLenses` (type: `boolean`):

Scrape the creator's AR Lenses (name, preview image/video, unlock URL) (extra).

## `includeRelatedAccounts` (type: `boolean`):

Include related/suggested public accounts shown on the profile (extra).

## `maxSnapsPerItem` (type: `integer`):

Maximum number of snaps to keep per story, spotlight or highlight. Use 0 for no limit.

## `computeAnalytics` (type: `boolean`):

Attach a per-profile analytics summary (totals, spotlight views, average views, hashtags) (extra).

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

Maximum number of profiles fetched in parallel.

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

Apify Proxy configuration. Uses Apify Proxy (datacenter) by default; you can select a residential group here if you need it.

## Actor input object example

```json
{
  "profiles": [
    "fcbarcelona",
    "https://www.snapchat.com/add/nba"
  ],
  "includeStories": true,
  "includeSpotlights": true,
  "includeHighlights": true,
  "includeLenses": true,
  "includeRelatedAccounts": true,
  "maxSnapsPerItem": 0,
  "computeAnalytics": true,
  "maxConcurrency": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

Link to the default dataset items.

# 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": [
        "fcbarcelona",
        "kyliejenner"
    ]
};

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

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

```

## MCP server setup

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