# Snapchat Followers Scraper (`scraply/snapchat-followers-scraper`) Actor - **URL**: https://apify.com/scraply/snapchat-followers-scraper.md - **Developed by:** [Scraply](https://apify.com/scraply) (community) - **Categories:** Automation, Lead generation, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Snapchat Profile Scraper - Extract Snapchat Profile Data at Scale **Snapchat Profile Scraper** is a powerful, production-grade Apify Actor designed to extract comprehensive profile information from Snapchat public profiles. Whether you need to scrape Snapchat followers, analyze profile data, or gather insights from multiple Snapchat accounts, this actor provides a reliable, automated solution with intelligent proxy management and robust error handling. ### Why Choose Us? Our Snapchat scraper offers intelligent proxy fallback (no proxy → datacenter → residential), live data saving, bulk processing capabilities, and comprehensive data extraction (18+ fields). Built with enterprise-grade error handling and optimized async architecture for reliable, fast scraping. ### Key Features #### 🔄 **Automatic Proxy Fallback System** Intelligently manages proxies: starts with direct requests, switches to datacenter proxies if blocked, falls back to residential proxies with 3 retries, and sticks with working proxy types. All proxy events are logged. #### 📊 **Comprehensive Data Extraction** Extracts 18+ fields: username, title, bio, subscriber count, profile pictures, website URLs, address, category, publisher type, highlights status, story status, and more. #### ⚡ **High Performance & Reliability** Asynchronous processing with smart rate limiting, exponential backoff retry (3 attempts), optimized HTML parsing, and comprehensive error handling with detailed logging. ### Input The actor accepts the following input parameters: #### Input Schema ```json { "startUrls": [ "https://www.snapchat.com/add/mrbeast", "https://www.snapchat.com/add/nike", "username" ], "sortOrder": "none", "proxyConfiguration": { "useApifyProxy": false } } ```` #### Input Parameters Explained ##### `startUrls` (Required) - **Type**: Array of strings - **Description**: List of Snapchat profile URLs or usernames to scrape - **Format**: - Full URLs: `https://www.snapchat.com/add/username` or `https://www.snapchat.com/@username` - Usernames only: `username` or `mrbeast` - **Example**: `["mrbeast", "nike", "https://www.snapchat.com/add/disney"]` - **Bulk Support**: Yes, supports unlimited profiles ##### `sortOrder` (Optional) - **Type**: String - **Description**: Order to process profiles - **Options**: - `"asc"` - Process in ascending alphabetical order by username - `"desc"` - Process in descending alphabetical order by username - `"none"` - Process in the order provided (default) - **Default**: `"none"` ##### `proxyConfiguration` (Optional) - **Type**: Object - **Description**: Proxy settings for requests - **Default**: `{"useApifyProxy": false}` (no proxy) - **Note**: The actor automatically handles proxy fallback if Snapchat blocks requests. You can enable Apify proxies if needed, but the actor will intelligently switch proxies if blocks occur. ### Output The actor outputs structured JSON data to the Apify dataset. Each profile is saved as a separate item with the following structure: #### Output Schema ```json { "username": "mrbeast", "scrapedAt": "2025-12-20T10:51:30.954712Z", "title": "MrBeast", "bio": "Creating the best content on the internet", "subscriberCount": "1310300", "websiteUrl": "https://www.mrbeast.com", "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/...", "address": "United States", "categoryStringId": "public-profile-category-v3-people", "subcategoryStringId": "public-profile-subcategory-v3-creator", "snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=mrbeast&type=SVG", "squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/...", "mutableName": "MrBeast", "publisherType": "user", "primaryColor": "#000000", "hasCuratedHighlights": true, "hasStory": false, "badge": 1, "success": true } ``` #### Output Fields Explained Key fields include: `username`, `title`, `bio`, `subscriberCount`, `websiteUrl`, `profilePictureUrl`, `address`, `mutableName`, `publisherType`, `hasCuratedHighlights`, `hasStory`, `badge`, `scrapedAt` (ISO timestamp), and `success` (boolean). Full list: username, scrapedAt, title, bio, subscriberCount, websiteUrl, profilePictureUrl, address, categoryStringId, subcategoryStringId, snapcodeImageUrl, squareHeroImageUrl, mutableName, publisherType, primaryColor, hasCuratedHighlights, hasStory, badge, success. **Note**: If a profile fails to scrape, the output will include `"success": false` and an `"error"` field with the error message. ### 🚀 How to Use the Actor (via Apify Console) 1. Log in at and navigate to Actors 2. Find "snapchat-followers-scraper" in your actor list 3. Configure inputs: enter Snapchat URLs/usernames in `startUrls`, optionally set `sortOrder`, configure proxy if needed 4. Click "Start" to begin scraping 5. Monitor real-time logs in the "Log" tab 6. Access results in the "Dataset" tab (saved live as processed) 7. Export data in JSON, CSV, Excel, XML, or RSS formats ### Best Use Cases - **Social Media Analytics**: Market research, competitor analysis, influencer identification - **Influencer Marketing**: Build influencer databases with contact info and follower counts - **Brand Monitoring**: Track competitor profiles, subscriber growth, and content strategies - **Data Collection & Research**: Academic research, social media studies, demographic analysis - **Business Intelligence**: Lead generation, customer research, contact extraction - **Content Strategy**: Analyze successful profiles for engagement tactics ### Frequently Asked Questions #### How many profiles can I scrape at once? No hard limit. The actor processes profiles efficiently using asynchronous requests. For 1000+ profiles, consider multiple runs or the Apify scheduler. #### Will I get blocked by Snapchat? Intelligent proxy fallback minimizes blocking. Starts with direct requests, automatically switches to datacenter/residential proxies if blocked. Always respect rate limits. #### How accurate is the subscriber count? Extracted directly from Snapchat's public pages. Accuracy depends on Snapchat's data availability and may vary slightly from the app. #### Can I scrape private profiles? No. Only publicly available profile information is accessed. Private accounts cannot be scraped. #### How long does it take? Typically 1-2 seconds per profile. For 100 profiles, expect 2-4 minutes under normal conditions. #### What happens if a profile doesn't exist? Saves error result with `"success": false` and error message. Continues processing remaining profiles. #### Can I customize data fields? Contact dev.scraperengine@gmail.com for custom solutions and additional fields. #### Is the data real-time? Yes, data reflects the current state at scraping time. Metrics are as current as Snapchat's public display. ### Support and Feedback For support, custom solutions, or feature requests, contact us at **dev.scraperengine@gmail.com**. We provide custom scraping solutions, bulk processing assistance, technical support, and integration help. ### Cautions ⚠️ **Important Legal and Ethical Considerations** - **Public Data Only**: Collects data only from publicly available Snapchat profiles. No private accounts accessed. - **Legal Compliance**: Users must ensure compliance with data protection regulations (GDPR, CCPA), privacy laws, anti-spam legislation, and terms of service agreements. - **Rate Limiting**: Respect Snapchat's terms of service. Avoid excessive scraping. The actor includes built-in delays and proxy management. - **Data Usage**: Users are responsible for how scraped data is used. Ensure you have the right to collect and use profile information. - **No Guarantees**: Snapchat may change their website structure, which could temporarily affect accuracy. We continuously update the actor for compatibility. *** **Built with ❤️ for the Apify community** *Last updated: December 2025* # Actor input Schema ## `startUrls` (type: `array`): List one or more Snapchat profile URLs (e.g., https://www.snapchat.com/add/username) or usernames (e.g., username). ## `proxyConfiguration` (type: `object`): Choose which proxies to use. By default, no proxy is used. If Snapchat blocks requests, the actor will automatically fallback to datacenter, then residential proxies. ## Actor input object example ```json { "startUrls": [ "mohsenalnssar" ], "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "mohsenalnssar" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scraply/snapchat-followers-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["mohsenalnssar"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("scraply/snapchat-followers-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "mohsenalnssar" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call scraply/snapchat-followers-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraply/snapchat-followers-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Snapchat Followers Scraper", "version": "0.1", "x-build-id": "Tx86vizZhwiwqV5Xc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraply~snapchat-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraply-snapchat-followers-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scraply~snapchat-followers-scraper/runs": { "post": { "operationId": "runs-sync-scraply-snapchat-followers-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scraply~snapchat-followers-scraper/run-sync": { "post": { "operationId": "run-sync-scraply-snapchat-followers-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Snapchat Profile URLs or Usernames", "type": "array", "description": "List one or more Snapchat profile URLs (e.g., https://www.snapchat.com/add/username) or usernames (e.g., username).", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Choose which proxies to use. By default, no proxy is used. If Snapchat blocks requests, the actor will automatically fallback to datacenter, then residential proxies." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```