🎯 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

# Run actor with input JSON
apify run --actor-id <ACTOR_ID> -p input.json

apify-client (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

{
  "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:

{
  "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

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

{
  "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.