Snapchat Highlight & Story Media Downloader

Pull individual snaps from a Snapchat profile's saved highlight albums and live story, with downloadable video/image links, post timestamps, and the creator's subscriber count and bio attached.

Open on Apify GitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

Field	Type	Required	Description
`mode`	string	optional	What to scrape. profiles = look up usernames or profile URLs and collect their highlights and active story. urls = process pasted profile, highlight or active-story snap links, including highlights that are not on the rendered profile page.
`usernames`	array	optional	(mode=profiles) One or more Snapchat usernames or profile URLs. Accepts bare username (brentrivera), @-prefixed (@brentrivera), add URL (https://www.snapchat.com/add/brentrivera) and profile URL (https://www.snapchat.com/@brentrivera).
`startUrls`	array	optional	(mode=urls) Paste profile links, highlight links (https://www.snapchat.com/@user/highlight/<id>) or active-story snap links (https://www.snapchat.com/@user/<snapId>). Each link is resolved to exactly the content it names.

Show all input fields

Field	Type	Required	Description
`mode`	string	optional	What to scrape. profiles = look up usernames or profile URLs and collect their highlights and active story. urls = process pasted profile, highlight or active-story snap links, including highlights that are not on the rendered profile page.
`usernames`	array	optional	(mode=profiles) One or more Snapchat usernames or profile URLs. Accepts bare username (brentrivera), @-prefixed (@brentrivera), add URL (https://www.snapchat.com/add/brentrivera) and profile URL (https://www.snapchat.com/@brentrivera).
`startUrls`	array	optional	(mode=urls) Paste profile links, highlight links (https://www.snapchat.com/@user/highlight/<id>) or active-story snap links (https://www.snapchat.com/@user/<snapId>). Each link is resolved to exactly the content it names.
`sources`	array	optional	Which story surfaces to collect in profiles mode. curatedHighlights = saved highlight albums. activeStory = the currently public 24-hour story. Highlight-link mode always returns the linked highlight.
`maxSnapsPerUser`	integer	optional	Maximum snaps to save per profile, highlight or story-snap target. Supports large highlight albums up to the clip length shown by Snapchat.
`maxHighlightsPerUser`	integer	optional	How many of a profile's saved highlight albums to read, in the order Snapchat renders them. 0 uses every highlight on the page.
`maxItems`	integer	optional	Hard cap on snap records saved in the run across all targets. The actor stops cleanly when it reaches this number.
`postedAfter`	string	optional	Only keep snaps posted on or after this date (YYYY-MM-DD or full ISO 8601). Saved highlights can stay live for years, so set this to your last run date when you only want new snaps. Leave empty for everything.
`downloadMedia`	boolean	optional	Download each image/video into this run's Apify key-value store and return permanent public URLs. The original Snapchat CDN URL stays in a matching *Original field. Capped at 200 files and 50 MB per file per run; failures keep the direct URL. Costs extra storage and bandwidth; off by default because Snapchat CDN links work for immediate downloads.
`proxyConfiguration`	object	optional	Optional Apify proxy override. Public Snapchat profiles work without a proxy.

Download the published input schema

View complete JSON

{
  "properties": {
    "downloadMedia": {
      "default": false,
      "description": "Download each image/video into this run's Apify key-value store and return permanent public URLs. The original Snapchat CDN URL stays in a matching *Original field. Capped at 200 files and 50 MB per file per run; failures keep the direct URL. Costs extra storage and bandwidth; off by default because Snapchat CDN links work for immediate downloads.",
      "prefill": false,
      "title": "Store Durable Media Copies",
      "type": "boolean"
    },
    "maxHighlightsPerUser": {
      "default": 0,
      "description": "How many of a profile's saved highlight albums to read, in the order Snapchat renders them. 0 uses every highlight on the page.",
      "editor": "number",
      "maximum": 100,
      "minimum": 0,
      "title": "Max Highlights Per Profile",
      "type": "integer"
    },
    "maxItems": {
      "default": 5000,
      "description": "Hard cap on snap records saved in the run across all targets. The actor stops cleanly when it reaches this number.",
      "editor": "number",
      "maximum": 100000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max Records",
      "type": "integer"
    },
    "maxSnapsPerUser": {
      "default": 50,
      "description": "Maximum snaps to save per profile, highlight or story-snap target. Supports large highlight albums up to the clip length shown by Snapchat.",
      "editor": "number",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max Snaps Per Target",
      "type": "integer"
    },
    "mode": {
      "default": "profiles",
      "description": "What to scrape. profiles = look up usernames or profile URLs and collect their highlights and active story. urls = process pasted profile, highlight or active-story snap links, including highlights that are not on the rendered profile page.",
      "editor": "select",
      "enum": [
        "profiles",
        "urls"
      ],
      "enumTitles": [
        "Profiles by username",
        "Pasted profile / highlight / story links"
      ],
      "prefill": "profiles",
      "title": "Mode",
      "type": "string"
    },
    "postedAfter": {
      "description": "Only keep snaps posted on or after this date (YYYY-MM-DD or full ISO 8601). Saved highlights can stay live for years, so set this to your last run date when you only want new snaps. Leave empty for everything.",
      "editor": "datepicker",
      "nullable": true,
      "title": "Posted After",
      "type": "string"
    },
    "proxyConfiguration": {
      "description": "Optional Apify proxy override. Public Snapchat profiles work without a proxy.",
      "editor": "proxy",
      "nullable": true,
      "title": "Proxy Configuration",
      "type": "object"
    },
    "sources": {
      "default": [
        "curatedHighlights",
        "activeStory"
      ],
      "description": "Which story surfaces to collect in profiles mode. curatedHighlights = saved highlight albums. activeStory = the currently public 24-hour story. Highlight-link mode always returns the linked highlight.",
      "editor": "select",
      "items": {
        "enum": [
          "curatedHighlights",
          "activeStory"
        ],
        "enumTitles": [
          "Curated highlights",
          "Active story"
        ],
        "type": "string"
      },
      "prefill": [
        "curatedHighlights",
        "activeStory"
      ],
      "title": "Story Sources",
      "type": "array"
    },
    "startUrls": {
      "description": "(mode=urls) Paste profile links, highlight links (https://www.snapchat.com/@user/highlight/<id>) or active-story snap links (https://www.snapchat.com/@user/<snapId>). Each link is resolved to exactly the content it names.",
      "editor": "requestListSources",
      "title": "Profile, Highlight or Story Links",
      "type": "array"
    },
    "usernames": {
      "description": "(mode=profiles) One or more Snapchat usernames or profile URLs. Accepts bare username (brentrivera), @-prefixed (@brentrivera), add URL (https://www.snapchat.com/add/brentrivera) and profile URL (https://www.snapchat.com/@brentrivera).",
      "editor": "stringList",
      "prefill": [
        "khaby.lame"
      ],
      "title": "Usernames or Profile URLs",
      "type": "array"
    }
  },
  "schemaVersion": 1,
  "title": "Snapchat User Stories Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

Field	Type	Required	Description
`snaps`	string	optional	Dataset containing all scraped Snapchat story and highlight snap records.

Download the published output schema

View complete JSON

{
  "actorOutputSchemaVersion": 1,
  "description": "One row per Snapchat highlight or active-story snap, with direct media download URLs, snap timestamps and metadata, and the creator's public profile details.",
  "properties": {
    "snaps": {
      "description": "Dataset containing all scraped Snapchat story and highlight snap records.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Snapchat snaps",
      "type": "string"
    }
  },
  "title": "Snapchat Story & Highlight Snaps Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON

{
  "actorSpecification": 1,
  "title": "Snapchat Story Snaps",
  "views": {
    "detailed": {
      "display": {
        "component": "table",
        "properties": {
          "address": {
            "format": "text",
            "label": "Address"
          },
          "attachmentUrl": {
            "format": "link",
            "label": "Attachment"
          },
          "attachmentUrlOriginal": {
            "format": "link",
            "label": "Attachment (original)"
          },
          "audioTranscriptionObjectUrl": {
            "format": "link",
            "label": "Audio Transcription"
          },
          "audioTranscriptionObjectUrlOriginal": {
            "format": "link",
            "label": "Audio Transcription (original)"
          },
          "bio": {
            "format": "text",
            "label": "Bio"
          },
          "canonicalUrlSuffix": {
            "format": "text",
            "label": "Canonical Suffix"
          },
          "displayName": {
            "format": "text",
            "label": "Display Name"
          },
          "emoji": {
            "format": "text",
            "label": "Emoji"
          },
          "error": {
            "format": "text",
            "label": "Error"
          },
          "hasAttachment": {
            "format": "text",
            "label": "Has Attachment"
          },
          "highlightId": {
            "format": "text",
            "label": "Highlight ID"
          },
          "highlightIndex": {
            "format": "number",
            "label": "Highlight #"
          },
          "highlightSnapCount": {
            "format": "number",
            "label": "Highlight Snaps"
          },
          "highlightThumbnailUrl": {
            "format": "link",
            "label": "Story Cover"
          },
          "highlightThumbnailUrlOriginal": {
            "format": "link",
            "label": "Story Cover (original)"
          },
          "inputUsername": {
            "format": "text",
            "label": "Input"
          },
          "intervalStartTimeMs": {
            "format": "number",
            "label": "Interval Start (ms)"
          },
          "isAttributed": {
            "format": "text",
            "label": "Attributed"
          },
          "isSponsored": {
            "format": "text",
            "label": "Sponsored"
          },
          "isVerified": {
            "format": "text",
            "label": "Verified"
          },
          "lat": {
            "format": "number",
            "label": "Latitude"
          },
          "lng": {
            "format": "number",
            "label": "Longitude"
          },
          "mediaContentType": {
            "format": "text",
            "label": "Media MIME"
          },
          "mediaPreviewUrl": {
            "format": "link",
            "label": "Preview"
          },
          "mediaPreviewUrlOriginal": {
            "format": "link",
            "label": "Preview (original)"
          },
          "mediaSizeBytes": {
            "format": "number",
            "label": "Media Size"
          },
          "mediaType": {
            "format": "text",
            "label": "Type"
          },
          "mediaUrl": {
            "format": "link",
            "label": "Media URL"
          },
          "mediaUrlOriginal": {
            "format": "link",
            "label": "Media URL (original)"
          },
          "overlayUrl": {
            "format": "link",
            "label": "Overlay"
          },
          "overlayUrlOriginal": {
            "format": "link",
            "label": "Overlay (original)"
          },
          "postedAt": {
            "format": "text",
            "label": "Posted At"
          },
          "profileCategory": {
            "format": "text",
            "label": "Category"
          },
          "profileCreatedAt": {
            "format": "text",
            "label": "Profile Created"
          },
          "profileHeroImageUrl": {
            "format": "link",
            "label": "Hero Image"
          },
          "profileHeroImageUrlOriginal": {
            "format": "link",
            "label": "Hero Image (original)"
          },
          "profilePictureUrl": {
            "format": "link",
            "label": "Avatar"
          },
          "profilePictureUrlOriginal": {
            "format": "link",
            "label": "Avatar (original)"
          },
          "profileStatus": {
            "format": "text",
            "label": "Profile Status"
          },
          "profileSubcategory": {
            "format": "text",
            "label": "Subcategory"
          },
          "profileUpdatedAt": {
            "format": "text",
            "label": "Profile Updated"
          },
          "profileUrl": {
            "format": "link",
            "label": "Profile"
          },
          "recordId": {
            "format": "text",
            "label": "Record ID"
          },
          "recordType": {
            "format": "text",
            "label": "Record Type"
          },
          "scrapedAt": {
            "format": "text",
            "label": "Scraped At"
          },
          "snapId": {
            "format": "text",
            "label": "Snap ID"
          },
          "snapIndex": {
            "format": "number",
            "label": "Snap #"
          },
          "snapMediaType": {
            "format": "number",
            "label": "Raw Media Type"
          },
          "snapSubtitles": {
            "format": "text",
            "label": "Snap Subtitles"
          },
          "snapTitle": {
            "format": "text",
            "label": "Snap Title"
          },
          "snapcodeImageUrl": {
            "format": "link",
            "label": "Snapcode"
          },
          "snapcodeImageUrlOriginal": {
            "format": "link",
            "label": "Snapcode (original)"
          },
          "sourceUrl": {
            "format": "link",
            "label": "Source Page"
          },
          "storyId": {
            "format": "text",
            "label": "Story ID"
          },
          "storyShareId": {
            "format": "text",
            "label": "Story Share ID"
          },
          "storySource": {
            "format": "text",
            "label": "Story Source"
          },
          "storySubtitle": {
            "format": "text",
            "label": "Story Subtitle"
          },
          "storyTapId": {
            "format": "text",
            "label": "Story Tap ID"
          },
          "storyTitle": {
            "format": "text",
            "label": "Story Title"
          },
          "storyType": {
            "format": "number",
            "label": "Story Type"
          },
          "subscriberCount": {
            "format": "number",
            "label": "Subscribers"
          },
          "targetType": {
            "format": "text",
            "label": "Target Type"
          },
          "thumbnailTiles": {
            "format": "text",
            "label": "Thumbnail Tiles"
          },
          "username": {
            "format": "text",
            "label": "Username"
          },
          "videoTrackUrl": {
            "format": "link",
            "label": "Video Track"
          },
          "videoTrackUrlOriginal": {
            "format": "link",
            "label": "Video Track (original)"
          },
          "websiteUrl": {
            "format": "link",
            "label": "Website"
          }
        }
      },
      "title": "Detailed View",
      "transformation": {
        "fields": [
          "recordId",
          "recordType",
          "targetType",
          "profileStatus",
          "username",
          "displayName",
          "isVerified",
          "subscriberCount",
          "bio",
          "profileUrl",
          "profilePictureUrl",
          "profilePictureUrlOriginal",
          "websiteUrl",
          "profileCategory",
          "profileSubcategory",
          "address",
          "snapcodeImageUrl",
          "snapcodeImageUrlOriginal",
          "profileHeroImageUrl",
          "profileHeroImageUrlOriginal",
          "profileCreatedAt",
          "profileUpdatedAt",
          "storySource",
          "storyType",
          "storyId",
          "highlightId",
          "highlightIndex",
          "highlightSnapCount",
          "storyTitle",
          "highlightThumbnailUrl",
          "highlightThumbnailUrlOriginal",
          "storySubtitle",
          "storyShareId",
          "canonicalUrlSuffix",
          "emoji",
          "storyTapId",
          "videoTrackUrl",
          "videoTrackUrlOriginal",
          "isAttributed",
          "thumbnailTiles",
          "snapIndex",
          "snapId",
          "snapMediaType",
          "mediaType",
          "mediaUrl",
          "mediaUrlOriginal",
          "mediaPreviewUrl",
          "mediaPreviewUrlOriginal",
          "overlayUrl",
          "overlayUrlOriginal",
          "attachmentUrl",
          "attachmentUrlOriginal",
          "postedAt",
          "intervalStartTimeMs",
          "snapTitle",
          "snapSubtitles",
          "lat",
          "lng",
          "hasAttachment",
          "isSponsored",
          "audioTranscriptionObjectUrl",
          "audioTranscriptionObjectUrlOriginal",
          "mediaContentType",
          "mediaSizeBytes",
          "sourceUrl",
          "scrapedAt",
          "inputUsername",
          "error"
        ]
      }
    },
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "displayName": {
            "format": "text",
            "label": "Display Name"
          },
          "mediaPreviewUrl": {
            "format": "link",
            "label": "Thumbnail"
          },
          "mediaType": {
            "format": "text",
            "label": "Type"
          },
          "mediaUrl": {
            "format": "link",
            "label": "Media URL"
          },
          "postedAt": {
            "format": "text",
            "label": "Posted At"
          },
          "snapIndex": {
            "format": "number",
            "label": "#"
          },
          "sourceUrl": {
            "format": "link",
            "label": "Source Page"
          },
          "storySource": {
            "format": "text",
            "label": "Source"
          },
          "storyTitle": {
            "format": "text",
            "label": "Story"
          },
          "username": {
            "format": "text",
            "label": "Username"
          }
        }
      },
      "title": "Story Overview",
      "transformation": {
        "fields": [
          "username",
          "displayName",
          "storySource",
          "storyTitle",
          "snapIndex",
          "mediaType",
          "postedAt",
          "mediaUrl",
          "mediaPreviewUrl",
          "sourceUrl"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Snapchat Highlight & Story Media Downloader

Collect the individual snaps inside public Snapchat highlight albums and active stories, then download them from the direct media URLs in each record. Add creator profile details, captions, timestamps and parent-story metadata without a Snapchat login, cookies or an API key. Point it at usernames or paste highlight/story links — one row per snap.

What this actor does

Two modes: profiles for a list of usernames/profile URLs, and urls for pasted profile, highlight or active-story snap links.
Both story surfaces: saved curated highlights and the creator's current public story, with a storySource value on every row.
Download-ready media: direct mediaUrl (MP4 or JPEG), mediaPreviewUrl, plus optional overlayUrl and attachmentUrl.
Durable copies: downloadMedia downloads each snap file and preview, plus the avatar, hero image, snapcode, cover, overlay and transcription into the run's Apify key-value store, returns a permanent public URL and keeps the original CDN link in a *Original field (up to 200 files and 50 MB per file per run).
Creator context: display name, verification, subscribers, bio, avatar, website, category, address, hero image and profile timestamps repeat on every snap.
Incremental runs: postedAfter skips long-lived highlight snaps you already collected, and maxItems, maxSnapsPerUser and maxHighlightsPerUser keep every run bounded.
Clean rows: empty fields are omitted — a snap without geotags, captions or a sponsorship flag simply has no such key.

Output per snap

recordId — stable natural key: the snap ID for active stories, or highlight ID + snap position for saved highlights
recordType, targetType, profileStatus — snap / profile, highlightUrl or storySnapUrl; public/private/notFound/noContent/unavailable
username, displayName, isVerified, profileUrl — creator identity
subscriberCount, bio, profilePictureUrl — public profile details
websiteUrl, address, profileCategory, profileSubcategory — public profile extras when present
snapcodeImageUrl, profileHeroImageUrl — Snapcode and profile hero image
profileCreatedAt, profileUpdatedAt — profile history timestamps
storySource — curatedHighlight or activeStory
storyId, storyType, highlightId, storyTitle, highlightThumbnailUrl — parent story identity and cover
highlightIndex, highlightSnapCount — position and size of the parent highlight
snapIndex, snapId, snapMediaType, mediaType — position, raw type and normalised image/video
mediaUrl, mediaPreviewUrl, overlayUrl, attachmentUrl — direct download and preview files
postedAt, intervalStartTimeMs — post time and any interval start supplied by Snapchat
snapTitle, snapSubtitles, lat, lng, hasAttachment, isSponsored — per-snap details when present
audioTranscriptionObjectUrl — transcription file link when Snapchat supplies one
storySubtitle, storyShareId, emoji, storyTapId, canonicalUrlSuffix, videoTrackUrl, isAttributed, thumbnailTiles — parent-story extras
mediaContentType, mediaSizeBytes — MIME type and byte size when downloadMedia is on
mediaUrlOriginal, mediaPreviewUrlOriginal, overlayUrlOriginal, attachmentUrlOriginal, profilePictureUrlOriginal, profileHeroImageUrlOriginal, snapcodeImageUrlOriginal, highlightThumbnailUrlOriginal, videoTrackUrlOriginal, audioTranscriptionObjectUrlOriginal — original CDN URLs kept when a field is rehosted
sourceUrl — the profile, highlight or story-snap page this row came from
scrapedAt — when the record was fetched
inputUsername, error — present instead of the snap fields on a failed target

Input

Field	Type	Default	Description
`mode`	string	`profiles`	`profiles` or `urls`.
`usernames`	array	–	Usernames or profile URLs (mode=profiles). Bare, `@name`, `/add/name` and `/@name` forms work.
`startUrls`	array	–	Profile, highlight or story-snap links (mode=urls).
`sources`	array	`["curatedHighlights", "activeStory"]`	`curatedHighlights` and/or `activeStory`.
`maxSnapsPerUser`	int	`50`	Maximum snaps per target (1–10,000).
`maxHighlightsPerUser`	int	`0`	How many highlights to read per profile; `0` means all rendered highlights (max 100).
`maxItems`	int	`5000`	Hard cap on records across the whole run (1–100,000).
`postedAfter`	string	–	Keep snaps posted on or after this date (`YYYY-MM-DD` or ISO 8601).
`downloadMedia`	boolean	`false`	Download media into the run's key-value store and return permanent public URLs. Capped at 200 files and 50 MB per file per run; failures fall back to the direct URL.
`proxyConfiguration`	object	–	Optional Apify proxy override; public profiles need no proxy.

Example: every snap from a creator

{
  "mode": "profiles",
  "usernames": ["brentrivera", "nba"],
  "sources": ["curatedHighlights", "activeStory"],
  "maxSnapsPerUser": 300,
  "maxItems": 600
}

Example: paste a shared highlight link

{
  "mode": "urls",
  "startUrls": [
    { "url": "https://www.snapchat.com/@kyliejenner/highlight/367bdbd7-d19a-4bf1-bc81-c3e73f7b1809" }
  ],
  "maxSnapsPerUser": 100
}

Example: only new snaps since the last run

{
  "mode": "profiles",
  "usernames": ["khaby.lame"],
  "sources": ["curatedHighlights"],
  "postedAfter": "2026-10-01",
  "maxItems": 100
}

Example: keep a durable copy of each file

{
  "mode": "profiles",
  "usernames": ["fcbarcelona"],
  "sources": ["activeStory"],
  "maxSnapsPerUser": 20,
  "downloadMedia": true
}

Use cases

Content archiving — save a permanent copy of a creator's highlight reel before it is edited or removed.
Influencer monitoring — track what a creator posts across saved highlights and the live story in one dataset.
Campaign research — pull sponsored snaps across several creators with isSponsored intact.
Social-listening pipelines — feed structured snap metadata, captions and timestamps into analytics.
Scheduled collection — use postedAfter and maxItems to run daily or weekly without re-downloading the same old highlights.

FAQ

Do I need a Snapchat account or cookies? No. The actor reads public profile and highlight pages over plain HTTP.

What is the difference between a curated highlight and an active story? Highlights are albums a creator saves and keeps on their profile. The active story is the current public 24-hour story. Both are collected by default; sources limits the run to one.

How many highlights can a profile have? Snapchat renders up to 18 saved highlights on the public profile page, and that is the ceiling this actor can see from a username. If you have a direct link to another highlight, paste it in urls mode to retrieve its snaps.

Why did a pasted story link return an error? Active stories are ephemeral. If the snap has expired, Snapchat no longer serves it and the actor records a profileStatus: "noContent" error row instead of failing the run.

Will mediaUrl still work later? Snapchat CDN links carry rotating signature tokens. They work immediately and usually for some time, but they are not permanent. Set downloadMedia to true if you need links that keep working. Rehosting is limited to 200 files and 50 MB per file per run; anything over a limit keeps the direct CDN URL.

How does maxSnapsPerUser interact with maxItems? maxSnapsPerUser caps each profile, highlight or story-snap target. maxItems caps the whole run across every target. The run stops cleanly when either limit is reached.

What happens to private or unknown accounts? The actor writes one diagnostic row per failed target with inputUsername, error and profileStatus, then continues with the remaining targets.

Are duplicate snaps possible? Each row has a deterministic recordId. Repeated targets and any record whose recordId was already emitted in the run are dropped, so overlapping inputs do not create duplicate rows.

Does this actor collect Spotlight, comments or lenses? No. Those are separate Snapchat surfaces with their own actors.

Is this affiliated with Snapchat? No. It is an independent third-party actor that reads public Snapchat pages and is not operated by or affiliated with Snap Inc.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build jnoJZ0OjjNipIstNX. Documentation is regenerated from the default published build; private drafts are not included.