SocialCrawl

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
curl "https://www.socialcrawl.dev/v1/snapchat/profile?handle=djkhaled305" \
  -H "x-api-key: sc_your_key_here"
TypeScript
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);
Python
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
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 wantCall
An account's name, subscriber count and bioGET /v1/snapchat/profile
The comments on a Spotlight snapGET /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

EndpointCreditsWhat it returnsKey parameters
GET /v1/snapchat/profile1Display name, Bitmoji avatar URL, subscriber count, and biohandle
GET /v1/snapchat/spotlight/comments1The comment thread on one Spotlight snapurl, 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.

EndpointPathCredit Tier
Get Snapchat user profile/v1/snapchat/profilestandard (1cr)
List comments on a Snapchat Spotlight/v1/snapchat/spotlight/commentsstandard (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

PathRows per pageDate windowOne call collects
/v1/snapchat/spotlight/commentsabout 25since and until, applied to each page fetchedup 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.

PathTypical (median)95% finish withinTimeout to set
/v1/snapchat/profile4.6 s15 s28 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.

Next steps