Snapchat Spotlight API
Resolve a Snapchat Spotlight URL to the caption, video and thumbnail URLs, duration, author, sound, hashtags, and engagement metrics.
GET /v1/snapchat/spotlights1 credit per successful request.
About this endpoint
GET /v1/snapchat/spotlights takes a required url query param: a public Spotlight link in the snapchat.com/spotlight/{id} or snapchat.com/@handle/spotlight/{id} form. Send x-api-key and branch on data.lookupStatus before writing rows. On found, data.spotlight has the caption, videoUrl, thumbnailUrl, durationSeconds, dimensions, createdAt, author, sound, hashtags, generated title, description, and keywords, and metrics for views, shares, comments, boosts, and recommends.
A profile URL returns 400 and points you at the profile endpoint. Credit pricing appears on this page; meta.creditsCharged is the billing source of truth. Comments on the same video are GET /v1/snapchat/spotlights/comments.
Snapchat Spotlight API FAQ
How do I look up a Snapchat Spotlight by URL?
Call GET /v1/snapchat/spotlights with your Social Fetch API key (x-api-key) and a public Spotlight URL in the url query param. Read data.lookupStatus before writing rows. See the API docs for parameters.
How much does the Snapchat Spotlight API cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
What URLs does this route accept?
A public Spotlight URL: snapchat.com/spotlight/{id} or snapchat.com/@handle/spotlight/{id}. Profile URLs belong on GET /v1/snapchat/profiles/{handle} — passing one here returns 400.
Where do I find Spotlight URLs?
Look up a creator with GET /v1/snapchat/profiles/{handle} and read data.spotlights[].url. You can also copy a link from the Snapchat share sheet.
Does a completed lookup always mean the Spotlight was found?
No. HTTP 200 means the request finished. Check data.lookupStatus: found means you got Spotlight details; not_found means the URL did not resolve to a Spotlight. Persist meta.requestId when you need to debug a miss.
Can I download the video file?
The response includes videoUrl, the media URL Snapchat serves for the Spotlight. Check the URL and Snapchat terms before storing or republishing the media.