Snapchat Spotlight Hashtag Video Extractor: MCP config, n8n workflow and API

{
  "mode": "hashtagFeed",
  "hashtags": [
    "food"
  ],
  "resultsPerHashtag": 3,
  "includeVideoUrls": true,
  "includeRelatedTopics": false,
  "includeLlmMetadata": true,
  "includeHashtagMetadata": true,
  "enrichDetails": false,
  "feedPages": 2,
  "maxItems": 3,
  "minViews": 0,
  "minLikes": 0,
  "sortBy": "source"
}

---
name: snapchat-spotlight-hashtag-video-extractor
description: "Snapchat Spotlight videos from hashtags, topics, specific URLs, or the paginated Spotlight feed, with creator, engagement, media, AI metadata, and hashtag context. Runs the Apify Actor vexaloom-labs/snapchat-spotlight-hashtag-video-extractor. Use when the user needs Snapchat data with fields such as snap_id, source_type, creator_username, description, view_count, like_count and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "vexaloom-labs/snapchat-spotlight-hashtag-video-extractor"
  store-url: "https://apify.com/vexaloom-labs/snapchat-spotlight-hashtag-video-extractor"
---

# Snapchat Spotlight Hashtag Video Extractor

Use this skill to fetch Snapchat data with the Apify Actor `vexaloom-labs/snapchat-spotlight-hashtag-video-extractor` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | one of `hashtagFeed`, `spotlightFeed`, `spotlightUrls` | Choose what to collect: videos for hashtags/topics, a paginated Spotlight feed, or specific Spotlight URLs. |
| `hashtags` | array | Used in Hashtag or topic videos mode. Bare words (food), hash-prefixed tags (#travel), path forms (/tag/food, /topic/cappuccino-foam-technique), or full Snapchat URLs (https://www.snapchat.com/tag/food, https://www.snapc… |
| `resultsPerHashtag` | integer | Maximum videos to keep for each hashtag after combining the tag/topic page with Explore results. Snapchat serves about 32 videos per tag page plus about 20-25 Explore cards. |
| `includeVideoUrls` | boolean | Include the watermarked and unwatermarked MP4 CDN URLs. These URLs carry expiring Snapchat tokens, so download or re-host media soon after scraping. |
| `includeRelatedTopics` | boolean | Include related topics, related hashtags, and scene-to-interest (S2I) content tags when the page provides them. |
| `includeLlmMetadata` | boolean | Include Snapchat's AI-generated title, description, and keywords when present. |
| `includeHashtagMetadata` | boolean | Include hashtag identity fields (id, name, URL, source, description, and total video count when Snapchat exposes it) in every record. |
| `enrichDetails` | boolean | Batch-fetch Snapchat's public video details endpoint to fill unwatermarked MP4 URLs, hashtags, AI metadata, duration, and exact engagement counts. Adds one request per 30 videos. |
| `spotlightUrls` | array | Used in Specific Spotlight URLs mode, or as the optional first seed in Paginated Spotlight feed mode. Accepts full Spotlight links (https://www.snapchat.com/@user/spotlight/ID), /spotlight/ID links, or raw IDs. |
| `feedPages` | integer | How many pages of the Spotlight up-next feed to request in Paginated Spotlight feed mode. Each page adds about 20-23 videos; pagination stops early when Snapchat runs out. |
| `maxItems` | integer | Hard cap on the total number of video rows saved across the whole run. |
| `minViews` | integer | Keep only videos with at least this many views. Use 0 to keep everything. |
| `minLikes` | integer | Keep only videos with at least this many likes. Use 0 to keep everything. |
| `sinceDate` | string | Keep only videos uploaded on or after this date. Use YYYY-MM-DD (for example 2026-01-01). Leave empty to keep all dates. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "hashtagFeed",
  "hashtags": [
    "food"
  ],
  "resultsPerHashtag": 3,
  "includeVideoUrls": true,
  "includeRelatedTopics": false,
  "includeLlmMetadata": true,
  "includeHashtagMetadata": true,
  "enrichDetails": false,
  "feedPages": 2,
  "maxItems": 3,
  "minViews": 0,
  "minLikes": 0,
  "sortBy": "source"
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/vexaloom-labs~snapchat-spotlight-hashtag-video-extractor/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/vexaloom-labs~snapchat-spotlight-hashtag-video-extractor/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `snap_id`, `source_type`, `creator_username`, `description`, `view_count`, `like_count`, `share_count`, `comment_count`, `duration_seconds`, `searched_hashtag`, `snap_url`, `record_type`, `rank`, `feed_page`, `story_id`, `composite_story_id`, `story_subtype`, `video_url`, `video_url_unwatermarked`, `thumbnail_url`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.