# Snapchat Discover Scraper (`automation-lab/snapchat-discover-scraper`) Actor Extract public Snapchat Discover publishers, stories, snap media URLs, thumbnails, and publish metadata from Discover pages. - **URL**: https://apify.com/automation-lab/snapchat-discover-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Discover Scraper Extract public Snapchat Discover publishers, stories, snap media URLs, thumbnails, and publish metadata from Snapchat Discover pages. Use this actor when you need a repeatable Snapchat Discover extractor for content intelligence, publisher monitoring, media research, or social trend workflows. ### What does Snapchat Discover Scraper do? Snapchat Discover Scraper loads public Snapchat Discover pages and extracts snap-level records from the embedded public page data. It is built for public Discover surfaces such as: - `https://www.snapchat.com/discover` - public publisher pages - public story or show pages that expose the same Snapchat page data Each saved row represents one snap and includes story and publisher context. ### Who is it for? This scraper is useful for teams that monitor short-form social content. - ๐Ÿง  Social intelligence teams tracking publisher activity - ๐Ÿ“บ Media analysts watching Discover shows and story inventory - ๐Ÿ“ˆ Brand teams comparing public Snapchat content formats - ๐Ÿ—ž๏ธ Newsrooms monitoring public entertainment and lifestyle stories - ๐Ÿงช Researchers collecting repeatable public metadata snapshots - ๐Ÿงฐ Data teams feeding BI dashboards or archives ### Why use this actor? Snapchat Discover pages are dynamic and nested. This actor normalizes the public page payload into clean dataset rows so you do not have to reverse-engineer the Next.js and Apollo cache yourself. Benefits: - HTTP-first extraction without a browser by default - One row per snap for easy exports - Publisher and story context on every row - Media, preview, thumbnail, and profile image URLs when present - Conservative defaults for cheap smoke runs - Optional proxy support for challenged requests ### What data can you extract? The dataset contains snap-level records enriched with story and publisher metadata. | Field | Description | | --- | --- | | `publisherName` | Public publisher or creator display name | | `publisherUsername` | Snapchat username when present | | `publisherBio` | Public bio text when present | | `storyTitle` | Discover story or episode title | | `storyType` | Snapchat story type from the public payload | | `storyPublishedAt` | Published timestamp converted to ISO format | | `storyThumbnailUrl` | Story thumbnail URL | | `snapMediaType` | Snap media type, such as video or image | | `snapMediaUrl` | Public media URL when exposed | | `snapPreviewUrl` | Preview or thumbnail URL | | `snapUrl` | Public snap URL candidate when exposed | | `scrapedAt` | Timestamp when the actor saved the row | ### How much does it cost to scrape Snapchat Discover? This actor uses pay-per-event pricing. You pay a small start fee plus a per-record event for each snap row saved. The default input saves up to 20 snap records, which is suitable for a first run and matches the platform default. Actual cost depends on: - number of snap records requested - whether proxy mode is enabled - page response size - Apify account pricing tier ### Input options The actor accepts a small set of inputs. #### `startUrls` Optional list of Snapchat URLs. If you leave this empty, the actor scrapes: `https://www.snapchat.com/discover` Use this field when you want to monitor a specific public publisher, story, or show page. #### `maxItems` Maximum number of snap records to save. Use a low number for testing and a higher number for monitoring runs. #### `useProxy` Enable Apify Proxy only if your run is challenged or blocked. Direct HTTP mode is cheaper and is the default. #### `proxyGroups` Optional Apify Proxy group names used only when proxy mode is enabled. For example, advanced users may test `RESIDENTIAL` if Snapchat challenges their traffic. ### Example input ```json { "startUrls": [ { "url": "https://www.snapchat.com/discover" } ], "maxItems": 20, "useProxy": false } ```` ### Output example ```json { "recordType": "snap", "sourceUrl": "https://www.snapchat.com/discover", "storyId": "63123326193664", "storyType": "PremiumPublisherStory", "storyTitle": "White Diamond Hairs", "storyUrl": "https://www.snapchat.com/add/interiors", "storyThumbnailUrl": "https://cf-st.sc-cdn.net/...", "storyPublishedAt": "2026-07-04T01:12:00.000Z", "publisherUsername": "interiors", "publisherName": "Interiors", "snapIndex": 1, "snapMediaType": "VIDEO", "snapMediaUrl": "https://cf-st.sc-cdn.net/...", "snapPreviewUrl": "https://cf-st.sc-cdn.net/...", "scrapedAt": "2026-07-04T02:30:00.000Z" } ``` ### How to scrape Snapchat Discover 1. Open Snapchat Discover Scraper on Apify. 2. Keep the default Discover URL or add your own public Snapchat URLs. 3. Choose the maximum number of snap records. 4. Leave proxy mode disabled for the first run. 5. Start the actor. 6. Download results as JSON, CSV, Excel, XML, or RSS from the dataset. ### Tips for reliable runs - Start with the default Discover URL. - Keep `maxItems` low while testing. - Increase `maxItems` only after you confirm the output shape. - Enable proxy mode only when you see challenge or blocked-response errors. - Use scheduled runs to capture snapshots over time. - Store `sourceUrl` and `scrapedAt` in your warehouse for historical comparisons. ### Common use cases #### Track Discover publishers Monitor which publishers appear in public Discover inventory and how their media changes over time. #### Build a media URL archive Save public media and preview URLs for downstream analysis or quality control. #### Compare story formats Use `storyType`, `snapMediaType`, thumbnails, and publisher names to compare content formats. #### Create a social intelligence feed Schedule daily runs and export the dataset to BI tools or a database. ### Integrations You can connect the actor output to many Apify and external tools. - Google Sheets exports for lightweight editorial tracking - Webhooks for run-complete notifications - Make or Zapier flows for no-code automation - BigQuery, Snowflake, or PostgreSQL pipelines - Internal dashboards that group by publisher or story - Slack alerts when a tracked publisher appears ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/snapchat-discover-scraper').call({ startUrls: [{ url: 'https://www.snapchat.com/discover' }], maxItems: 20, }); console.log(run.defaultDatasetId); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('MY-APIFY-TOKEN') run = client.actor('automation-lab/snapchat-discover-scraper').call(run_input={ 'startUrls': [{'url': 'https://www.snapchat.com/discover'}], 'maxItems': 20, }) print(run['defaultDatasetId']) ``` #### cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~snapchat-discover-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"startUrls":[{"url":"https://www.snapchat.com/discover"}],"maxItems":20}' ``` ### MCP usage Use this actor through Apify MCP when you want Claude or another MCP client to run Snapchat Discover extraction. MCP server URL: `https://mcp.apify.com/?tools=automation-lab/snapchat-discover-scraper` Claude Code setup: ```bash claude mcp add apify-snapchat-discover --transport http "https://mcp.apify.com/?tools=automation-lab/snapchat-discover-scraper" ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-snapchat-discover": { "url": "https://mcp.apify.com/?tools=automation-lab/snapchat-discover-scraper" } } } ``` Example prompts: - "Run the Snapchat Discover scraper for the default Discover page and summarize the publishers." - "Extract 20 public Snapchat Discover snap records and group them by publisher." - "Monitor this Snapchat publisher URL and tell me which story titles changed." ### Data quality notes Snapchat controls which fields are present in each public payload. Some rows may not contain every URL or title. The actor keeps missing fields as `null` rather than guessing. This makes exports easier to validate and safer for automated pipelines. ### Legality and privacy This actor is designed for public Snapchat pages only. It does not log in, bypass private accounts, or access non-public user data. You are responsible for using the extracted data in compliance with applicable laws, Snapchat terms, and your internal policies. If you are unsure whether your use case is allowed, consult legal counsel before running large-scale collection. ### FAQ #### Does this actor require a Snapchat login? No. It only extracts data from public Snapchat pages that are reachable without logging in. #### Can I scrape private Snapchat accounts? No. This actor is for public Discover and publisher pages only. ### Troubleshooting #### The run says no records were extracted Snapchat may have changed the page payload, returned a challenge page, or the input URL may not expose Discover data. Try the default Discover URL first. If direct HTTP is challenged, enable proxy mode and run a small test. #### Some media URLs look temporary Snapchat CDN URLs can change or expire. Store the `scrapedAt` timestamp and refresh your dataset on a schedule if you need current links. #### I only need publishers, not every snap Export the dataset and group by `publisherUsername` or `publisherName`. The actor emits snap rows so media intelligence workflows still have complete context. ### Related scrapers Other Automation Lab actors can complement this dataset: - https://apify.com/automation-lab/tiktok-scraper - https://apify.com/automation-lab/instagram-profile-scraper - https://apify.com/automation-lab/youtube-channel-scraper - https://apify.com/automation-lab/twitter-scraper ### Changelog #### 0.1 Initial version with HTTP-first extraction from public Snapchat Discover page payloads. ### Support If the actor stops extracting records, open an issue with: - input JSON - run ID - whether proxy mode was enabled - sample URL that failed This helps reproduce page-shape changes quickly. # Actor input Schema ## `startUrls` (type: `array`): Snapchat Discover, publisher, show, or story URLs. Leave empty to scrape the public Discover landing page. ## `maxItems` (type: `integer`): Maximum number of snap records to save across all input URLs. ## `useProxy` (type: `boolean`): Enable proxy requests if Snapchat challenges direct traffic. The default direct HTTP mode is cheaper and usually enough for public Discover pages. ## `proxyGroups` (type: `array`): Optional Apify Proxy groups, for example RESIDENTIAL. Used only when proxy mode is enabled. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.snapchat.com/discover" } ], "maxItems": 20, "useProxy": false, "proxyGroups": [] } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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": [ { "url": "https://www.snapchat.com/discover" } ], "maxItems": 20, "useProxy": false, "proxyGroups": [] }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/snapchat-discover-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": [{ "url": "https://www.snapchat.com/discover" }], "maxItems": 20, "useProxy": False, "proxyGroups": [], } # Run the Actor and wait for it to finish run = client.actor("automation-lab/snapchat-discover-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": [ { "url": "https://www.snapchat.com/discover" } ], "maxItems": 20, "useProxy": false, "proxyGroups": [] }' | apify call automation-lab/snapchat-discover-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/snapchat-discover-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Snapchat Discover Scraper", "description": "Extract public Snapchat Discover publishers, stories, snap media URLs, thumbnails, and publish metadata from Discover pages.", "version": "0.1", "x-build-id": "XHFShvKyz0ltkSjA9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~snapchat-discover-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-snapchat-discover-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/automation-lab~snapchat-discover-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-snapchat-discover-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/automation-lab~snapchat-discover-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-snapchat-discover-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", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Snapchat Discover, publisher, show, or story URLs. Leave empty to scrape the public Discover landing page.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum snap records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of snap records to save across all input URLs.", "default": 20 }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Enable proxy requests if Snapchat challenges direct traffic. The default direct HTTP mode is cheaper and usually enough for public Discover pages.", "default": false }, "proxyGroups": { "title": "Proxy groups", "type": "array", "description": "Optional Apify Proxy groups, for example RESIDENTIAL. Used only when proxy mode is enabled.", "default": [], "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```