Snapchat Public Data API
The Snapchat API returns public Snapchat data as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary profile endpoint returns a username's display name, bio, subscriber count, website, profile picture and snapcode, and you can pull a story, highlights, lenses, spotlight, a spotlight detail and the lens directory. It is built for creator analytics and brand monitoring that need public Snapchat data without a login. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, profile, on .
{
"method": "POST",
"url": "https://api.reefapi.com/snapchat/v1/profile",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"username": "kyliejenner"
}
}{
"ok": true,
"meta": {
"api": "snapchat",
"endpoint": "profile",
"mode": "live",
"latency_ms": 1329.8,
"record_count": 1,
"bytes": 2120708,
"cache_hit": false,
"method": "ssr_next_data"
},
"data": {
"profile": {
"username": "kyliejenner",
"display_name": "King Kylie 👑",
"subscriber_count": 30702000,
"website_url": "kyliecosmetics.com",
"profile_pic": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvaEJwN3Z0ZFl5NFVOeFpnWk04dXBYP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,90_FMjpeg",
"hero_image": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvakRGcnNVaW1ta2ZsamFPa1ZUTWVwP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,1080_FMjpeg",
"snapcode_url": "https://app.snapchat.com/web/deeplink/snapcode?username=kyliejenner&type=SVG&bitmoji=enable",
"is_verified": true,
"badge": 1,
"business_profile_id": "e9bcdb52-a5cc-4dea-88ac-8baa91a78345",
"host_user_id": "7f445ef2-e1d3-4ef2-a235-a5aec8159168",
"has_story": false,
"has_curated_highlights": true,
"has_spotlight_highlights": true,
"created_at_ms": 1558548110393,
"updated_at_ms": 1784135840000,
"profile_url": "https://www.snapchat.com/add/kyliejenner",
"related_accounts": [
{
"username": "kimkardashian",
"display_name": "Kim Kardashian",
"subscriber_count": 0,
"profile_pic": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvUjlZUUE2a0xHQlV0SHMxSjZhYmZhP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg",
"is_verified": true
},
{
"username": "kendalljenner",
"display_name": "Kendall Jenner",
"subscriber_count": 0,
"profile_pic": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvWW1tSUZkY2JlZTNrZVl5bVlQbEpxP2JvPUVnMGFBQm9BTWdFRVNBSlFDR0FCJnVjPTg._RS0,640_FMpng",
"is_verified": true
},
{
"username": "kourtneykardash",
"display_name": "Kourtney Kardashian",
"subscriber_count": 0,
"profile_pic": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvTlprQndFQk44VnJraXRwQkZ3cXdLP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMpng",
"is_verified": true
}
]
}
}
}What the Snapchat Public Data API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| profile | 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. | Ops teams call profile to get full public Snapchat profile by username. | username |
| story | The account's current public story — the live snaps (image/video media URLs, timestamps, titles) that the profile is publicly broadcasting right now. | Developer tools call story to get the account's current public story. | username |
| highlights | The account's saved public highlight stories (curated highlights + Spotlight highlights), each with its snaps. First page. | Validation workflows call highlights to get the account's saved public highlight stories (curated highlights + Spotlight highlights), eac…. | username |
| lenses | The creator's own public AR lenses listed on their profile: name, preview image/video, icon, unlock URL and scannable UUID. | Data-quality teams call lenses to get the creator's own public AR lenses listed on their profile. | username |
| spotlight | 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. | Ops teams call spotlight to get the public trending Spotlight feed. | none |
| spotlight_detail | 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. | Developer tools call spotlight_detail to get full metadata for one public Spotlight video by its story id (from a spotlight result's story…. | story_id |
| lens_directory | Snapchat's public top/trending AR lens directory: the featured lenses plus the lens category list. First page. | Validation workflows call lens_directory to get snapchat's public top/trending AR lens directory. | none |
| lens_detail | 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. | Data-quality teams call lens_detail to get detail for one public AR lens by its scannable UUID (from a lens result's scannable_uuid or a…. | uuid |
Call profile from your stack
curl -X POST https://api.reefapi.com/snapchat/v1/profile \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"username":"kyliejenner"}'import requests
r = requests.post(
"https://api.reefapi.com/snapchat/v1/profile",
headers={"x-api-key": REEF_KEY},
json={
"username": "kyliejenner"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/snapchat/v1/profile", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"username": "kyliejenner"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.snapchat.profile with {"username":"kyliejenner"}.Who uses this API and why
- Creator analytics call profile to pull a public account's subscriber count.
- Brand monitoring uses story and spotlight to track content.
- AR tools use lenses and the lens directory to study creative trends.
Questions developers ask before integrating
What is the Snapchat Public Data API?
Snapchat Public Data API is a ReefAPI endpoint group for snapchat public data It returns live JSON through POST requests under /snapchat/v1.
Is the Snapchat Public Data API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Snapchat Public Data calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Snapchat Public Data login or account?
No login to Snapchat Public Data is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Snapchat Public Data data?
The page example is captured from a live profile call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Snapchat Public Data API use?
Snapchat Public Data actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Snapchat Public Data from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call snapchat actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Snapchat Public Data API a Snapchat Public Data scraper?
It is the managed alternative to a DIY Snapchat Public Data scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same snapchat public data back as clean JSON.
Why does my Snapchat Public Data scraper keep getting blocked?
Most Snapchat Public Data scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.