🟡 Snapchat - Profile - Scraper 🟡 — Apify Actor

Easily scrape public Snapchat profile data in seconds using this Apify actor! ⚡ Extract verified account info, stats, links, and profile details — all neatly stored in structured JSON output. Perfect for data analysis, marketing, or research.

---

📌 Actor Overview

🧠 Snapchat Profile Scraper (Advanced) is a production-grade Apify Actor designed to extract rich, structured metadata from public Snapchat profile pages. It is built for reliability, scalability, and real-world automation workflows, making it suitable for data teams, growth analysts, OSINT researchers, and SaaS integrations.

🚀 This actor supports single or bulk profile scraping, automatically normalizes usernames or URLs, intelligently extracts embedded JSON data from Snapchat’s frontend, and stores results in Apify Datasets and Key-Value Store for easy downstream consumption.

---

🧩 What This Actor Does

🔍 This actor visits public Snapchat profile pages and extracts:

• 🧾 Profile identity metadata (username, display name, title)
• 🖼️ Profile & hero images
• 📝 Bio / description text
• 🏷️ Account category & subcategory
• 👥 Subscriber / follower count (when publicly available)
• 🏅 Badges & publisher type
• 🎨 Branding information (primary color, hero images)
• 🕒 Account creation & last update timestamps
• 📍 Location / address data (if exposed)
• 🔎 Story & highlight availability flags

---

✨ Key Features

• 🔗 Flexible Input Handling — Accepts usernames, profile URLs, or mixed lists
• 🧠 Automatic Username Normalization — Handles @username, URLs, and raw names
• 🧬 Deep JSON Extraction Engine — Parses embedded Next.js, SSR, and inline JS data
• 🛡️ Proxy-Aware Architecture — Supports Apify Proxy with residential fallback
• ⚡ Concurrent Scraping — Configurable concurrency with rate control
• 🧾 Structured Output — Clean, normalized JSON for analytics-ready pipelines
• ☁️ Apify-Native Storage — Pushes data to Dataset and KV Store automatically
• 🧩 Error-Resilient Design — Partial failures don’t stop the entire run

---

🔄 How the Actor Works (Step-by-Step)

1️⃣ Input Parsing

• 📥 Reads usernames from usernames, username, or startUrls
• 🔄 Normalizes all inputs into canonical Snapchat usernames

2️⃣ Request Preparation

• 🌐 Builds multiple Snapchat profile URL variants
• 🧭 Configures headers, timeouts, and proxy routing

3️⃣ HTML Fetching

• 📄 Downloads profile HTML with redirect handling
• 🔁 Retries via alternative URLs if needed

4️⃣ Data Extraction

• 🧬 Parses <meta> tags for basic metadata

• 📦 Extracts JSON blobs from:

  • __NEXT_DATA__
  • application/ld+json
  • Inline JavaScript state objects

5️⃣ Field Normalization

• 🧹 Cleans numbers, timestamps, URLs, and strings
• 🕒 Converts epoch times to ISO-8601 UTC format

6️⃣ Result Storage

• 📊 Pushes each profile to the Apify Dataset
• 🗂️ Saves full aggregated output to KV Store (OUTPUT key)

---

🧾 Input Parameters

🔑 Field	📘 Type	📌 Required	📝 Description
🟢 usernames	array[string]	✅ Yes	List of Snapchat usernames or profile URLs to scrape
🌐 proxyConfiguration	object	❌ No	Apify proxy settings (recommended for scale)
⚡ concurrency	number	❌ No	Number of profiles scraped in parallel (default: 5)
⏱️ requestDelay	number	❌ No	Delay (seconds) between requests per task (default: 0.5)

---

⚙️ Multipule Input Smaple :

The actor accepts the following input fields:

{
    "usernames": [
        "https://www.snapchat.com/@realmadrid",
        "https://www.snapchat.com/@mohsenalnssar",
        "s_kramarzz",
        "@markielucas"
    ]
    
}

---

---

⚙️ Multipule Output Smaple :

[
  [
  {
    "username": "realmadrid",
    "title": "Real Madrid",
    "snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=realmadrid&type=SVG&bitmoji=enable",
    "badge": 1,
    "categoryStringId": "public-profile-category-v3-business-group",
    "subcategoryStringId": "public-profile-subcategory-v3-sports-team",
    "subscriberCount": "4452900",
    "bio": "⚽ Official profile of Real Madrid C.F. | 🏆 15 times European Champions | 🌍 FIFA Best Club of the 20th Century",
    "websiteUrl": "https://www.snapchat.com/@realmadrid",
    "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvRjhTOVBCQndrUTdlM2NxRGlPWTE0P2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
    "address": "Madrid, España",
    "hasCuratedHighlights": "[]",
    "hasSpotlightHighlights": true,
    "mutableName": "Real Madrid",
    "publisherType": "",
    "squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvSjA4Umt5c1NZQ2lxWUZ0ZVIxZ3ROP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,1080_FMjpeg",
    "primaryColor": "",
    "hasStory": true,
    "creationTime": "2019-05-21T18:26:22.131Z",
    "lastUpdateTime": "2025-11-22T11:53:27.000Z",
    "scrapedAt": "2025-11-22T14:50:12.488158Z"
  },
  {
    "username": "mohsenalnssar",
    "title": "Mohsen Alnassar",
    "snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=mohsenalnssar&type=SVG&bitmoji=enable",
    "badge": 1,
    "categoryStringId": "public-profile-category-v3-people",
    "subcategoryStringId": "public-profile-subcategory-v3-entrepreneur",
    "subscriberCount": "641500",
    "bio": "للتواصل من خلال الإيميل: mohsen@dmsgroup.me أو واتساب: 00966598917354",
    "websiteUrl": "https://www.snapchat.com/@mohsenalnssar",
    "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvTkUxVzRHczcwVVoyN0tVd2wxalJvP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMpng",
    "address": "Kuwait, Kuwait",
    "hasCuratedHighlights": true,
    "hasSpotlightHighlights": "[]",
    "mutableName": "Mohsen Alnassar",
    "publisherType": "",
    "squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvVmJNN2NOZkp0REp5c3NvRUQ4R0t6P2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,1080_FMjpeg",
    "primaryColor": "",
    "hasStory": true,
    "creationTime": "2020-01-25T01:39:44.942Z",
    "lastUpdateTime": "2025-11-21T23:17:39.000Z",
    "scrapedAt": "2025-11-22T14:50:12.155073Z"
  },
  {
    "username": "markielucas",
    "title": "Markie",
    "snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=markielucas&type=SVG&bitmoji=enable",
    "badge": 1,
    "categoryStringId": "public-profile-category-v3-people",
    "subcategoryStringId": "public-profile-subcategory-v3-actor",
    "subscriberCount": "517400",
    "bio": "If you read this go watch my story 👀\n\nIG: @markie",
    "websiteUrl": "https://www.snapchat.com/@markielucas",
    "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2Qvb2V4djdueGJzOWVuZTJIT2VMbFNzP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
    "address": "",
    "hasCuratedHighlights": true,
    "hasSpotlightHighlights": true,
    "mutableName": "Markie",
    "publisherType": "",
    "squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvYzFrb0hrd1NCOHRoYzFhOGc4bG4zP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,1080_FMjpeg",
    "primaryColor": "",
    "hasStory": true,
    "creationTime": "2019-07-09T20:39:34.047Z",
    "lastUpdateTime": "2025-11-13T19:22:22.294Z",
    "scrapedAt": "2025-11-22T14:50:12.666578Z"
  },
  {
    "username": "s_kramarzz",
    "title": "Selena😚😚",
    "snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=s_kramarzz&type=SVG&bitmoji=enable",
    "badge": 0,
    "categoryStringId": "public-profile-category-v3-people",
    "subcategoryStringId": "public-profile-subcategory-v3-creator",
    "subscriberCount": "6900",
    "bio": "24\n21+ only plz\nadd me let’s be friends🫶🏼",
    "websiteUrl": "https://www.snapchat.com/@s_kramarzz",
    "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZmxqSW5pSVRkNHNZam1oWFBmNWFHP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,90_FMjpeg",
    "address": "maine",
    "hasCuratedHighlights": true,
    "hasSpotlightHighlights": true,
    "mutableName": "Selena😚😚",
    "publisherType": "",
    "squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvR25iMG16UTJ4cDBoVFdyT1BvanpxP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,1080_FMjpeg",
    "primaryColor": "",
    "hasStory": "False",
    "creationTime": "2021-07-03T20:51:10.726Z",
    "lastUpdateTime": "2025-11-15T22:05:01.263Z",
    "scrapedAt": "2025-11-22T14:50:12.240299Z"
  }
]
]

---

🧾 Output Fields

Field	Description
username	Snapchat handle of the user.
title	Display name or profile title.
snapcodeImageUrl	Snapcode link for quick add.
badge	Verified or business badge indicator.
categoryStringId	Main category (e.g. Business Group).
subcategoryStringId	Subcategory (e.g. Sports Team).
subscriberCount	Total number of subscribers.
bio	User’s biography or description.
websiteUrl	Linked website (if available).
profilePictureUrl	URL of profile avatar image.
address	Location or base city.
hasCuratedHighlights	Whether the user has story highlights.
hasSpotlightHighlights	Whether Spotlight content exists.
hasStory	If there’s an active story.
creationTime	Account creation date.
lastUpdateTime	Last profile update timestamp.
scrapedAt	Time when data was scraped.

---

☁️ Apify Platform Usage Guide

• ▶️ Run directly from Apify Console
• 🔁 Schedule runs for periodic profile monitoring
• 🔌 Integrate via Apify API for SaaS pipelines
• 📊 Export results as JSON, CSV, or connect to data warehouses

---

🔐 Environment Variables

ℹ️ This actor does not require custom environment variables.

🛡️ Proxy authentication and routing are handled internally via Apify Proxy configuration.

---

🚀 Performance & Limits

• ⚡ Optimized for high-throughput scraping
• 🌐 Proxy support minimizes IP blocking risk
• 📈 Concurrency is configurable but should be tuned responsibly
• ⛔ Some fields may be unavailable for private or restricted profiles

---

🛑 Error Handling & Edge Cases

• ❌ Private or non-existent profiles return structured error objects
• 🔁 Automatic fallback to residential proxy on repeated failures
• 🧾 Partial failures do not interrupt other tasks
• 🪵 Detailed logs available in Apify run console

---

🧠 Best Practices

• 🟢 Use Apify Residential Proxy for large batches
• ⚖️ Keep concurrency moderate to reduce blocks
• 🔄 Re-run periodically to track profile changes
• 📦 Consume KV Store output for full-batch processing

---

🧑‍💼 Common Use Cases

• 📊 Social media analytics & competitor research
• 🧠 OSINT & public profile intelligence
• 📣 Brand & influencer monitoring
• 🔌 Data enrichment for CRM or marketing platforms
• 🤖 Feeding AI/ML pipelines with social metadata

---

⚠️ Notes & Warnings

• 🔒 Only publicly available data is scraped
• 🚫 Snapchat may change frontend structures without notice
• 🧪 Always test with small batches before scaling

---

⚖️ Legal & Compliance Disclaimer

📜 This actor is intended for educational, research, and legitimate business purposes only.

🛑 Users are solely responsible for:

• 📘 Complying with Snapchat’s Terms of Service
• ⚖️ Adhering to local data protection and privacy laws
• 🧑‍⚖️ Ensuring ethical and lawful use of scraped data

🚨 The actor developer assumes no liability for misuse.

---