{
  "data": {
    "id": "0B1WSna9PhB5LeHFe",
    "actId": "1pDXF7JRNIfGATKcB",
    "userId": "zq8lKbpLzTjGDayPC",
    "startedAt": "2026-10-20T18:17:48.166Z",
    "finishedAt": "2026-10-20T18:17:52.688Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 4454,
      "runTimeSecs": 4.454,
      "computeUnits": 0.004948888888888889,
      "imageSizeBytes": 323758592
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Snapchat Topic Scraper\",\n  \"description\": \"Collect public Snapchat Spotlight videos from topic pages, hashtag feeds and the anonymous Spotlight feed, with creator, engagement, AI keywords, hashtags and S2I content tags. Discover related topics from keyword search.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"Choose what to collect: videos for topics/tags, topics for search keywords, or the current Spotlight feed.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"topicFeed\",\n        \"topicSearch\",\n        \"spotlightFeed\"\n      ],\n      \"enumTitles\": [\n        \"Topic or tag videos\",\n        \"Find topics by keyword\",\n        \"Spotlight trending feed\"\n      ],\n      \"default\": \"topicFeed\",\n      \"prefill\": \"topicFeed\"\n    },\n    \"topics\": {\n      \"title\": \"Topics or tags\",\n      \"type\": \"array\",\n      \"description\": \"Topic names, hashtags, or Snapchat URLs. Examples: food, #travel, https://www.snapchat.com/tag/food, https://www.snapchat.com/topic/cappuccino-foam-technique.\",\n      \"editor\": \"stringList\",\n      \"items\": {\n        \"type\": \"string\"\n      },\n      \"default\": [],\n      \"prefill\": [\n        \"food\"\n      ],\n      \"sectionCaption\": \"Topic videos\",\n      \"sectionDescription\": \"Used in Topic or tag videos mode. Each topic is checked on its topic and tag pages, then combined with Explore Spotlight results.\"\n    },\n    \"maxResultsPerTopic\": {\n      \"title\": \"Max videos per topic\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum videos to keep for each topic after combining its topic/tag page with Explore results. Snapchat serves 19-32 videos per page and the combined pool is usually 40-54.\",\n      \"default\": 50,\n      \"minimum\": 1,\n      \"maximum\": 100,\n      \"prefill\": 3\n    },\n    \"includeRelatedTags\": {\n      \"title\": \"Include S2I content tags\",\n      \"type\": \"boolean\",\n      \"description\": \"Include Snapchat's scene-to-interest (S2I) tags for each video when the page provides them. Coverage is partial, so the field is omitted when unavailable.\",\n      \"default\": true,\n      \"prefill\": false\n    },\n    \"searchQueries\": {\n      \"title\": \"Search keywords\",\n      \"type\": \"array\",\n      \"description\": \"Keywords or phrases used to discover topics, such as coffee, new york, or taylor swift.\",\n      \"editor\": \"stringList\",\n      \"items\": {\n        \"type\": \"string\"\n      },\n      \"default\": [],\n      \"prefill\": [],\n      \"sectionCaption\": \"Topic discovery\",\n      \"sectionDescription\": \"Used in Find topics by keyword mode.\"\n    },\n    \"maxTopicsPerQuery\": {\n      \"title\": \"Max topics per query\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum topic rows to keep for each search query, including related topics when expansion is enabled.\",\n      \"default\": 50,\n      \"minimum\": 1,\n      \"maximum\": 500,\n      \"prefill\": 50\n    },\n    \"includeRelatedTopics\": {\n      \"title\": \"Expand related topics\",\n      \"type\": \"boolean\",\n      \"description\": \"Add one hop of related topics found on each discovered topic's topic, tag, or Explore page. This follows public page links; it does not recurse further.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"enrichVideos\": {\n      \"title\": \"Enrich videos with detail pages\",\n      \"type\": \"boolean\",\n      \"description\": \"Visit each video's Spotlight page to fill missing AI title, comment/recommend counts, language, S2I tags and sound, and each creator's profile once for subscriberCount. Cached and bounded; failures keep the original row.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum rows to save across the whole run.\",\n      \"default\": 1000,\n      \"minimum\": 1,\n      \"maximum\": 10000,\n      \"prefill\": 3\n    }\n  },\n  \"required\": []\n}",
    "readme": "# Snapchat Topic Spotlight Feed & Content Tag Extractor\n\nCollect public Snapchat Spotlight videos from topic pages, hashtag feeds, keyword search and the anonymous Spotlight feed. Every video row carries its creator, engagement counts, duration, captions, Snapchat's AI title/description/keywords, hashtags, detected language and, when Snapchat provides them, S2I content tags.\n\nSnapchat spreads its public data across several server-rendered pages. This actor reads the surfaces that are actually live today and combines them:\n\n- **Topic pages** — long-tail topic hubs such as `snapchat.com/topic/cappuccino-foam-technique`, with 19-30 videos and a ranked list of related topics.\n- **Hashtag pages** — `snapchat.com/tag/food`, with up to 32 Spotlight cards.\n- **Explore search** — `snapchat.com/explore/<query>`, with 1-10 topic entities and 11-24 Spotlight cards (including unwatermarked video URLs).\n- **Spotlight feed** — `snapchat.com/spotlight`, with the current anonymous feed of about 25 videos.\n\nThere is no public pagination on these surfaces. The actor combines a topic's topic/tag page with its Explore results and de-duplicates by snap ID, which usually produces **40-54 unique videos per topic** instead of 19-32.\n\n## Modes\n\n### Topic or tag videos\n\nPaste topic names, hashtags or Snapchat URLs. The actor tries the topic page and the hashtag page, fetches the matching Explore page, and merges the results. Examples:\n\n- `food`\n- `#travel`\n- `https://www.snapchat.com/tag/food`\n- `https://www.snapchat.com/topic/cappuccino-foam-technique`\n- `https://www.snapchat.com/explore/viral`\n\nOld `/topic/food` URLs and bare short names keep working: Snapchat retired the generic `/topic/<short>` pages, so the actor automatically falls back to `/tag/food` and Explore.\n\n### Find topics by keyword\n\nGive one or more keywords and get topic rows with the topic slug, display name, Snapchat's reported snap count, thumbnail, icon and rank. Enable **Expand related topics** to add one hop of related topics from each discovered topic's page links.\n\n### Spotlight trending feed\n\nFetch the current anonymous Spotlight feed. Snapchat serves about 24-26 videos per request and the order can change between requests; there is no cursor to page further.\n\n## Output\n\nOne row per video, or one row per topic in topic-search mode.\n\nVideo fields:\n\n- `topicId`, `topicDisplayName`, `topicUrl`, `topicSource`, `rank` — where the video came from and its position on that surface\n- `snapId`, `storyId`, `compositeStoryId`, `snapUrl`, `embedUrl` — Snapchat identifiers and links\n- `videoUrl`, `videoUrlUnwatermarked`, `videoFormat`, `thumbnailUrl` — direct CDN media URLs\n- `creatorUsername`, `creatorDisplayName`, `creatorProfileUrl` — creator identity\n- `creatorSubscriberCount` — profile subscriber count, only with `enrichVideos`; cached once per creator and omitted when the profile does not expose it (distinct from `creatorFollowerCount`)\n- `viewCount`, `likeCount`, `shareCount`, `commentCount`, `recommendCount`, `pendingCommentCount`, `remixCount` — public engagement counts\n- `durationSeconds`, `width`, `height` — media properties\n- `description`, `caption` — original Snapchat text\n- `llmTitle`, `llmDescription`, `llmKeywords` — Snapchat's own AI metadata\n- `hashtags`, `detectedLanguage`, `relatedTags` — hashtags, language and S2I content tags\n- `soundTitle`, `soundArtist` — sound information when the feed/detail surface provides it\n- `uploadedAt`, `scrapedAt` — ISO 8601 UTC timestamps\n\nTopic fields:\n\n- `topicId`, `topicDisplayName`, `topicUrl`, `topicSource`, `rank`\n- `numSnaps`, `topicType`, `thumbnailUrl`, `iconUrl`\n- `searchQuery`, `relatedTo`\n- `scrapedAt`\n\nFields a surface does not provide are omitted from that row, never written as `null`. `creatorFollowerCount` and `remainingSpotlightCount` remain in the dataset schema for backward compatibility but are not populated because Snapchat no longer exposes them on these pages.\n\n## Input\n\n| Field | Default | Description |\n| --- | --- | --- |\n| `mode` | `topicFeed` | `topicFeed`, `topicSearch` or `spotlightFeed`. |\n| `topics` | `[]` | Topic names, hashtags or URLs for topic-feed mode. |\n| `maxResultsPerTopic` | `50` | Maximum videos per topic after merging surfaces. |\n| `includeRelatedTags` | `true` | Include S2I content tags when the page provides them. |\n| `searchQueries` | `[]` | Keywords for topic-search mode. |\n| `maxTopicsPerQuery` | `50` | Maximum topic rows per query, including related topics. |\n| `includeRelatedTopics` | `false` | Add one hop of related topics. |\n| `enrichVideos` | `false` | Visit each video page for missing AI title, counts, language, S2I tags and sound, plus each creator profile once for `creatorSubscriberCount`. Cached, bounded, and distinct from followers. |\n| `maxItems` | `1000` | Maximum rows across the whole run. |\n\n### Example: three topics\n\n```json\n{\n  \"mode\": \"topicFeed\",\n  \"topics\": [\"food\", \"travel\", \"#gaming\"],\n  \"maxResultsPerTopic\": 50,\n  \"includeRelatedTags\": true\n}\n```\n\n### Example: discover coffee topics\n\n```json\n{\n  \"mode\": \"topicSearch\",\n  \"searchQueries\": [\"coffee\", \"latte art\"],\n  \"maxTopicsPerQuery\": 50,\n  \"includeRelatedTopics\": true\n}\n```\n\n### Example: current Spotlight feed\n\n```json\n{\n  \"mode\": \"spotlightFeed\",\n  \"maxItems\": 25\n}\n```\n\n### Example: enrich a few videos\n\n```json\n{\n  \"mode\": \"topicFeed\",\n  \"topics\": [\"cappuccino-foam-technique\"],\n  \"maxResultsPerTopic\": 5,\n  \"enrichVideos\": true\n}\n```\n\n## Use cases\n\n- **Trend research** — see which Spotlight videos Snapchat surfaces for a topic today and how they perform.\n- **Content tagging** — collect Snapchat's AI keywords, hashtags, detected language and S2I tags for a niche.\n- **Creator discovery** — find creators with strong engagement inside a topic.\n- **Topic mapping** — start from a keyword, discover topic entities, then expand one hop through related topics.\n- **Performance tracking** — schedule repeated runs and compare view, like, share, comment and recommend counts over time.\n\n## FAQ\n\n**Do I need a Snapchat account or cookies?**\nNo. Every surface used here is public and works without a login, cookie or proxy.\n\n**Why do some tags return no results?**\nSnapchat serves 19-32 videos on a topic or tag page and 11-24 on its Explore page, and the actor merges both. Some slugs in Snapchat's tag sitemap are stale and return 404 on `/tag/`; the actor retries once, checks the topic page, then uses Explore only when its cards are relevant (an exact topic entity or at least 15% text match). Otherwise the run reports an honest zero-row status. Long non-Latin queries (roughly over 50 percent-encoded bytes) can also return 403 from Snapchat's edge; use a shorter keyword.\n\n**Why is there no next-page option?**\nThe public web pages do not expose working pagination. `page`, `cursor`, `offset` and `limit` parameters are ignored by Snapchat, so a run reports honestly when a source is exhausted. For more coverage, add related topics or run topic search.\n\n**What are S2I content tags?**\nSnapchat's scene-to-interest tags classify what is in a video. They are available on only part of the catalogue, so the `relatedTags` field is omitted when the page does not include them. AI keywords (`llmKeywords`) have much better coverage.\n\n**Why do `creatorFollowerCount` and `remainingSpotlightCount` not appear?**\nSnapchat reports follower count as `0` on these public surfaces and no longer serves `remainingSpotlightIds` on topic pages. The fields stay in the schema for old integrations but are not fabricated. With `enrichVideos`, `creatorSubscriberCount` adds the real profile subscriber count when available (up to 200 unique creators per run); it is not the same metric as follower count.\n\n**Why do the video URLs contain long parameters?**\n`mo` and `uc` are optional CDN media/context parameters, not signatures or expiry tokens. The bare CDN path also returns the same file: in a 30-URL sample, both the full URL and the URL with the query removed returned 200 `video/mp4`. The actor therefore does not re-host media. Snapchat can still remove or rotate content, so archive the files if you need permanent copies.\n\n**Can I get the trending feed for a specific country?**\nNo. Snapchat's web feed has no working country parameter; `country`, `geo`, `region`, `countryCode`, locale and country headers all leave the same randomized 24-26 video slice. Use a topic or keyword for targeting instead.\n\n**Can I browse all 643,000 topics from the sitemap?**\nNo. The topic sitemap is about 97 MB across 65 unordered shards with no popularity ranking. Keyword search plus one-hop related topics is the useful discovery path.\n\n**What does `enrichVideos` add?**\nEach video's Spotlight page is read separately, filling missing AI title/description, comment and recommend counts, language, S2I tags and sound. It also fetches each unique creator's profile once (cached, up to 200 per run) for `creatorSubscriberCount`. That number is a profile metric, not a follower count. Failed detail or profile requests keep the original row unchanged.\n\n**Is this affiliated with Snapchat?**\nNo. This actor reads public Snapchat pages and is not affiliated with Snap Inc.\n\n## Data source and limitations\n\nThe actor reads `snapchat.com` server-rendered pages with plain HTTP requests. No browser is required. It does not log in, solve CAPTCHAs, or bypass access controls. Snapchat changes its pages from time to time; the actor falls back between topic, tag and Explore surfaces and reports source exhaustion in the run status.\n\nKnown limits: no surface exposes working pagination, so one topic yields 40-56 unique videos from the merged surfaces; stale tag sitemap slugs return 404; long non-Latin Explore queries can return 403; S2I tags are present on only part of the catalogue; follower counts are always reported as zero on public video pages; and the anonymous Spotlight feed cannot be pinned to a country. Comment text and transcripts are out of scope here; they are covered by the Snapchat comments and video-downloader actors.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "snapchat-topic-spotlight-feed-and-content-tag",
      "title": "Snapchat Topic Spotlight Feed & Content Tag Extractor",
      "description": "Collect Snapchat Spotlight videos from topic and hashtag pages plus the anonymous feed — creator, views, likes, shares, AI title/keywords, hashtags and S2I content tags, with keyword topic discovery.",
      "version": "1.1",
      "buildTag": "latest",
      "defaultRunOptions": {
        "build": "latest",
        "timeoutSecs": 300,
        "memoryMbytes": 1024
      },
      "meta": {
        "templateId": "python-start"
      },
      "readme": "# Snapchat Topic Spotlight Feed & Content Tag Extractor\n\nCollect public Snapchat Spotlight videos from topic pages, hashtag feeds, keyword search and the anonymous Spotlight feed. Every video row carries its creator, engagement counts, duration, captions, Snapchat's AI title/description/keywords, hashtags, detected language and, when Snapchat provides them, S2I content tags.\n\nSnapchat spreads its public data across several server-rendered pages. This actor reads the surfaces that are actually live today and combines them:\n\n- **Topic pages** — long-tail topic hubs such as `snapchat.com/topic/cappuccino-foam-technique`, with 19-30 videos and a ranked list of related topics.\n- **Hashtag pages** — `snapchat.com/tag/food`, with up to 32 Spotlight cards.\n- **Explore search** — `snapchat.com/explore/<query>`, with 1-10 topic entities and 11-24 Spotlight cards (including unwatermarked video URLs).\n- **Spotlight feed** — `snapchat.com/spotlight`, with the current anonymous feed of about 25 videos.\n\nThere is no public pagination on these surfaces. The actor combines a topic's topic/tag page with its Explore results and de-duplicates by snap ID, which usually produces **40-54 unique videos per topic** instead of 19-32.\n\n## Modes\n\n### Topic or tag videos\n\nPaste topic names, hashtags or Snapchat URLs. The actor tries the topic page and the hashtag page, fetches the matching Explore page, and merges the results. Examples:\n\n- `food`\n- `#travel`\n- `https://www.snapchat.com/tag/food`\n- `https://www.snapchat.com/topic/cappuccino-foam-technique`\n- `https://www.snapchat.com/explore/viral`\n\nOld `/topic/food` URLs and bare short names keep working: Snapchat retired the generic `/topic/<short>` pages, so the actor automatically falls back to `/tag/food` and Explore.\n\n### Find topics by keyword\n\nGive one or more keywords and get topic rows with the topic slug, display name, Snapchat's reported snap count, thumbnail, icon and rank. Enable **Expand related topics** to add one hop of related topics from each discovered topic's page links.\n\n### Spotlight trending feed\n\nFetch the current anonymous Spotlight feed. Snapchat serves about 24-26 videos per request and the order can change between requests; there is no cursor to page further.\n\n## Output\n\nOne row per video, or one row per topic in topic-search mode.\n\nVideo fields:\n\n- `topicId`, `topicDisplayName`, `topicUrl`, `topicSource`, `rank` — where the video came from and its position on that surface\n- `snapId`, `storyId`, `compositeStoryId`, `snapUrl`, `embedUrl` — Snapchat identifiers and links\n- `videoUrl`, `videoUrlUnwatermarked`, `videoFormat`, `thumbnailUrl` — direct CDN media URLs\n- `creatorUsername`, `creatorDisplayName`, `creatorProfileUrl` — creator identity\n- `creatorSubscriberCount` — profile subscriber count, only with `enrichVideos`; cached once per creator and omitted when the profile does not expose it (distinct from `creatorFollowerCount`)\n- `viewCount`, `likeCount`, `shareCount`, `commentCount`, `recommendCount`, `pendingCommentCount`, `remixCount` — public engagement counts\n- `durationSeconds`, `width`, `height` — media properties\n- `description`, `caption` — original Snapchat text\n- `llmTitle`, `llmDescription`, `llmKeywords` — Snapchat's own AI metadata\n- `hashtags`, `detectedLanguage`, `relatedTags` — hashtags, language and S2I content tags\n- `soundTitle`, `soundArtist` — sound information when the feed/detail surface provides it\n- `uploadedAt`, `scrapedAt` — ISO 8601 UTC timestamps\n\nTopic fields:\n\n- `topicId`, `topicDisplayName`, `topicUrl`, `topicSource`, `rank`\n- `numSnaps`, `topicType`, `thumbnailUrl`, `iconUrl`\n- `searchQuery`, `relatedTo`\n- `scrapedAt`\n\nFields a surface does not provide are omitted from that row, never written as `null`. `creatorFollowerCount` and `remainingSpotlightCount` remain in the dataset schema for backward compatibility but are not populated because Snapchat no longer exposes them on these pages.\n\n## Input\n\n| Field | Default | Description |\n| --- | --- | --- |\n| `mode` | `topicFeed` | `topicFeed`, `topicSearch` or `spotlightFeed`. |\n| `topics` | `[]` | Topic names, hashtags or URLs for topic-feed mode. |\n| `maxResultsPerTopic` | `50` | Maximum videos per topic after merging surfaces. |\n| `includeRelatedTags` | `true` | Include S2I content tags when the page provides them. |\n| `searchQueries` | `[]` | Keywords for topic-search mode. |\n| `maxTopicsPerQuery` | `50` | Maximum topic rows per query, including related topics. |\n| `includeRelatedTopics` | `false` | Add one hop of related topics. |\n| `enrichVideos` | `false` | Visit each video page for missing AI title, counts, language, S2I tags and sound, plus each creator profile once for `creatorSubscriberCount`. Cached, bounded, and distinct from followers. |\n| `maxItems` | `1000` | Maximum rows across the whole run. |\n\n### Example: three topics\n\n```json\n{\n  \"mode\": \"topicFeed\",\n  \"topics\": [\"food\", \"travel\", \"#gaming\"],\n  \"maxResultsPerTopic\": 50,\n  \"includeRelatedTags\": true\n}\n```\n\n### Example: discover coffee topics\n\n```json\n{\n  \"mode\": \"topicSearch\",\n  \"searchQueries\": [\"coffee\", \"latte art\"],\n  \"maxTopicsPerQuery\": 50,\n  \"includeRelatedTopics\": true\n}\n```\n\n### Example: current Spotlight feed\n\n```json\n{\n  \"mode\": \"spotlightFeed\",\n  \"maxItems\": 25\n}\n```\n\n### Example: enrich a few videos\n\n```json\n{\n  \"mode\": \"topicFeed\",\n  \"topics\": [\"cappuccino-foam-technique\"],\n  \"maxResultsPerTopic\": 5,\n  \"enrichVideos\": true\n}\n```\n\n## Use cases\n\n- **Trend research** — see which Spotlight videos Snapchat surfaces for a topic today and how they perform.\n- **Content tagging** — collect Snapchat's AI keywords, hashtags, detected language and S2I tags for a niche.\n- **Creator discovery** — find creators with strong engagement inside a topic.\n- **Topic mapping** — start from a keyword, discover topic entities, then expand one hop through related topics.\n- **Performance tracking** — schedule repeated runs and compare view, like, share, comment and recommend counts over time.\n\n## FAQ\n\n**Do I need a Snapchat account or cookies?**\nNo. Every surface used here is public and works without a login, cookie or proxy.\n\n**Why do some tags return no results?**\nSnapchat serves 19-32 videos on a topic or tag page and 11-24 on its Explore page, and the actor merges both. Some slugs in Snapchat's tag sitemap are stale and return 404 on `/tag/`; the actor retries once, checks the topic page, then uses Explore only when its cards are relevant (an exact topic entity or at least 15% text match). Otherwise the run reports an honest zero-row status. Long non-Latin queries (roughly over 50 percent-encoded bytes) can also return 403 from Snapchat's edge; use a shorter keyword.\n\n**Why is there no next-page option?**\nThe public web pages do not expose working pagination. `page`, `cursor`, `offset` and `limit` parameters are ignored by Snapchat, so a run reports honestly when a source is exhausted. For more coverage, add related topics or run topic search.\n\n**What are S2I content tags?**\nSnapchat's scene-to-interest tags classify what is in a video. They are available on only part of the catalogue, so the `relatedTags` field is omitted when the page does not include them. AI keywords (`llmKeywords`) have much better coverage.\n\n**Why do `creatorFollowerCount` and `remainingSpotlightCount` not appear?**\nSnapchat reports follower count as `0` on these public surfaces and no longer serves `remainingSpotlightIds` on topic pages. The fields stay in the schema for old integrations but are not fabricated. With `enrichVideos`, `creatorSubscriberCount` adds the real profile subscriber count when available (up to 200 unique creators per run); it is not the same metric as follower count.\n\n**Why do the video URLs contain long parameters?**\n`mo` and `uc` are optional CDN media/context parameters, not signatures or expiry tokens. The bare CDN path also returns the same file: in a 30-URL sample, both the full URL and the URL with the query removed returned 200 `video/mp4`. The actor therefore does not re-host media. Snapchat can still remove or rotate content, so archive the files if you need permanent copies.\n\n**Can I get the trending feed for a specific country?**\nNo. Snapchat's web feed has no working country parameter; `country`, `geo`, `region`, `countryCode`, locale and country headers all leave the same randomized 24-26 video slice. Use a topic or keyword for targeting instead.\n\n**Can I browse all 643,000 topics from the sitemap?**\nNo. The topic sitemap is about 97 MB across 65 unordered shards with no popularity ranking. Keyword search plus one-hop related topics is the useful discovery path.\n\n**What does `enrichVideos` add?**\nEach video's Spotlight page is read separately, filling missing AI title/description, comment and recommend counts, language, S2I tags and sound. It also fetches each unique creator's profile once (cached, up to 200 per run) for `creatorSubscriberCount`. That number is a profile metric, not a follower count. Failed detail or profile requests keep the original row unchanged.\n\n**Is this affiliated with Snapchat?**\nNo. This actor reads public Snapchat pages and is not affiliated with Snap Inc.\n\n## Data source and limitations\n\nThe actor reads `snapchat.com` server-rendered pages with plain HTTP requests. No browser is required. It does not log in, solve CAPTCHAs, or bypass access controls. Snapchat changes its pages from time to time; the actor falls back between topic, tag and Explore surfaces and reports source exhaustion in the run status.\n\nKnown limits: no surface exposes working pagination, so one topic yields 40-56 unique videos from the merged surfaces; stale tag sitemap slugs return 404; long non-Latin Explore queries can return 403; S2I tags are present on only part of the catalogue; follower counts are always reported as zero on public video pages; and the anonymous Spotlight feed cannot be pinned to a country. Comment text and transcripts are out of scope here; they are covered by the Snapchat comments and video-downloader actors.\n",
      "input": {
        "title": "Snapchat Topic Scraper",
        "description": "Collect public Snapchat Spotlight videos from topic pages, hashtag feeds and the anonymous Spotlight feed, with creator, engagement, AI keywords, hashtags and S2I content tags. Discover related topics from keyword search.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "Choose what to collect: videos for topics/tags, topics for search keywords, or the current Spotlight feed.",
            "editor": "select",
            "enum": [
              "topicFeed",
              "topicSearch",
              "spotlightFeed"
            ],
            "enumTitles": [
              "Topic or tag videos",
              "Find topics by keyword",
              "Spotlight trending feed"
            ],
            "default": "topicFeed",
            "prefill": "topicFeed"
          },
          "topics": {
            "title": "Topics or tags",
            "type": "array",
            "description": "Topic names, hashtags, or Snapchat URLs. Examples: food, #travel, https://www.snapchat.com/tag/food, https://www.snapchat.com/topic/cappuccino-foam-technique.",
            "editor": "stringList",
            "items": {
              "type": "string"
            },
            "default": [],
            "prefill": [
              "food"
            ],
            "sectionCaption": "Topic videos",
            "sectionDescription": "Used in Topic or tag videos mode. Each topic is checked on its topic and tag pages, then combined with Explore Spotlight results."
          },
          "maxResultsPerTopic": {
            "title": "Max videos per topic",
            "type": "integer",
            "description": "Maximum videos to keep for each topic after combining its topic/tag page with Explore results. Snapchat serves 19-32 videos per page and the combined pool is usually 40-54.",
            "default": 50,
            "minimum": 1,
            "maximum": 100,
            "prefill": 3
          },
          "includeRelatedTags": {
            "title": "Include S2I content tags",
            "type": "boolean",
            "description": "Include Snapchat's scene-to-interest (S2I) tags for each video when the page provides them. Coverage is partial, so the field is omitted when unavailable.",
            "default": true,
            "prefill": false
          },
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Keywords or phrases used to discover topics, such as coffee, new york, or taylor swift.",
            "editor": "stringList",
            "items": {
              "type": "string"
            },
            "default": [],
            "prefill": [],
            "sectionCaption": "Topic discovery",
            "sectionDescription": "Used in Find topics by keyword mode."
          },
          "maxTopicsPerQuery": {
            "title": "Max topics per query",
            "type": "integer",
            "description": "Maximum topic rows to keep for each search query, including related topics when expansion is enabled.",
            "default": 50,
            "minimum": 1,
            "maximum": 500,
            "prefill": 50
          },
          "includeRelatedTopics": {
            "title": "Expand related topics",
            "type": "boolean",
            "description": "Add one hop of related topics found on each discovered topic's topic, tag, or Explore page. This follows public page links; it does not recurse further.",
            "default": false,
            "prefill": false
          },
          "enrichVideos": {
            "title": "Enrich videos with detail pages",
            "type": "boolean",
            "description": "Visit each video's Spotlight page to fill missing AI title, comment/recommend counts, language, S2I tags and sound, and each creator's profile once for subscriberCount. Cached and bounded; failures keep the original row.",
            "default": false,
            "prefill": false
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Maximum rows to save across the whole run.",
            "default": 1000,
            "minimum": 1,
            "maximum": 10000,
            "prefill": 3
          }
        },
        "required": []
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Snapchat Topic Spotlight Feed & Content Tag Extractor Output",
        "description": "Videos from Snapchat topic and hashtag pages plus the anonymous Spotlight feed, with creator, engagement, AI keywords, hashtags and S2I content tags; plus topic-discovery rows from keyword search.",
        "properties": {
          "results": {
            "type": "string",
            "title": "Snapchat videos and topics",
            "description": "Dataset containing Spotlight videos and discovered topic rows.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          },
          "topics": {
            "type": "string",
            "title": "Discovered topics",
            "description": "Topic rows found by keyword search and one-hop related-topic expansion.",
            "template": "{{links.apiDefaultDatasetUrl}}/items?view=topics"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "title": "Snapchat Topic & Spotlight videos",
          "fields": {
            "type": "object",
            "properties": {
              "recordType": {
                "type": "string",
                "description": "Row shape: video or topic"
              },
              "topicId": {
                "type": "string",
                "description": "Topic or hashtag slug"
              },
              "topicDisplayName": {
                "type": "string",
                "description": "Human-readable topic or hashtag label"
              },
              "topicUrl": {
                "type": "string",
                "description": "Canonical Snapchat topic, tag or Explore URL"
              },
              "topicDescription": {
                "type": "string",
                "description": "Snapchat's topic summary, when the topic hub provides one"
              },
              "topicSource": {
                "type": "string",
                "description": "Surface that supplied the row: tagPage, topicPage, exploreSearch, exploreFallback, relatedTopic or spotlightFeed"
              },
              "rank": {
                "type": "integer",
                "description": "1-based position on the source surface"
              },
              "searchQuery": {
                "type": "string",
                "description": "Search keyword that produced a topic row"
              },
              "relatedTo": {
                "type": "string",
                "description": "Seed topic ID for a one-hop related topic row"
              },
              "numSnaps": {
                "type": "integer",
                "description": "Snapchat's reported number of snaps for a topic"
              },
              "topicType": {
                "type": "integer",
                "description": "Snapchat topic type code"
              },
              "iconUrl": {
                "type": "string",
                "description": "Topic icon URL"
              },
              "snapId": {
                "type": "string",
                "description": "Spotlight snap ID"
              },
              "storyId": {
                "type": "string",
                "description": "Snapchat story ID"
              },
              "compositeStoryId": {
                "type": "object",
                "description": "Composite story ID with corpus, id and version"
              },
              "snapUrl": {
                "type": "string",
                "description": "Public Snapchat Spotlight URL"
              },
              "embedUrl": {
                "type": "string",
                "description": "Embeddable Spotlight URL"
              },
              "videoUrl": {
                "type": "string",
                "description": "Direct Snapchat CDN video URL (signed)"
              },
              "videoUrlUnwatermarked": {
                "type": "string",
                "description": "Unwatermarked CDN video URL, when Explore provides it"
              },
              "videoFormat": {
                "type": "string",
                "description": "Video MIME type from topic JSON-LD"
              },
              "thumbnailUrl": {
                "type": "string",
                "description": "Thumbnail image URL"
              },
              "creatorUsername": {
                "type": "string",
                "description": "Creator Snapchat username"
              },
              "creatorDisplayName": {
                "type": "string",
                "description": "Creator display name"
              },
              "creatorProfileUrl": {
                "type": "string",
                "description": "Creator profile URL"
              },
              "creatorFollowerCount": {
                "type": "integer",
                "description": "Legacy field; Snapchat reports 0 on these public surfaces"
              },
              "creatorSubscriberCount": {
                "type": "integer",
                "description": "Creator subscriber count from the public profile page; only with enrichVideos, cached once per creator, and distinct from followerCount"
              },
              "viewCount": {
                "type": "integer",
                "description": "Public view count"
              },
              "likeCount": {
                "type": "integer",
                "description": "Boost/like count"
              },
              "shareCount": {
                "type": "integer",
                "description": "Share count"
              },
              "commentCount": {
                "type": "integer",
                "description": "Live public comment/reply count"
              },
              "pendingCommentCount": {
                "type": "integer",
                "description": "Pending comment count, when greater than zero"
              },
              "remixCount": {
                "type": "integer",
                "description": "Remix count, when greater than zero"
              },
              "recommendCount": {
                "type": "integer",
                "description": "Recommend count"
              },
              "durationSeconds": {
                "type": "number",
                "description": "Video duration in seconds"
              },
              "width": {
                "type": "integer",
                "description": "Video width in pixels"
              },
              "height": {
                "type": "integer",
                "description": "Video height in pixels"
              },
              "description": {
                "type": "string",
                "description": "Original Snapchat caption or description"
              },
              "caption": {
                "type": "string",
                "description": "On-screen caption or secondary caption, when provided"
              },
              "llmTitle": {
                "type": "string",
                "description": "Snapchat-generated AI title"
              },
              "llmDescription": {
                "type": "string",
                "description": "Snapchat-generated AI scene description"
              },
              "llmKeywords": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Snapchat-generated AI keywords"
              },
              "hashtags": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Hashtags found on the video"
              },
              "detectedLanguage": {
                "type": "string",
                "description": "Highest-scoring detected language code"
              },
              "relatedTags": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "S2I content tags with tagName and optional score"
              },
              "soundTitle": {
                "type": "string",
                "description": "Sound title from a Spotlight context card"
              },
              "soundArtist": {
                "type": "string",
                "description": "Sound artist from a Spotlight context card"
              },
              "isFeatured": {
                "type": "boolean",
                "description": "Legacy field; true when Snapchat marks the video featured"
              },
              "storySubtype": {
                "type": "integer",
                "description": "Legacy field; Snapchat story subtype code"
              },
              "uploadedAt": {
                "type": "string",
                "description": "Upload timestamp in ISO 8601 UTC"
              },
              "latestUpdateAt": {
                "type": "string",
                "description": "Legacy field; latest story update in ISO 8601 UTC"
              },
              "remainingSpotlightCount": {
                "type": "integer",
                "description": "Legacy field; no longer served by Snapchat"
              },
              "scrapedAt": {
                "type": "string",
                "description": "Collection timestamp in ISO 8601 UTC"
              }
            }
          },
          "views": {
            "overview": {
              "title": "Overview",
              "transformation": {
                "fields": [
                  "topicId",
                  "snapId",
                  "creatorUsername",
                  "viewCount",
                  "uploadedAt",
                  "snapUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {
                  "topicId": {
                    "label": "Topic",
                    "format": "text"
                  },
                  "snapId": {
                    "label": "Snap",
                    "format": "text"
                  },
                  "creatorUsername": {
                    "label": "Creator",
                    "format": "text"
                  },
                  "viewCount": {
                    "label": "Views",
                    "format": "number"
                  },
                  "uploadedAt": {
                    "label": "Uploaded",
                    "format": "date"
                  },
                  "snapUrl": {
                    "label": "Spotlight",
                    "format": "link"
                  }
                }
              }
            },
            "topics": {
              "title": "Topics",
              "transformation": {
                "fields": [
                  "topicId",
                  "topicDisplayName",
                  "numSnaps",
                  "topicUrl",
                  "relatedTo",
                  "searchQuery"
                ]
              },
              "display": {
                "component": "table",
                "properties": {
                  "topicId": {
                    "label": "Topic",
                    "format": "text"
                  },
                  "topicDisplayName": {
                    "label": "Label",
                    "format": "text"
                  },
                  "numSnaps": {
                    "label": "Snaps",
                    "format": "number"
                  },
                  "topicUrl": {
                    "label": "Topic page",
                    "format": "link"
                  },
                  "relatedTo": {
                    "label": "Related to",
                    "format": "text"
                  },
                  "searchQuery": {
                    "label": "Query",
                    "format": "text"
                  }
                }
              }
            }
          }
        }
      },
      "dockerfile": "../Dockerfile"
    },
    "buildNumber": "1.1.1",
    "imageDigest": "07f780b97c8ba743c79e3993179b95087b1a32e349baab7892dacb1dc9d68968",
    "actVersion": {
      "sourceType": "TARBALL",
      "buildTag": "latest",
      "versionNumber": "1.1"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.004948888888888889
    }
  }
}