# Snapchat Scraper data API: fields, sample output and cost per 1,000 rows

Scrape Snapchat public creator profiles: name, subscribers, bio, and per-video Spotlight stats: views, likes, comments, shares, upload date, duration, thumbnail.

This is the reference for the Actor `v0iddo/snapchat-scraper`: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.

## At a glance

| | |
| --- | --- |
| Actor | `v0iddo/snapchat-scraper` |
| Store page | [Snapchat Scraper](https://apify.com/v0iddo/snapchat-scraper) |
| Output | one row per result, as JSON, CSV, Excel or HTML |
| Fields per row | 18 (7 text, 6 number, 2 list, 1 URL, 1 date, 1 image URL) |
| Cap on results | `maxItems` in the input |
| Price | $1.49 per 1,000 results |

## Output fields

Each result is one row with these fields (fields that name people are left out):

| Field | Type | Meaning | Sample value |
| --- | --- | --- | --- |
| `handle` | text | Handle |  |
| `rowType` | text | Row Type | spotlight |
| `displayName` | text | Display Name |  |
| `subscriberCount` | number | Subscribers | 28584800 |
| `videoTitle` | text | Video Title | new day in the life on my youtube |
| `viewCount` | number | Views | 80341 |
| `likeCount` | number | Likes | 3292 |
| `uploadDate` | date | Upload Date | 2026-10-04 |
| `durationSecs` | number | Duration (s) | 43 |
| `highlightTitle` | text | Highlight Title |  |
| `snapCount` | number | Snaps |  |
| `thumbnailUrl` | image URL | Thumbnail | https://cf-st.sc-cdn.net/d/fP2DrQyUjHVZgWhE7sNy8.256.IRZXSOY?mo=GkY... |
| `url` | URL | Video URL | https://www.snapchat.com/@snapchat/spotlight/W7_EDlXWTBiXAEEniNoMPw... |
| `mediaUrls` | list | Photo and Video Links |  |
| `websiteUrl` | text |  | kyliecosmetics.com |
| `profilePictureUrl` | text |  | https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L... |
| `commentCount` | number |  | 190 |
| `keywords` | list |  | ["bedtime", "relaxation", "sleep"] |

## One record

```json
{
  "subscriberCount": 28584800,
  "websiteUrl": "kyliecosmetics.com",
  "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvaEJwN3Z0ZFl5NFVOeFpnWk04dXBYP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ....",
  "rowType": "spotlight",
  "videoTitle": "new day in the life on my youtube",
  "viewCount": 80341,
  "likeCount": 3292,
  "commentCount": 190,
  "uploadDate": "2026-10-04",
  "durationSecs": 43,
  "keywords": [
    "bedtime",
    "relaxation",
    "sleep"
  ],
  "thumbnailUrl": "https://cf-st.sc-cdn.net/d/fP2DrQyUjHVZgWhE7sNy8.256.IRZXSOY?mo=GkYaCTIBBEgCUC5gAVCgAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miA...",
  "url": "https://www.snapchat.com/@snapchat/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYcWVmcHNqb2p5AaEEYCyMAaEEX5T1AAAAAQ"
}
```

## Input parameters

| Parameter | Type | Required | Default | What it does |
| --- | --- | --- | --- | --- |
| `handles` | array | yes | ["kyliejenner", "daviddobrik"] | Snapchat creator handles (e.g. |
| `includeHighlights` | boolean | no | false | Adds one row for each Highlight the creator saved on the profile and one for the Story posted in the last 24 hours, if any: title, number of snaps, newest snap date, c... |
| `maxItems` | integer | no | 100 | The run stops after this many result rows. |

## Ready-made examples

Saved inputs on Apify: run one as it is, or copy it and change the values.

- [Snapchat Spotlight views of NBA, MLB and WWE](https://apify.com/v0iddo/snapchat-scraper/examples/snapchat-spotlight-nba-mlb-wwe)
- [Snapchat brand benchmark: Red Bull, MTV and Netflix](https://apify.com/v0iddo/snapchat-scraper/examples/snapchat-brand-spotlight-views-redbull-mtv-netflix)

## Cost per 1,000 rows

$1.49 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.04 per 1,000.

| Results | Cost at the listed price | Cost at the lowest plan price |
| --- | --- | --- |
| 100 | $0.15 | $0.10 |
| 1,000 | $1.49 | $1.04 |
| 10,000 | $14.90 | $10.43 |
| 100,000 | $149.00 | $104.30 |

The figures are the listed price times the number of results. The `maxItems` limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.

## Get the rows as CSV over HTTP

One request starts a run, waits for it and returns the dataset. The `format` parameter picks the file type and `fields` picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.

```bash
curl -X POST "https://api.apify.com/v2/acts/v0iddo~snapchat-scraper/run-sync-get-dataset-items?format=csv&fields=handle,rowType,displayName" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"handles": ["kyliejenner", "daviddobrik"], "includeHighlights": true, "maxItems": 20}'
```

## Good to know

- Only public Snapchat creator profiles are scraped; private accounts and unknown handles are skipped with a log message.
- Subscriber counts and view counts are as displayed on the public profile page and may be rounded by Snapchat.

## Links

- Actor on the Apify Store: [Snapchat Scraper](https://apify.com/v0iddo/snapchat-scraper)
- Guide with the Python and JavaScript code: [https://voidd0.github.io/snapchat-scraper/](https://voidd0.github.io/snapchat-scraper/)
- Step by step: [https://voiddo.com/export/snapchat-scraper/](https://voiddo.com/export/snapchat-scraper/)