Snapchat Lens Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

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

Supported Lens Input Formats (detail mode)

Output Fields

Core Lens Fields (all modes)

Detail Mode Additional Fields

When mode: "detail" with includeMoreLenses: true:

When mode: "detail" with includeSpotlightsUsingLens: true:

Each item in spotlightsUsingThisLens[]:

Search Mode Additional Field

Home Mode Additional Fields

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

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: