Snapchat data API
Read public accounts from Snapchat with one key and one response shape.
Read the public account card for a Snapchat handle, and the comment thread on a Spotlight snap you already hold a URL for. Both return the same response format as every other platform.
Snapchat publishes no public feed of posts or stories, so there is no
snapchat/post to crawl. The account card and Spotlight comments are the
whole surface.
Your first call
1. Fetch a profile
curl "https://www.socialcrawl.dev/v1/snapchat/profile?handle=djkhaled305" \
-H "x-api-key: sc_your_key_here"const url = new URL("https://www.socialcrawl.dev/v1/snapchat/profile");
url.searchParams.set("handle", "djkhaled305");
const res = await fetch(url, {
headers: { "x-api-key": process.env.SOCIALCRAWL_API_KEY! },
});
const { data } = await res.json();
console.log(data.author.display_name, data.author.followers);import os
import requests
res = requests.get(
"https://www.socialcrawl.dev/v1/snapchat/profile",
headers={"x-api-key": os.environ["SOCIALCRAWL_API_KEY"]},
params={"handle": "djkhaled305"},
)
author = res.json()["data"]["author"]
print(author["display_name"], author["followers"])The response is one author object with the display name, Bitmoji avatar, subscriber count, bio and a join date. Measured on 22/11/2026: this call took about 5 seconds and cost 1 credit.
2. Fetch their content
curl "https://www.socialcrawl.dev/v1/snapchat/spotlight/comments?url=https://www.snapchat.com/@lilah4823/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pvZnd0ZXVmAZ8fgG8pAZ8ff-_IAAAAAQ" \
-H "x-api-key: sc_your_key_here"3. Read computed fields
When an endpoint supports a computed field and the required source inputs are present, the unified response includes that optional field. Depending on the endpoint, optional fields can include engagement_rate, language, content_category, and estimated_reach. See Computed fields for formulas, clamping rules, and null semantics. Where an endpoint supports them, list rows also carry judged labels (computed.labels, computed.relevance) by default at no extra credits; see Labels.
What it covers
| What you want | Call |
|---|---|
| An account's name, subscriber count and bio | GET /v1/snapchat/profile |
| The comments on a Spotlight snap | GET /v1/snapchat/spotlight/comments |
What it does not cover
- Posts, stories and Spotlight snaps themselves. Snapchat publishes no public feed, and only the comments on a Spotlight snap are readable.
- A search across Spotlight. Pass the URL of a snap you already hold.
- An account's following count and post count, which come back null.
- Private accounts and anything behind a login.
Accounts and Spotlight
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/snapchat/profile | 1 | Display name, Bitmoji avatar URL, subscriber count, and bio | handle |
GET /v1/snapchat/spotlight/comments | 1 | The comment thread on one Spotlight snap | url, cursor |
profile is the identity lookup: confirm an account exists and read its subscriber count. That makes it a useful leg in handle vetting rather than a content source. If you are checking a name across several networks, POST /v1/prism/profiles takes up to 50 platform and handle pairs in one call. Snapchat is one of its supported platforms, which beats calling each platform's profile endpoint in a loop.
spotlight/comments is the content read. Pass a Spotlight URL and page with cursor. Each comment has its text, display name, reaction count, nested reply count and timestamp.
Questions people ask
Why does a Snapchat account show 0 followers?
followers carries the account's public subscriber count. Many news and media accounts hide that number on their profile, so we read it from Snapchat's public search and match it on the account's business profile id. When the number cannot be read, followers is null, not 0. The handle is the account's username, which can differ from the brand name (Le Figaro is lefigarofr), so check the handle if the card looks empty.
Can I search Snapchat Spotlight?
No. There is no Spotlight search or Spotlight detail endpoint. GET /v1/snapchat/spotlight/comments takes the URL of one snap and returns its comment thread, and you page it with cursor. To find snaps, collect their URLs somewhere else and pass each one in.
All endpoints
2 endpoints available.
| Endpoint | Path | Credit Tier |
|---|---|---|
| Get Snapchat user profile | /v1/snapchat/profile | standard (1cr) |
| List comments on a Snapchat Spotlight | /v1/snapchat/spotlight/comments | standard (1cr) |
How far back and how deep
Each list returns one page at a time. Send cursor for the next page, or max_items or max_pages to collect several pages in one call. A page size appears only where it has been verified. How paging works
| Path | Rows per page | Date window | One call collects |
|---|---|---|---|
/v1/snapchat/spotlight/comments | about 25 | since and until, applied to each page fetched | up to 5,000 rows or 50 pages |
How long a call takes
Measured on production calls that were not served from the cache, 14/10/2026 to 21/10/2026. A cached call answers faster. Set your client timeout to the value in Timeout to set, so a slow call is not cut off and sent again.
| Path | Typical (median) | 95% finish within | Timeout to set |
|---|---|---|---|
/v1/snapchat/profile | 4.6 s | 15 s | 28 s |
Platform notes
There is no Spotlight detail endpoint. The source returns an empty body for the snap itself, so only its comments are readable.
The handle is the Snapchat username, without an @.
A handle with no public account returns 404 and is refunded automatically.
