UnifAPI Docs

Get a Snapchat Spotlight video by URL

Returns one Snapchat Spotlight video by URL: creator, caption, view, share and comment counts and video URLs. Returns `not_found` when it does not exist.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/snapchat/spotlights

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

url*string

Link to the Snapchat Spotlight video.

Length1 <= length <= 4096

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/snapchat/spotlights?url=string"
{  "request_id": "string",  "data": {    "id": "string",    "url": "string",    "caption": "string",    "generated_title": "string",    "generated_description": "string",    "keywords": [      "string"    ],    "hashtags": [      "string"    ],    "sound": {      "title": "string",      "creator_handle": "string"    },    "thumbnail_url": "string",    "video_url": "string",    "duration": 0,    "width": 0,    "height": 0,    "created_at": 0,    "author": {      "username": "string",      "display_name": "string",      "profile_url": "string",      "avatar_url": "string"    },    "view_count": 0,    "share_count": 0,    "comment_count": 0,    "boost_count": 0,    "recommend_count": 0  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}