Snapchat Content API - Profiles, Stories, Spotlight & Lenses — Try the interactive demo

Look up a public Snapchat profile by username and get its public identity card. Pass the handle without @ (e.g. brentrivera). The response is {success, data:{info, metadata}}: info carries username, title (display name), bio, subscriberCount (returned as a string), profilePictureUrl, snapcodeImageUrl, squareHeroImageUrl, hostUserId, businessProfileId, badge, websiteUrl, categoryStringId / subcategoryStringId, relatedAccountsInfo, and the boolean flags hasStory, hasCuratedHighlights and hasSpotlightHighlights that tell you which follow-up calls are worth making; metadata carries pageTitle, pageDescription, pageType and shareId. A username that does not resolve returns HTTP 200 with success=false and data="data not found".

Fetch everything public about a Snapchat account in a single request. Pass a username (e.g. therock). The response is {success, data:{profile, story, curatedHighlights, spotlightHighlights, lenses}}: profile contains the same info/metadata block as Get Public Profile (username, title, bio, subscriberCount, profilePictureUrl, snapcodeImageUrl, creationTimestampMs, lastUpdateTimestampMs, relatedAccountsInfo, flags), story is the active public Story object or null, and the three arrays list curated Highlight albums, Spotlight highlights and Lenses published by the account (empty arrays when the account has none). A username that does not resolve returns HTTP 200 with success=false and data="data not found".

Return the public 24-hour Story that a Snapchat account currently has live. Pass a username (e.g. snoopdogg). When a Story is live, data holds the story object with its snaps and media URLs; when the account has no active Story the call still succeeds with {success:true, data:null}. Because Stories expire after 24 hours, results change throughout the day — check hasStory from Get Public Profile first if you want to avoid empty polls. A username that does not resolve returns HTTP 200 with success=false and data="data not found".

List the curated Highlight albums a Snapchat creator has pinned to their public profile — the evergreen Story collections that do not expire after 24 hours. Pass a username (e.g. benazelart). Returns {success, data} with the creator's highlight albums and their snaps; accounts without highlights return an empty result. Check hasCuratedHighlights from Get Public Profile to know in advance whether an account has any. A username that does not resolve returns HTTP 200 with success=false and data="data not found".

List the Spotlight videos a Snapchat creator showcases on their public profile. Pass a username (e.g. benazelart). Returns {success, data} with the creator's Spotlight highlight entries, which you can resolve further with Get Spotlight by Link. Accounts with no Spotlight highlights return an empty result; hasSpotlightHighlights on the profile tells you in advance. A username that does not resolve returns HTTP 200 with success=false and data="data not found".

List the public AR Lenses published by a Snapchat creator. Pass the creator's username (e.g. jsprinz). Returns {success, data} with the Lenses attributed to that account; each lens can be expanded with Get Lens Details by its lensId. Accounts that have not published Lenses return an empty result. A username that does not resolve returns HTTP 200 with success=false and data="data not found".

Resolve a Snapchat Spotlight share URL into full video metadata, engagement stats and media. Pass the complete spotlight_link (https://www.snapchat.com/spotlight/...). The response data contains metadata.engagementStats (viewCount, shareCount, commentCount, boostCount, recommendCount — returned as strings), metadata.videoMetadata (contentUrl video file, thumbnailUrl, durationMs, uploadDateMs, creator, name, description), AI-generated llmTitle / llmDescription / llmKeywords, hashtags, contextCards (creator and original sound), a deeplink, plus a story block with snapList (per-snap media URLs), storyId, storyType and thumbnailUrl, and upNextThumbnailUrl.

Pull the public comment thread under a Snapchat Spotlight video. Pass the complete spotlight_link (https://www.snapchat.com/spotlight/...). Returns {success, data} with the comments visible on the public Spotlight page — comment text and commenter details — ready for sentiment or moderation pipelines. Use Get Spotlight by Link on the same URL for the total commentCount.

Fetch the current public, unpersonalized Snapchat Spotlight discovery feed. No parameters are required. Returns {success, data} with the Spotlight videos currently surfaced on the public feed; individual entries can be expanded with Get Spotlight by Link. The feed rotates over time, so repeated calls are a good way to sample what is trending.

Resolve a public Snapchat Story share link into its snaps and media. Pass the full story_link in the form https://story.snapchat.com/p/{profileId}/{storyId}. Returns {success, data} with the Story object and its snap media URLs. Use this when you have a specific shared Story rather than a username; for whatever a user has live right now, use Get a User's Active Public Story.

Run a Snapchat public search for a keyword and get results grouped by surface. Pass keyword (e.g. music). The response is {success, data:{sections:[{title, results[]}]}} with sections such as Spotlight (story cards), Lenses, Topics, Subscribe (public creator profiles), Places, Shows and Episodes — each result carries a typed payload (result.$case) and an ID. Responses can be large (around 100 KB for broad keywords).

Search Snapchat's public AR Lens inventory by keyword. Pass keyword (e.g. funny). Returns {success, data} with matching Lenses, each including identifiers such as lensId plus name, creator and preview/icon imagery, resolvable to full detail with Get Lens Details.

Get the AR Lenses currently trending on Snapchat. No parameters are required. The response is {success, data:{topLenses:[...]}} with about 24 entries; each lens object includes lensId, name, creatorName, creatorUserId, creatorProfileId, creatorIsOffical (whether it is an official Snapchat Lens), iconUrl, thumbnailUrl, thumbnailSequence and a deeplinkUrl that opens the Lens.

Resolve a Snapchat Lens ID into full display details. Pass lens_id (a 32-character hex ID such as 41a72e9ae9a44f8891327ce6cf1c344d). The response data contains lensDisplayInfo (lensId, lensName, iconUrl, lensPreviewImageUrl, lensPreviewVideoUrl, lensCreatorDisplayName, lensCreatorUsername, lensCreatorSearchTags, isOfficialSnapLens, scannableUuid, scannableImageUrl, unlockUrl, userProfileUrl, lastUpdatedEpoch), lensMetadata (may be null), and moreLenses — about a dozen related Lenses.

List public Snapchat Lenses tagged with a hashtag. Pass hashtag without the # (e.g. music, halloween). Returns {success, data} with the Lenses filed under that tag, each with a lensId you can expand via Get Lens Details.

Browse Snapchat's public catalog of face Lenses — effects that track and transform the user's face (beauty, makeup, masks, distortions). Call without parameters for the first page; pass the cursor value from a previous response to fetch the next page. Returns {success, data} with face Lens entries (lensId, name, creator, imagery) and a cursor for pagination.

Browse Snapchat's public catalog of world Lenses — effects that place AR objects into the environment through the rear camera rather than on a face. Call without parameters for the first page; pass the cursor from a previous response to continue. Returns {success, data} with world Lens entries and a pagination cursor.

Browse Snapchat's public catalog of music Lenses — AR effects built around a song or audio track. Call without parameters for the first page; pass the cursor from a previous response for the next page. Returns {success, data} with music Lens entries and a pagination cursor.

Browse a public directory of Snapchat Lens creators — the developers and studios behind AR Lenses. Call without parameters for the first page; pass the cursor from a previous response for more. Returns {success, data} with creator entries and a pagination cursor; pass a creator's username to Get Lenses Published by a User to list their work.