# Snapchat Topic Scraper (`crawlerbros/snapchat-topic-scraper`) Actor Scrape Snapchat topic pages - get spotlight videos, related tags, and topic metadata for any Snapchat topic. - **URL**: https://apify.com/crawlerbros/snapchat-topic-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Social media, Automation, Videos - **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 Topic Scraper Extract Spotlight videos by topic from Snapchat — no login required. Browse trending content under any of Snapchat's built-in topic categories such as food, humor, travel, gaming, and more. Each record includes video URLs, creator details, engagement stats, AI-generated metadata, and optional S2I content classification tags. ### What This Actor Does - Accepts topic IDs (e.g. `food`, `humor`) or full topic URLs (`https://www.snapchat.com/topic/food`) - Returns up to 32 Spotlight videos per topic per run (Snapchat's maximum per page) - Extracts AI-generated titles, descriptions, and keyword arrays from each video - Optionally includes related S2I content tags with hierarchy scores - Works without login or cookies — uses Snapchat's public topic pages ### Supported Input Formats | Format | Example | |--------|---------| | Bare topic ID | `food` | | Topic with spaces | `new york` | | Full URL | `https://www.snapchat.com/topic/food` | | Hash-prefixed | `#humor` (hash stripped automatically) | ### Input | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `topics` | string[] | Yes | — | Topic IDs or topic URLs. Examples: `food`, `humor`, `travel`, `https://www.snapchat.com/topic/food` | | `maxResultsPerTopic` | integer | No | `32` | Max Spotlight records per topic. Snapchat serves a maximum of 32 per page. | | `includeRelatedTags` | boolean | No | `true` | Include S2I content classification tags in each record. | | `proxyConfiguration` | object | No | — | Optional Apify proxy configuration. Public Snapchat pages work without proxy; add for resilience at scale. | #### Example Input ```json { "topics": ["food", "humor", "https://www.snapchat.com/topic/travel"], "maxResultsPerTopic": 32, "includeRelatedTags": true } ```` ### Output Each record represents one Spotlight video under the given topic. | Field | Type | Description | |-------|------|-------------| | `topicId` | string | Topic identifier as provided in input (e.g. `technology`) | | `topicDisplayName` | string | Human-readable topic label (e.g. `Technology`) | | `snapId` | string | Unique Spotlight snap identifier | | `storyId` | string | Full story composite identifier | | `compositeStoryId` | object | Structured story ID with `corpus`, `id`, and `version` | | `snapUrl` | string | Direct Snapchat web URL to the Spotlight video | | `videoUrl` | string | CDN video URL (may include watermark) | | `videoUrlUnwatermarked` | string | CDN video URL without watermark | | `thumbnailUrl` | string | Thumbnail image URL | | `durationSeconds` | number | Video duration in seconds | | `creatorUsername` | string | Snapchat username of the creator | | `creatorDisplayName` | string | Display name of the creator | | `creatorProfileUrl` | string | Snapchat profile URL of the creator | | `viewCount` | integer | Total view count | | `likeCount` | integer | Total like count | | `shareCount` | integer | Total share count | | `commentCount` | integer | Total comment count | | `recommendCount` | integer | Total recommendation count | | `description` | string | Caption or description written by the creator | | `llmTitle` | string | AI-generated title summarizing the video content | | `llmDescription` | string | AI-generated description of the video | | `llmKeywords` | string\[] | AI-generated keyword list for the video | | `isFeatured` | boolean | Whether this video is currently featured by Snapchat | | `storySubtype` | integer | Internal story subtype code | | `uploadedAt` | string | ISO 8601 timestamp of when the video was uploaded | | `remainingSpotlightCount` | integer | Number of additional spotlight IDs available beyond this batch | | `relatedTags` | object\[] | S2I classification tags (when `includeRelatedTags` is `true`) | | `relatedTags[].tagName` | string | Name of the content classification tag | | `relatedTags[].score` | number | Relevance score for this tag | | `relatedTags[].level` | integer | Hierarchy level of the tag | | `scrapedAt` | string | ISO 8601 timestamp of when the record was scraped | #### Example Output ```json { "topicId": "technology", "topicDisplayName": "Technology", "snapId": "W7_EDlXWTBiXAEEniNoMPwAAYbGNxbnVlY2ptAZezrfS6AZezrfMbAAAAAQ", "storyId": "35::W7_EDlXWTBiXAEEniNoMPwAAYbGNxbnVlY2ptAZezrfS6AZezrfMbAAAAAQ::0", "compositeStoryId": { "corpus": 35, "id": "W7_EDlXWTBiXAEEniNoMPwAAYbGNxbnVlY2ptAZezrfS6AZezrfMbAAAAAQ", "version": "0" }, "snapUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYbGNxbnVlY2ptAZezrfS6AZezrfMbAAAAAQ", "videoUrl": "https://cf-st.sc-cdn.net/d/kAEZhCauQoCWxONAnECsR...", "videoUrlUnwatermarked": "https://cf-st.sc-cdn.net/d/kAEZhCauQoCWxONAnECsR...", "thumbnailUrl": "https://cf-st.sc-cdn.net/d/kAEZhCauQoCWxONAnECsR...", "durationSeconds": 57.6, "creatorUsername": "tinytexts", "creatorDisplayName": "Tiny Texts", "creatorProfileUrl": "https://www.snapchat.com/@tinytexts", "viewCount": 1466990, "likeCount": 60914, "shareCount": 2129, "commentCount": 764, "recommendCount": 6467, "description": "tag your yellow heart 💛", "llmTitle": "How to Handle a Parent's Phone Texting Mistake", "llmDescription": "This text-based conversation shows a humorous exchange where a dad realizes he's texting his child from his own phone after claiming the child left theirs at home.", "llmKeywords": ["funny parent moments", "texting my dad", "parenting humor", "text message prank"], "isFeatured": false, "storySubtype": 0, "uploadedAt": "2025-06-27T23:16:51.099000+00:00", "remainingSpotlightCount": 25, "relatedTags": [ { "tagName": "Science", "score": 0, "level": 0 }, { "tagName": "Device", "score": 0, "level": 0 }, { "tagName": "AI", "score": 0, "level": 0 } ], "scrapedAt": "2026-06-28T06:46:41.956315+00:00" } ``` ### Use Cases - **Trend research** — monitor which Spotlight videos are rising under specific topic categories - **Content strategy** — analyze what formats, lengths, and styles perform well per topic - **Competitive analysis** — track creators active in a given topic and their engagement metrics - **AI keyword research** — leverage Snapchat's LLM-generated keyword arrays for SEO and content planning - **Data journalism** — map viral content themes across Snapchat's topic taxonomy ### FAQ **Do I need a Snapchat account to use this actor?** No. Topic pages and Spotlight videos are publicly accessible on Snapchat's website. No login, cookies, or authentication is required. **What topic IDs can I use?** Any of Snapchat's built-in topic slugs such as `food`, `humor`, `travel`, `gaming`, `beauty`, `sports`, `technology`, `music`, `pets`, and `dance`. You can also paste a full topic URL like `https://www.snapchat.com/topic/food`. **Why is there a 32-video limit per topic?** Snapchat's public topic pages serve a fixed batch of up to 32 Spotlight videos. This actor returns all available videos in that batch. Running the actor again may return a different set of trending videos. **What are `llmTitle`, `llmDescription`, and `llmKeywords`?** These fields are generated by Snapchat's own AI system and are embedded in the page data. They summarize and tag the video content automatically — useful for downstream analysis without additional AI API calls. **What are `relatedTags`?** Related tags are Snapchat's S2I (Subject-to-Image) content classification labels associated with the topic. Each tag has a `tagName`, a relevance `score`, and a hierarchy `level`. These can be used to build a fine-grained content taxonomy. **Can I scrape multiple topics in a single run?** Yes. Provide multiple topic IDs or URLs in the `topics` array. The actor processes them sequentially and outputs records for all topics in a single dataset, each identified by `topicId` and `topicDisplayName`. **What is `remainingSpotlightCount`?** This field indicates how many additional Spotlight video IDs Snapchat has available for the topic beyond the current batch. It can be used to gauge topic popularity and overall content volume. *** ### 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 ## `topics` (type: `array`): Topic IDs or topic URLs. Examples: food, humor, travel, https://www.snapchat.com/topic/food ## `maxResultsPerTopic` (type: `integer`): Maximum spotlight records to return per topic (Snapchat serves up to 32 per page) ## `includeRelatedTags` (type: `boolean`): Include related S2I tags in each result record ## `proxyConfiguration` (type: `object`): Optional Apify proxy configuration. Public Snapchat pages work without proxy; include for resilience at scale. ## Actor input object example ```json { "topics": [ "food", "humor" ], "maxResultsPerTopic": 32, "includeRelatedTags": true } ``` # 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 = { "topics": [ "food", "humor" ] }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/snapchat-topic-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 = { "topics": [ "food", "humor", ] } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/snapchat-topic-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 '{ "topics": [ "food", "humor" ] }' | apify call crawlerbros/snapchat-topic-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/snapchat-topic-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Snapchat Topic Scraper", "description": "Scrape Snapchat topic pages - get spotlight videos, related tags, and topic metadata for any Snapchat topic.", "version": "0.1", "x-build-id": "np9T0lUZcK3M9NCre" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~snapchat-topic-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-snapchat-topic-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-topic-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-snapchat-topic-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-topic-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-snapchat-topic-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": [ "topics" ], "properties": { "topics": { "title": "Topics", "type": "array", "description": "Topic IDs or topic URLs. Examples: food, humor, travel, https://www.snapchat.com/topic/food", "items": { "type": "string" } }, "maxResultsPerTopic": { "title": "Max Results per Topic", "minimum": 1, "maximum": 32, "type": "integer", "description": "Maximum spotlight records to return per topic (Snapchat serves up to 32 per page)", "default": 32 }, "includeRelatedTags": { "title": "Include Related Tags", "type": "boolean", "description": "Include related S2I tags in each result record", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional Apify proxy configuration. Public Snapchat pages work without proxy; include for resilience at scale." } } }, "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 } } } } } } } } } } ```