DEV Community

voiddo
voiddo

Posted on Originally published at voidd0.github.io

Snapchat Scraper: how to get Spotlight, Highlights as JSON or CSV (Python, API, no code)

#python #datascience #api #webscraping

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

This tutorial shows what the Actor v0iddo/snapchat-scraper returns, how to run it on the Apify Store without code, and how to call it from Python and cURL.

What data you get

One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.

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

Real rows from a run of the Actor (fields that name people are left out):

[
  {
    "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"
  },
  {
    "subscriberCount": 28584800,
    "websiteUrl": "kyliecosmetics.com",
    "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvaEJwN3Z0ZFl5NFVOeFpnWk04dXBYP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ....",
    "rowType": "spotlight",
    "videoTitle": "Spotlight Snap",
    "viewCount": 140185,
    "likeCount": 4538,
    "commentCount": 239,
    "uploadDate": "2026-09-24",
    "durationSecs": 48,
    "keywords": [
      "siblings",
      "sister love",
      "daughter"
    ],
    "thumbnailUrl": "https://cf-st.sc-cdn.net/d/kZfX0TMVEFNAuPlye1Fst.256.IRZXSOY?mo=GkYaCTIBBEgCUC5gAVCgAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miA...",
    "url": "https://www.snapchat.com/@snapchat/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZWlsa25xZHJpAaDReu8GAaDReozIAAAAAQ"
  }
]
Enter fullscreen mode Exit fullscreen mode

No code: run it on the Apify Store

  1. Open the Snapchat Scraper page on Apify.
  2. Fill in the input form. An example input is already filled in.
  3. Press Start, wait for the run to finish, and download the results as JSON, CSV or Excel from the Output tab.

The input that is pre-filled on the Actor page:

{
  "handles": [
    "kyliejenner",
    "daviddobrik"
  ],
  "includeHighlights": true,
  "maxItems": 20
}
Enter fullscreen mode Exit fullscreen mode

Ready-made examples

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

Python (apify-client)

Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/snapchat-scraper.

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {'handles': ['kyliejenner', 'daviddobrik'],
 'includeHighlights': True,
 'maxItems': 20}

run = client.actor("v0iddo/snapchat-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
Enter fullscreen mode Exit fullscreen mode

cURL 

curl -X POST "https://api.apify.com/v2/acts/v0iddo~snapchat-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"handles": ["kyliejenner", "daviddobrik"], "includeHighlights": true, "maxItems": 20}'
Enter fullscreen mode Exit fullscreen mode

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.

Price

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

FAQ

What data does the Snapchat Scraper return?

Each result is one row in an Apify dataset. Fields include handle, rowType, displayName, subscriberCount, videoTitle, viewCount, likeCount, uploadDate, and more. The table above shows every field with an example value.

Can I use it without writing code?

Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.

How much does it cost?

$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. A new Apify account gets $5 of platform credit every month.

Links

Top comments (0)