v1.5 - Added proxyType (auto|residential|datacenter) for trending and urls modes with automatic residential->datacenter fallback, so these modes keep working when the residential proxy quota is exhausted. v1.4 - Added 'username' mode: returns a creator's public Spotlight videos by handle via the ScrapeCreators provider (no residential proxy needed), wired through the SCRAPECREATORS_API_KEY owner secret. Trending and URL modes are unchanged (owned HTTP scrape). v1.3 - Trending now uses adaptive loop-until-dry feed sampling (fetch until maxResults or 3 consecutive dry fetches, hard cap 30) plus opportunistic rerankCandidateStories harvest, so large trending jobs reach maxResults instead of capping near ~70, while small jobs stay cheap. v1.2 - Right-sized default memory to 512 MB (validated across the full cloud test matrix) to lower per-run compute and start-event cost. v1.1 - country is now free-text ISO-2 (any country, case-insensitive) instead of a fixed enum; URL mode no longer falls back to an unrelated trending video when the requested Spotlight ID is not found (returns a not-found diagnostic), preventing mis-billing. v1.0 - Initial HTTP-only Snapchat Spotlight Scraper: trending feed discovery by country plus Spotlight URL mode, embedded NEXT_DATA parsing, rich engagement metrics (views, shares, boosts, recommends, comments), creator, sound, AI caption, hashtags, transcript and video download URLs, residential proxy with session retirement, soft-fail input validation, honest-fail on block exhaustion, diagnostic rows, OUTPUT/RUN_SUMMARY telemetry, PPE pricing, and MCP-ready schemas.
