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 Failed requests are free
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.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
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.