> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a Snapchat Spotlight video > Fetches a public Snapchat Spotlight video by URL: the video (title, description, MP4 URL, thumbnail, engagement counts, duration, dimensions), the creator/user, the audio/music + lens attribution, the transcript, and the AI-generated SEO metadata. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/snapchat/spotlight openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: Google description: Google Search scraping endpoints paths: /v1/snapchat/spotlight: get: tags: - Snapchat summary: Get a Snapchat Spotlight video description: >- Fetches a public Snapchat Spotlight video by URL: the video (title, description, MP4 URL, thumbnail, engagement counts, duration, dimensions), the creator/user, the audio/music + lens attribution, the transcript, and the AI-generated SEO metadata. parameters: - name: url in: query required: true description: >- Snapchat Spotlight URL, e.g. https://www.snapchat.com/spotlight/ (the https://www.snapchat.com/@/spotlight/ form is also accepted). schema: type: string example: >- https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYcWJ1dGZxYm1kAZ-6WEWcAZ-6WA2bAAAAAw - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The Spotlight video. content: application/json: schema: type: object properties: data: type: object properties: spotlight: type: object fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: spotlight: id: >- W7_EDlXWTBiXAEEniNoMPwAAYcWJ1dGZxYm1kAZ-6WEWcAZ-6WA2bAAAAAw url: >- https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYcWJ1dGZxYm1kAZ-6WEWcAZ-6WA2bAAAAAw title: Spotlight Snap description: Another Spotlight Snap brought to you by Snapchat embeddedTextCaption: null videoUrl: >- https://cf-st.sc-cdn.net/d/cMqz9zr0wKrGpVbV6C1WK.27.IRZXSOY?mo=Gl0aCTIBBEgCUC5gAVCiAVoQU3BvdGxpZ2h0U2hhcmluZ6IBNggbEiUKIwjK82UgATCcBDjAB0ABSg4KCXc1QUU3NEg_QRD0A1D-YmgCIgsSACoHSVJaWFNPWZAD_mI%3D&uc=46 thumbnailUrl: >- https://cf-st.sc-cdn.net/d/cMqz9zr0wKrGpVbV6C1WK.256.IRZXSOY?mo=GkYaCTIBBEgCUC5gAVCgAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46 viewCount: 139745 shareCount: 180 boostCount: 12680 recommendCount: 483 durationMs: 12670 width: 540 height: 960 uploadedAt: '2026-07-31T22:42:40.667Z' keywords: [] hashtags: [] language: en creator: type: personCreator username: angellynn21 name: Angel vinup url: https://www.snapchat.com/@angellynn21 followerCount: 0 websiteUrl: null user: null audio: title: Original Sound subtitle: angellynn21 id: '93783123568' thumbnailUrl: >- https://cf-st.sc-cdn.net/d/6YKRUxipwtyh6YMgtaJbK?bo=Eg0aABoAMgEESAJQCGAB&uc=8 lenses: [] contextCards: - type: 2 title: Original Sound subtitle: angellynn21 url: null thumbnailUrl: >- https://cf-st.sc-cdn.net/d/6YKRUxipwtyh6YMgtaJbK?bo=Eg0aABoAMgEESAJQCGAB&uc=8 id: '93783123568' - type: 3 title: Angel vinup subtitle: angellynn21 url: https://www.snapchat.com/@angellynn21 thumbnailUrl: >- https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvVTM0WmJyR0ZPSW41b1hGaHlQekpVP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,640_FMjpeg id: ee7ff958-6b52-49de-a187-6991d0683695 transcript: null llm: title: Father and Son Enjoying a Boat Ride Together description: >- A shirtless man with a tattoo on his back sits on a boat, holding the steering wheel while a young boy sits beside him, wearing a life jacket. They are on a lake surrounded by trees under a cloudy sky. The man points forward, seemingly giving directions or showing something to the boy. The boat has a gray interior with white seats, and they are both barefoot. The atmosphere is relaxed and leisurely, capturing a moment of bonding between the father and son during their boating trip. keywords: - boat safety tips previewImageUrl: >- https://story.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYcWJ1dGZxYm1kAZ-6WEWcAZ-6WA2bAAAAAw/preview/square.jpeg isAttributed: true restricted: false fetchedAt: '2026-09-14T12:14:55.187Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: Spotlight video not found / unavailable. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (missing or malformed url). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '502': description: Upstream block. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source was temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ````