Snapchat

Get Snapchat Spotlight

Get a Snapchat Spotlight video by URL.

GET/v1/snapchat/spotlights
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
urlstringrequiredquery

Link to the Snapchat Spotlight video.

min 1 chars · max 4096 chars

Response fields
37

Endpoint-specific response payload.

datalookupStatus
string

Whether the Spotlight was found.

one of: found, not_found

Spotlight details when found.

dataspotlightid
string

Spotlight snap identifier.

min 1 chars

dataspotlighturl
string

Canonical public Snapchat Spotlight URL.

min 1 chars

dataspotlightcaption
stringnullable

Caption written by the creator.

dataspotlightgeneratedTitle
stringnullable

Auto-generated title when available.

dataspotlightgeneratedDescription
stringnullable

Auto-generated description when available.

Auto-generated keywords (may be empty).

dataspotlightkeywords[]
stringoptional

Hashtags on the video (may be empty).

dataspotlighthashtags[]
stringoptional

Sound used in the video when available.

dataspotlightsoundtitle
string

Sound title.

dataspotlightsoundcreatorHandle
stringnullable

Snapchat username of the sound's creator when available.

dataspotlightthumbnailUrl
stringnullable

Thumbnail image URL when available.

dataspotlightvideoUrl
stringnullable

Video file URL when available.

dataspotlightdurationSeconds
numbernullable

Video duration in seconds when available.

≥ 0

dataspotlightwidth
integernullable

Video width in pixels when available.

≥ 0

dataspotlightheight
integernullable

Video height in pixels when available.

≥ 0

dataspotlightcreatedAt
stringnullable

ISO-8601 timestamp when the video was posted.

Creator of the video when available.

dataspotlightauthorhandle
stringnullable

Snapchat username without the leading @.

dataspotlightauthordisplayName
stringnullable

Public display name when available.

dataspotlightauthorprofileUrl
stringnullable

Public Snapchat profile URL when available.

dataspotlightauthoravatarUrl
stringnullable

Profile image URL when available.

Engagement metrics for the video.

dataspotlightmetricsviews
integernullable

View count when available.

≥ 0

dataspotlightmetricsshares
integernullable

Share count when available.

≥ 0

dataspotlightmetricscomments
integernullable

Comment count when available.

≥ 0

dataspotlightmetricsboosts
integernullable

Boost count when available.

≥ 0

dataspotlightmetricsrecommends
integernullable

Recommend count when available.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/snapchat/spotlights?url=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYdWhydHdsZWhwAaB_Ig5YAaB_FRlfAAAAAQ" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Snapchat Spotlight lookup result.