🎯 Snapchat Profile Scraper Actor Powerful Snapchat profile metadata extractor for public profiles. ## 📖 Overview Scrape Snapchat profile information including username, followers, account type, videos, and related accounts—all in a clean JSON format. ## 💡 Use Cases / When to Use * Gather analytics for Snapchat influencers. * Monitor public profiles for engagement metrics. * Collect video links and account information for automation or research. ## ⚡ Quick Start (Console) 1. Go to the actor page on Apify Console. 2. Click Run. 3. Enter your Snapchat profile URLs in the startUrls input (JSON array of URLs). 4. Optional: Enable Apify Proxy in the Proxy panel. 5. Click Start. ## ⚡ Quick Start (CLI + API) ### CLI bash # Run actor with input JSON apify run --actor-id <ACTOR_ID> -p input.json ### apify-client (Python) python from apify_client import ApifyClient client = ApifyClient('<APIFY_TOKEN>') run_input = { "startUrls": ["https://www.snapchat.com/add/exampleuser"], "proxyConfiguration": {"useApifyProxy": True} } run = client.actor('your-username/snapchat-profile-scraper').call(run_input=run_input) print(run['defaultDatasetId']) ## 📝 Inputs json { "startUrls": ["https://www.snapchat.com/add/exampleuser"], "proxyConfiguration": {"useApifyProxy": true} } * startUrls: Array of Snapchat profile URLs to scrape. * proxyConfiguration: Proxy settings object (optional, see 🌍 Proxy Configuration). ## ⚙️ Configuration | 🔑 Name | 📝 Type | ❓ Required | ⚙️ Default | 📌 Example | 📝 Notes | | ------------------ | ----------- | ---------- | -------------- | ----------------------------------------------------------------------------------------- | --------------------------------------- | | startUrls | array | ✅ Yes | null | ["https://www.snapchat.com/add/exampleuser"] | List of Snapchat profile URLs | | proxyConfiguration | object | ❌ No | {} | {"useApifyProxy": true} | Configure Apify Proxy or custom proxies | | ALL_RESULTS | dataset key | ❌ No | defaultDataset | null | Default dataset key for outputs | Console example: paste URLs into startUrls field or set an environment variable APIFY_TOKEN=<YOUR_TOKEN>. ## 📤 Outputs Each output item includes: json { "name": "Example User", "user_name": "exampleuser", "followers": "1200", "display_picture": "https://profile.pic/url.webp", "account_type": "Public", "last_updated": "2025-09-15", "video_url": "https://www.snapchat.com/spotlight/video123", "view_count": "10000", "share_count": "500", "comment_count": "150", "related_link": "Related Topic", "related_account": "related_user" } * Stored in default dataset (ALL_RESULTS). ## 🔑 Environment Variables | Variable | Description | | ------------ | -------------------- | | APIFY_TOKEN | Your Apify API token | ## ▶️ How to Run ### Console 1. Paste URLs into startUrls. 2. Optionally configure proxy. 3. Click Start. ### CLI bash apify run --actor-id <ACTOR_ID> -p input.json ### apify-client See Quick Start above. ## ⏰ Scheduling & Webhooks * Use Scheduling tab in Console to run periodically. * Webhooks can be added in Console to get notified on actor completion. ## 🐞 Logs & Troubleshooting * ❌ "No Snapchat profile URLs provided" → Check startUrls input. * ⚠️ Proxy errors → Ensure valid proxy configuration or enable Apify Proxy. ## 🔒 Permissions & Storage notes * Data is stored in default dataset (ALL_RESULTS). * Proxy credentials should be saved as secrets. ## 🆕 Changelog / Versioning tip * Keep actor versions tagged in Console for reproducibility. ## 🌍 Proxy Configuration * Enable Apify Proxy in the Proxy panel. * Custom Proxies: Set HTTP_PROXY and HTTPS_PROXY env vars or via proxyConfiguration input. json { "startUrls": ["https://www.snapchat.com/add/exampleuser"], "proxyConfiguration": { "useApifyProxy": false, "apifyProxyGroups": ["GROUP"], "proxyUrls": ["http://<USER>:<PASS>@proxy.com:8000"] } } * 🔒 Keep credentials as secrets. * TODO: Advanced proxy rotation patterns (for large-scale scraping). ## 📌 Notes / TODOs * TODO: Verify handling of multiple video URLs per profile. * TODO: Confirm parsing consistency across Snapchat UI changes. ## 📚 References * Apify Actor README Guide * Apify Input & Output Docs * Actor in Console ## 🧐 Inferred from main.py * Actor scrapes public Snapchat profiles. * Supports Apify Proxy and custom proxies. * Outputs stored in default dataset (ALL_RESULTS). * TODOs include proxy rotation and multi-video handling.