# Snapchat Snapcode Scraper (`crawlerbros/snapchat-snapcode-scraper`) Actor Download Snapchat snapcode images (QR codes) in SVG or PNG format for any public username. - **URL**: https://apify.com/crawlerbros/snapchat-snapcode-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Social media, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Snapcode Scraper Download Snapcode images for any Snapchat username — no login required. Snapcodes are Snapchat's unique QR-style codes used to add friends, promote profiles, and embed in marketing materials. This actor fetches the official snapcode in SVG or PNG format, with or without the user's Bitmoji avatar, and optionally saves the image to Apify Key-Value Store for a persistent download URL. ### What This Actor Does - Accepts any number of Snapchat usernames in a single run - Fetches each user's snapcode directly from Snapchat's official snapcode endpoint - Supports SVG (vector, scalable) and PNG (raster) formats - Optionally includes or excludes the user's Bitmoji avatar in the snapcode - Optionally saves the image binary to Apify Key-Value Store and returns a persistent URL - Returns error records for invalid or non-existent usernames — no run failures ### Input | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `usernames` | string[] | Yes | — | Snapchat usernames to fetch snapcodes for. Example: `["brentrivera", "selenagomez"]` | | `format` | string | No | `SVG` | Image format: `SVG` (vector, ~68 KB, recommended) or `PNG` (raster, ~25 KB) | | `bitmoji` | string | No | `enable` | `enable` includes the user's Bitmoji avatar; `disable` shows the classic ghost icon only | | `downloadToStorage` | boolean | No | `false` | Save the image binary to Apify Key-Value Store and include a persistent `kvStoreUrl` in the output | | `proxyConfiguration` | object | No | — | Optional proxy configuration for requests | #### Example Input ```json { "usernames": ["brentrivera", "selenagomez", "khaby.lame"], "format": "SVG", "bitmoji": "enable", "downloadToStorage": false } ```` ### Output One record per username. If a username is invalid or not found, an error record is returned instead. | Field | Type | Description | |-------|------|-------------| | `username` | string | Snapchat username as provided in input | | `snapcodeUrl` | string | Direct URL to fetch the snapcode image from Snapchat's CDN | | `format` | string | Image format used: `SVG` or `PNG` | | `bitmojiEnabled` | boolean | Whether the Bitmoji avatar is included in the image | | `contentType` | string | MIME type of the image: `image/svg+xml` or `image/png` | | `byteLength` | integer | File size of the snapcode image in bytes | | `kvStoreUrl` | string | Persistent Apify Key-Value Store URL for the saved image (only when `downloadToStorage` is `true`) | | `scrapedAt` | string | ISO 8601 UTC timestamp of when the record was collected | #### Example Output — Success ```json { "username": "waqarzaka", "snapcodeUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=waqarzaka&type=SVG&bitmoji=enable", "format": "SVG", "bitmojiEnabled": true, "contentType": "image/svg+xml", "byteLength": 10314, "scrapedAt": "2026-06-28T06:48:12.863774+00:00" } ``` #### Example Output — Error Record ```json { "username": "nonexistentuser99", "error": "Snapcode request failed (HTTP 400)", "scrapedAt": "2026-06-28T06:48:13.001000+00:00" } ``` ### Use Cases - **Profile verification** — collect official snapcodes for a list of influencers or brand accounts - **Marketing materials** — batch-download snapcodes for print campaigns, posters, or event badges - **Brand asset archiving** — save snapcodes to persistent storage alongside other social media assets - **Influencer research** — quickly verify which usernames are active Snapchat accounts - **QR code aggregation** — build a library of Snapchat entry points for campaign landing pages ### FAQ **What is a Snapcode?** A Snapcode is Snapchat's proprietary QR-style code that uniquely identifies a user. When scanned with the Snapchat camera, it instantly opens an add-friend prompt for that user. They are widely used in marketing, printed materials, and digital campaigns. **Should I use SVG or PNG?** SVG is recommended for most uses. It is vector-based, scales to any resolution without pixelation, and is ideal for print or high-DPI displays. Use PNG if your downstream system does not support SVG rendering. **What does enabling or disabling Bitmoji do?** When `bitmoji` is set to `enable`, the snapcode includes the user's Bitmoji avatar inside the ghost outline. If the user has not set up a Bitmoji, Snapchat shows the default ghost icon regardless. Set to `disable` to always receive the plain ghost outline version. **Why use `downloadToStorage`?** The `snapcodeUrl` field points to Snapchat's live endpoint, which regenerates the image on each request and may change over time. Enabling `downloadToStorage` saves a copy of the image bytes to your Apify Key-Value Store and returns a stable `kvStoreUrl` that will not expire as long as the storage run exists. **Do I need a Snapchat account or cookies?** No. Snapcodes are publicly available for any Snapchat username — no login, session, or cookies are required. **What happens for invalid or non-existent usernames?** Instead of stopping the run, the actor emits an error record for that username with the `error` field explaining what went wrong. All other usernames continue to be processed normally. **Can I scrape snapcodes for hundreds of usernames at once?** Yes. Add as many usernames as needed to the `usernames` array. The actor processes them sequentially and outputs one record per username. *** ### Other Snapchat Scrapers Explore the full Snapchat scraper suite on Apify: | Actor | Description | |-------|-------------| | [Snapchat Profile Scraper](https://apify.com/crawlerbros/snapchat-profile-scraper) | Full profile metadata, highlights, lenses, and spotlight data | | [Snapchat Hashtag Scraper](https://apify.com/crawlerbros/snapchat-hashtag-scraper) | Spotlight videos by hashtag or topic with AI metadata | | [Snapchat User Stories Scraper](https://apify.com/crawlerbros/snapchat-user-stories-scraper) | Curated highlights and active story snaps | | [Snapchat Spotlight Video Downloader](https://apify.com/crawlerbros/snapchat-spotlight-video-downloader) | Download Spotlight videos with AI metadata, transcripts, and comments | | [Snapchat Search Scraper](https://apify.com/crawlerbros/snapchat-search-scraper) | Search across videos, lenses, users, places, and shows | | [Snapchat Lens Scraper](https://apify.com/crawlerbros/snapchat-lens-scraper) | AR lens metadata, trending lenses, and creator info | | [Snapchat Publisher Scraper](https://apify.com/crawlerbros/snapchat-publisher-scraper) | Discover publisher pages, shows, episodes, and spotlights | | [Snapchat Ads Gallery Scraper](https://apify.com/crawlerbros/snapchat-ads-gallery-scraper) | EU/UK ad transparency library — ads and sponsored content | | [Snapchat Spotlight Comments Scraper](https://apify.com/crawlerbros/snapchat-spotlight-comments-scraper) | Comment threads from Spotlight videos | | [Snapchat Topic Scraper](https://apify.com/crawlerbros/snapchat-topic-scraper) | Spotlight videos by topic with related tags | | [Snapchat Snapcode Scraper](https://apify.com/crawlerbros/snapchat-snapcode-scraper) | Download Snapcode images (SVG/PNG) for any username | | [Snapchat Snap Map Scraper](https://apify.com/crawlerbros/snapchat-snap-map-scraper) | Public Snap Map places and their latest snaps | | [Snapchat Discover Scraper](https://apify.com/crawlerbros/snapchat-discover-scraper) | Shows and stories from Snapchat's Discover feed | # Actor input Schema ## `usernames` (type: `array`): Snapchat usernames to fetch snapcodes for ## `format` (type: `string`): Image format of the snapcode to download: SVG (vector, recommended) or PNG (raster). ## `bitmoji` (type: `string`): Whether to include the user's Bitmoji avatar in the snapcode image. ## `downloadToStorage` (type: `boolean`): Download the snapcode image to Apify Key-Value Store and include a persistent URL in output ## `proxyConfiguration` (type: `object`): Optional proxy configuration for requests. ## Actor input object example ```json { "usernames": [ "brentrivera", "selenagomez" ], "format": "SVG", "bitmoji": "enable", "downloadToStorage": 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 = { "usernames": [ "brentrivera", "selenagomez" ], "format": "SVG", "bitmoji": "enable" }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/snapchat-snapcode-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 = { "usernames": [ "brentrivera", "selenagomez", ], "format": "SVG", "bitmoji": "enable", } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/snapchat-snapcode-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 '{ "usernames": [ "brentrivera", "selenagomez" ], "format": "SVG", "bitmoji": "enable" }' | apify call crawlerbros/snapchat-snapcode-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/snapchat-snapcode-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Snapchat Snapcode Scraper", "description": "Download Snapchat snapcode images (QR codes) in SVG or PNG format for any public username.", "version": "0.1", "x-build-id": "5OPJ4C0Uhz6d4uxTN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~snapchat-snapcode-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-snapchat-snapcode-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/crawlerbros~snapchat-snapcode-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-snapchat-snapcode-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/crawlerbros~snapchat-snapcode-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-snapchat-snapcode-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": [ "usernames" ], "properties": { "usernames": { "title": "Usernames", "type": "array", "description": "Snapchat usernames to fetch snapcodes for", "items": { "type": "string" } }, "format": { "title": "Image Format", "enum": [ "SVG", "PNG" ], "type": "string", "description": "Image format of the snapcode to download: SVG (vector, recommended) or PNG (raster).", "default": "SVG" }, "bitmoji": { "title": "Bitmoji Avatar", "enum": [ "enable", "disable" ], "type": "string", "description": "Whether to include the user's Bitmoji avatar in the snapcode image.", "default": "enable" }, "downloadToStorage": { "title": "Save to Key-Value Store", "type": "boolean", "description": "Download the snapcode image to Apify Key-Value Store and include a persistent URL in output", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy configuration for requests." } } }, "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 } } } } } } } } } } ```