Snapchat Public Lens Explorer Scraper

Discover normalized public Snapchat Lens metadata from Lens Explorer, explicit public lens/unlock URLs, or 32-character lens UUIDs. Optional detail-page enrichment adds related lenses, Spotlight usage, page metadata, and public creator/preview fields.

What it returns

Each dataset row is one complete public lens and can include:

• Lens UUID, source ID, name, canonical lens URL, official-lens flag, and last-update value
• Creator display name, username, public profile URL, and search tags
• Preview image/video, icon, unlock URL, and normalized search tags
• Lens category/public flag, normalized related lenses, and normalized Spotlight usage entries/count
• Detail page title, description, visible text, JSON-LD, source pages/types, fetch status, proxy use, and timestamp

Raw Lens Explorer, detail-page, and lens-resource payloads are not exposed. Missing fields are omitted, and incomplete lenses without stable identity, creator, preview, icon, unlock, and tag fields are excluded.

Input

{
  "startUrls": [{ "url": "https://www.snapchat.com/lens" }],
  "lensUrls": [],
  "uuids": [],
  "query": "",
  "maxItems": 5,
  "includeDetails": true,
  "requestDelayMs": 250,
  "timeoutMs": 45000,
  "maxResponseBytes": 4000000,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Inputs are restricted to public Snapchat /lens, /lens/<uuid>, and /unlock URLs. Runs are bounded to 20 discovery URLs, 100 explicit lens URLs, 100 UUIDs, and 100 records. The optional query is a local case-insensitive filter over discovered public lens data.

Access failures and page changes

Access challenges, HTTP failures, missing state, detail failures, and incomplete records are written to the OUTPUT key’s bounded failures array and counters, not to dataset rows. A failed optional detail request does not discard a complete Explorer record.

Requests use a transparent Actor user agent, no retries, bounded response sizes/timeouts, and Apify Proxy by default in Cloud runs. The Actor does not log in, solve CAPTCHAs, patch fingerprints, or bypass access controls.

Responsible use

Use public data only for lawful research, follow Snap terms and robots guidance, and respect creator privacy, trademarks, copyright, and lens/media rights. Returned URLs and metadata do not grant reuse or redistribution rights.

Local validation

Run npm test, apify validate-schema, and apify run --purge --input-file qa-inputs/snapchat-lens-scraper/local-validation.json. Inspect the default dataset and OUTPUT key.