Snapchat Lens Scraper

Scrape Snapchat AR lens metadata — trending lenses from the home page, full lens details by UUID or URL, or lens search results by keyword. Extracts lens name, creator info, preview images and videos, unlock URL, search tags, related lenses, and Spotlight videos using each lens. No login, no cookies required.

What You Get

• Lens UUID, name, and creator details (display name, username)
• Preview image and preview video URL for the lens effect
• Icon thumbnail URL used in lens carousels
• Unlock URL to open the lens directly in the Snapchat app
• Creator profile URL and discoverability search tags
• Official Snap lens flag and last updated timestamp
• Related lenses shown on the detail page (up to ~11)
• Spotlight videos that use the lens, with thumbnail and video metadata
• Three modes: trending home page, detail by URL/UUID, keyword search

Input

Field	Type	Required	Default	Description
mode	string	No	detail	Scraping mode: home (top 25 trending), detail (by URL or UUID), search (by keyword)
lensUrlsOrIds	string[]	detail mode	—	Lens page URLs, unlock URLs, or bare UUIDs
keywords	string[]	search mode	—	Keywords to find lenses via Snapchat's explore page
includeMoreLenses	boolean	No	true	Include related lenses shown on the detail page
includeSpotlightsUsingLens	boolean	No	true	Include Spotlight videos that use this lens
proxyConfiguration	object	No	—	Optional proxy settings

Supported Lens Input Formats (detail mode)

Format	Example
Lens page URL	https://www.snapchat.com/lens/565e7595ec4e4a0da689762b127308ef
Unlock URL	https://www.snapchat.com/unlock/?type=SNAPCODE&uuid=565e7595ec4e4a0da689762b127308ef
Bare UUID	565e7595ec4e4a0da689762b127308ef

Output Fields

Core Lens Fields (all modes)

Field	Type	Description
scannableUuid	string	Unique lens UUID (32-char hex, used in all Snapchat lens URLs)
lensName	string	Display name of the lens
lensId	string	Internal numeric lens ID
lensCreatorDisplayName	string	Creator's display name
lensCreatorUsername	string	Creator's Snapchat username
lensPreviewImageUrl	string	Static preview image showing the lens effect
lensPreviewVideoUrl	string	Animated preview video showing the lens effect
iconUrl	string	Small icon thumbnail used in lens carousels
unlockUrl	string	URL to unlock or open the lens in the Snapchat app
userProfileUrl	string	Creator's Snapchat profile URL
lensCreatorSearchTags	string[]	Tags used for lens discoverability in search
isOfficialSnapLens	boolean	Whether this is an official Snapchat-branded lens
lastUpdatedAt	string	ISO 8601 UTC last updated timestamp
lensUrl	string	Full snapchat.com/lens/{uuid} page URL
source	string	Origin mode: home, detail, or search
scrapedAt	string	ISO 8601 UTC scrape timestamp

Detail Mode Additional Fields

When mode: "detail" with includeMoreLenses: true:

Field	Type	Description
moreLenses	object[]	Related lenses shown on the detail page — each has the same core fields as above

When mode: "detail" with includeSpotlightsUsingLens: true:

Each item in spotlightsUsingThisLens[]:

Field	Type	Description
thumbnailUrl	string	Thumbnail URL of the Spotlight video
storyPageUrl	string	Full Spotlight page URL
contentUrl	string	Direct CDN video URL
name	string	Video name/title (when available)
uploadedAt	string	ISO 8601 upload timestamp
durationMs	number	Video duration in milliseconds
width	integer	Video width in pixels
height	integer	Video height in pixels
keywords	string[]	Keywords associated with the video
embeddedTextCaption	string	Embedded text caption in the video

Search Mode Additional Field

Field	Type	Description
searchKeyword	string	The keyword that returned this lens

Home Mode Additional Fields

Home mode records do not include moreLenses or spotlightsUsingThisLens. The top-level page may also indicate:

Field	Type	Description
hasMore	boolean	Whether more lenses are available beyond the 25 returned
nextCursorId	string	Cursor for additional pages (informational)

Example Input

Detail mode:

{
  "mode": "detail",
  "lensUrlsOrIds": [
    "565e7595ec4e4a0da689762b127308ef",
    "https://www.snapchat.com/lens/dc98faf460f54b7fb6e119d4d7b7c0c3"
  ],
  "includeMoreLenses": true,
  "includeSpotlightsUsingLens": true
}

Search mode:

{
  "mode": "search",
  "keywords": ["food", "pakistan filter"],
  "includeMoreLenses": false,
  "includeSpotlightsUsingLens": false
}

Home mode:

{
  "mode": "home"
}

Example Output

Search mode record:

{
  "lensId": "560888470664674",
  "lensName": "Pakistan",
  "scannableUuid": "dc98faf460f54b7fb6e119d4d7b7c0c3",
  "lensUrl": "https://www.snapchat.com/lens/dc98faf460f54b7fb6e119d4d7b7c0c3",
  "iconUrl": "https://lens-storage.storage.googleapis.com/png/4906822b5d7f4de5bde9eaa0b12fdf08",
  "unlockUrl": "https://www.snapchat.com/unlock/?type=SNAPCODE&uuid=dc98faf460f54b7fb6e119d4d7b7c0c3&metadata=01",
  "creatorName": "Shuͥᴍaͣiͫl",
  "creatorIsOfficial": false,
  "thumbnailUrl": "https://community-lens.storage.googleapis.com/preview-media/thumbnail_poster/1ad5922f-e533-48e3-886e-ab23bb53b434.jpg",
  "thumbnailSequence": {
    "urlPattern": "https://community-lens.storage.googleapis.com/preview-media/thumbnail_seq/1ad5922f-e533-48e3-886e-ab23bb53b434/image_%d.jpg",
    "numThumbnails": 12,
    "animationIntervalMs": 300
  },
  "searchKeyword": "pakistan filter",
  "source": "search",
  "scrapedAt": "2026-06-28T06:47:22.491443+00:00"
}

Detail mode record (with spotlights):

{
  "scannableUuid": "565e7595ec4e4a0da689762b127308ef",
  "lensName": "Cartoon 3D Style",
  "lensCreatorDisplayName": "Snapchat",
  "lensCreatorUsername": "snapchat",
  "lensPreviewImageUrl": "https://lens.snapchat.com/...",
  "lensPreviewVideoUrl": "https://lens.snapchat.com/...",
  "iconUrl": "https://lens-storage.storage.googleapis.com/...",
  "unlockUrl": "https://www.snapchat.com/unlock/?type=SNAPCODE&uuid=565e7595ec4e4a0da689762b127308ef",
  "isOfficialSnapLens": true,
  "lastUpdatedAt": "2025-10-01T00:00:00+00:00",
  "lensUrl": "https://www.snapchat.com/lens/565e7595ec4e4a0da689762b127308ef",
  "source": "detail",
  "scrapedAt": "2026-06-28T06:47:00.000000+00:00",
  "moreLenses": [
    {
      "scannableUuid": "f349702a2c764dbdbeac605aa978a3ef",
      "lensName": "Anime Style",
      "lensCreatorDisplayName": "Snapchat",
      "isOfficialSnapLens": true,
      "lensUrl": "https://www.snapchat.com/lens/f349702a2c764dbdbeac605aa978a3ef",
      "source": "",
      "scrapedAt": "2026-06-28T06:47:00.000000+00:00"
    }
  ],
  "spotlightsUsingThisLens": [
    {
      "thumbnailUrl": "https://cf-st.sc-cdn.net/...",
      "storyPageUrl": "https://www.snapchat.com/spotlight/W7_EDl...",
      "contentUrl": "https://cf-st.sc-cdn.net/...",
      "uploadedAt": "2026-06-15T10:00:00+00:00",
      "durationMs": 8230.0,
      "width": 540,
      "height": 960
    }
  ]
}

FAQ

What is a Snapchat lens UUID? The UUID is the unique hex identifier for each AR lens — the 32-character string in lens page URLs (snapchat.com/lens/{uuid}) and unlock URLs (?uuid={uuid}). It is also called the "scannable UUID" because it encodes the Snapcode that unlocks the lens.

What is the difference between lensPreviewImageUrl and iconUrl? lensPreviewImageUrl is a full-size static frame showing the lens effect as applied to a face or scene. iconUrl is the small square thumbnail displayed in lens carousels and search results.

How many results does home mode return? Exactly the top 25 trending lenses featured on snapchat.com/lens at the time of scraping. This set changes daily.

How many related lenses does detail mode return? The Snapchat detail page shows up to 12 related lenses, but the first item is always the lens itself — the actor filters it out, so you get up to 11 related lenses.

Can I get lenses by a specific creator? Use search mode with the creator's username or display name as a keyword. Lenses whose name or tags match the keyword will be returned.

Do I need a proxy? No proxy is required for normal usage. Snapchat's lens pages are public. For high-volume runs or if you encounter rate limiting, enable proxy via proxyConfiguration.

What does thumbnailSequence contain? An animated thumbnail preview sequence: urlPattern is a URL template with %d as the frame index, numThumbnails is the total frame count, and animationIntervalMs is the delay between frames. Use these to reconstruct an animated GIF-like preview.

---

Other Snapchat Scrapers

Explore the full Snapchat scraper suite on Apify:

Actor	Description
Snapchat Profile Scraper	Full profile metadata, highlights, lenses, and spotlight data
Snapchat Hashtag Scraper	Spotlight videos by hashtag or topic with AI metadata
Snapchat User Stories Scraper	Curated highlights and active story snaps
Snapchat Spotlight Video Downloader	Download Spotlight videos with AI metadata, transcripts, and comments
Snapchat Search Scraper	Search across videos, lenses, users, places, and shows
Snapchat Lens Scraper	AR lens metadata, trending lenses, and creator info
Snapchat Publisher Scraper	Discover publisher pages, shows, episodes, and spotlights
Snapchat Ads Gallery Scraper	EU/UK ad transparency library — ads and sponsored content
Snapchat Spotlight Comments Scraper	Comment threads from Spotlight videos
Snapchat Topic Scraper	Spotlight videos by topic with related tags
Snapchat Snapcode Scraper	Download Snapcode images (SVG/PNG) for any username
Snapchat Snap Map Scraper	Public Snap Map places and their latest snaps
Snapchat Discover Scraper	Shows and stories from Snapchat's Discover feed