docs / snapchat

Snapchat Public Data API scraper

base /snapchat/v18 endpoints

post/snapchat/v1/profile1 credit

Full public Snapchat profile by username: display name, snapcode, subscriber count, bio, website, verified badge, profile picture, business id, related/suggested accounts, plus flags for whether the account has a live story and saved highlights.

Parameter		Allowed / range	Description
username	required	—	Snapchat public username — the name in snapchat.com/add/<username> (with or without a leading @). Public creator/brand accounts only.

Try in playground →

post/snapchat/v1/story1 credit

The account's current public story — the live snaps (image/video media URLs, timestamps, titles) that the profile is publicly broadcasting right now.

Parameter		Allowed / range	Description
username	required	—	Snapchat public username — the name in snapchat.com/add/<username> (with or without a leading @). Public creator/brand accounts only.
limit	optional	1–100	Max items to return (1-100). The page is sliced; omit for all.

Try in playground →

post/snapchat/v1/highlights1 credit

The account's saved public highlight stories (curated highlights + Spotlight highlights), each with its snaps. First page.

Parameter		Allowed / range	Description
username	required	—	Snapchat public username — the name in snapchat.com/add/<username> (with or without a leading @). Public creator/brand accounts only.
limit	optional	1–100	Max items to return (1-100). The page is sliced; omit for all.

Try in playground →

post/snapchat/v1/lenses1 credit

The creator's own public AR lenses listed on their profile: name, preview image/video, icon, unlock URL and scannable UUID.

Parameter		Allowed / range	Description
username	required	—	Snapchat public username — the name in snapchat.com/add/<username> (with or without a leading @). Public creator/brand accounts only.
limit	optional	1–100	Max items to return (1-100). The page is sliced; omit for all.

Try in playground →

post/snapchat/v1/spotlight1 credit

The public trending Spotlight feed — ~25 popular Spotlight videos with engagement stats (views, shares, comments, boosts), creator, AI-generated title/description/keywords and media URLs. No input needed; returns what Snapchat is surfacing now.

Parameter		Allowed / range	Description
limit	optional	1–100	Max items to return (1-100). The page is sliced; omit for all.

Try in playground →

post/snapchat/v1/spotlight_detail1 credit

Full metadata for one public Spotlight video by its story id (from a spotlight result's story_id or a snapchat.com/spotlight/<id> URL): name, description, view count, duration, dimensions, creator and media URL.

Parameter		Allowed / range	Description
story_id	required	—	Spotlight story id (the code in snapchat.com/spotlight/<id>). A full Spotlight URL is also accepted.

Try in playground →

post/snapchat/v1/lens_directory1 credit

Snapchat's public top/trending AR lens directory: the featured lenses plus the lens category list. First page.

Parameter		Allowed / range	Description
limit	optional	1–100	Max items to return (1-100). The page is sliced; omit for all.

Try in playground →

post/snapchat/v1/lens_detail1 credit

Detail for one public AR lens by its scannable UUID (from a lens result's scannable_uuid or a snapchat.com/lens/<uuid> URL): name, creator, preview media, unlock URL, the Spotlight videos that use this lens, and related lenses.

Parameter		Allowed / range	Description
uuid	required	—	Lens scannable UUID (the code in snapchat.com/lens/<uuid>). A full lens URL is also accepted.

Try in playground →

Example request · profile

curl -X POST https://api.reefapi.com/snapchat/v1/profile \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"username":"kyliejenner"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}