Spotlight

GET/v1/snapchat/spotlight1 credit

Returns a public Spotlight video: description, creator, view, share and comment counts, duration, dimensions, thumbnail and the video file URL, plus the page's link preview and video metadata.

01Query parameters

Name	Type	Description
urlrequired	string	The Spotlight URL, e.g. `https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXW...`.

02Request

curl "https://api.scrapesocial.ai/v1/snapchat/spotlight?url=https%3A%2F%2Fwww.snapchat.com%2F%40jack.scalise%2Fspotlight%2FW7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/snapchat/spotlight?url=https%3A%2F%2Fwww.snapchat.com%2F%40jack.scalise%2Fspotlight%2FW7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "spotlight": {
    "snapId": "W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ",
    "storyId": "W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ",
    "description": "You are my favorite notification!😄❤️",
    "llmTitle": "Jack Scalise's 'Disturb Me' Challenge: How to Get Noticed Online",
    "llmDescription": "This short-form content features Jack Scalise, a popular social media personality, inviting his audience to participate in a trending 'disturb me' challenge. The video opens with him speaking directly to the camera against scenic mountain backdrops, using text overlays like 'DISTURB ME UPDATE ME' and 'TELL ME HOW YOUR DAY WAS'. He then transitions to a park setting, smiling and holding a phone, wi…",
    "engagementStats": {
      "viewCount": 359951,
      "shareCount": 35059,
      "commentCount": 636,
      "boostCount": 35666,
      "recommendCount": 1825
    },
    "viewCount": 359951,
    "shareCount": 35059,
    "commentCount": 636,
    "boostCount": 35666,
    "recommendCount": 1825,
    "creator": {
      "$case": "personCreator",
      "personCreator": {
        "username": "jack.scalise",
        "url": "https://www.snapchat.com/@jack.scalise",
        "name": "Jack Scalise",
        "followerCount": "0",
        "websiteUrl": ""
      }
    },
    "durationMs": 11200,
    "width": 540,
    "height": 960,
    "uploadDateMs": 1742742025631,
    "thumbnailUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46",
    "contentUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46",
    "raw": {
      "story": {
        "storyType": 15,
        "snapList": [
          {
            "snapIndex": 0,
            "snapId": {
              "value": "W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ"
            },
            "snapMediaType": 1,
            "snapUrls": {
              "mediaUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46",
              "mediaPreviewUrl": {
                "value": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46"
              },
              "overlayUrl": null,
              "attachmentUrl": null
            },
            "isSponsored": null,
            "timestampInSec": {
              "value": "1742742025"
            },
            "snapTitle": null,
            "snapSubtitles": null,
            "lat": null,
            "lng": null,
            "hasAttachment": null,
            "intervalStartTimeMs": null,
            "audioTranscriptionObjectUrl": {
              "value": "https://bolt-gcdn.sc-cdn.net/3/qFbYrpUtxHtWW3OTCKXnH.vtt?bo=EgkyAX1IAlAuYAE%3D&uc=46"
            }
          }
        ],
        "storyId": {
          "value": "W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ"
        },
        "storyTitle": null,
        "thumbnailUrl": {
          "value": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46"
        },
        "storySubtitle": null,
        "storyShareId": null,
        "canonicalUrlSuffix": null,
        "emoji": null,
        "storyTapId": "0",
        "videoTrackUrl": null,
        "highlightId": null,
        "isAttributed": {
          "value": true
        },
        "thumbnailTiles": [
          {
            "tileType": 1,
            "url": {
              "value": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.1400.IRZXSOY?mo=GkYaCTIBBEgCUC5gAVClAloQRGZMYXJnZVRodW1ibmFpbKIBEAj4CiILEgAqB0lSWlhTT1miARAIlgsiCxIAKgdJUlpYU09Z&uc=46"
            },
            "tileId": null
          },
          {
            "tileType": 2,
            "url": {
              "value": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46"
            },
            "tileId": null
          }
        ]
      },
      "metadata": {
        "videoMetadata": {
          "name": "Spotlight Snap",
          "description": "Another Spotlight Snap brought to you by Snapchat",
          "thumbnailUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46",
          "uploadDateMs": "1742742025631",
          "viewCount": "359951",
          "contentUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46",
          "creator": {
            "$case": "personCreator",
            "personCreator": {
              "username": "jack.scalise",
              "url": "https://www.snapchat.com/@jack.scalise",
              "name": "Jack Scalise",
              "followerCount": "0",
              "websiteUrl": ""
            }
          },
          "durationMs": "11200",
          "width": 540,
          "height": 960,
          "keywords": [],
          "shareCount": "0",
          "embeddedTextCaption": ""
        },
        "userMetadata": null,
        "lensMetadata": null,
        "hashtags": [],
        "contextCards": [
          {
            "contextType": 2,
            "title": "Original Sound",
            "subtitle": "jack.scalise",
            "url": "",
            "thumbnailUrl": "https://cf-st.sc-cdn.net/d/6YKRUxipwtyh6YMgtaJbK?bo=Eg0aABoAMgEESAJQCGAB&uc=8",
            "snapcodeUrl": "",
            "thumbnailType": 2,
            "hasBadge": false,
            "id": "129883952169"
          },
          {
            "contextType": 3,
            "title": "Jack Scalise",
            "subtitle": "jack.scalise",
            "url": "https://www.snapchat.com/@jack.scalise",
            "thumbnailUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvWDcyaUthUWtVYW1QaTA3cEFVTEVGP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg",
            "snapcodeUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=jack.scalise&type=SVG&bitmoji=enable",
            "thumbnailType": 0,
            "hasBadge": true,
            "id": "a09b4aa7-8868-4066-8e56-0dc641042666"
          }
        ],
        "engagementStats": {
          "viewCount": 359951,
          "shareCount": 35059,
          "commentCount": 636,
          "boostCount": 35666,
          "recommendCount": 1825
        },
        "deeplink": "https://click.snapchat.com/aVHG?pid=snapchat_download_page&af_dp=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ&af_web_dp=https://snapchat.com/download?purpose%3Dweb_stories%26sp%3Dspotlight&af_ios_url=https://apps.apple.com/app/apple-store/id447188370?pt%3D614006%26ct%3Dspotlight%26mt%3D8",
        "oneLinkParams": {
          "oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
          "pidKeys": [
            "af_pid",
            "utm_source"
          ],
          "pidFallbackValue": "consumer_web",
          "campaignKeys": [
            "af_c",
            "utm_campaign"
          ],
          "campaignFallbackValue": "spotlight",
          "googleClickIdParam": "af_sub1",
          "deepLinkUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ",
          "iosAppStoreUrl": "https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=spotlight&mt=8",
          "desktopPageUrl": "https://snapchat.com/download?purpose=web_stories&sp=spotlight"
        },
        "description": "You are my favorite notification!😄❤️",
        "cuSignals": [
          {
            "signal": {
              "$case": "textMetadata",
              "textMetadata": {
                "description": "Emotional message to a loved one.",
                "keywords": [
                  "relationship",
                  "communication"
                ]
              }
            }
          },
          {
            "signal": {
              "$case": "detectedLanguage",
              "detectedLanguage": {
                "languageScores": [
                  {
                    "languageCode": "en",
                    "score": 0.9985544085502625
                  }
                ]
              }
            }
          }
        ],
        "llmDescription": "This short-form content features Jack Scalise, a popular social media personality, inviting his audience to participate in a trending 'disturb me' challenge. The video opens with him speaking directly to the camera against scenic mountain backdrops, using text overlays like 'DISTURB ME UPDATE ME' and 'TELL ME HOW YOUR DAY WAS'. He then transitions to a park setting, smiling and holding a phone, wi…",
        "llmKeywords": [
          "how to get noticed online",
          "engagement tips for creators"
        ],
        "s2iTags": [],
        "llmTitle": "Jack Scalise's 'Disturb Me' Challenge: How to Get Noticed Online",
        "textMetadataKeywords": [
          "relationship",
          "communication"
        ]
      },
      "contentSource": "ssr_initial",
      "vlmSwapEligible": true,
      "upNextThumbnailUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.1400.IRZXSOY?mo=GkYaCTIBBEgCUC5gAVClAloQRGZMYXJnZVRodW1ibmFpbKIBEAj4CiILEgAqB0lSWlhTT1miARAIlgsiCxIAKgdJUlpYU09Z&uc=46"
    }
  },
  "linkPreview": {
    "title": "Spotlight Snap",
    "description": "You are my favorite notification!😄❤️",
    "canonicalUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ",
    "twitterImage": {
      "url": "https://story.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ/preview/square.jpeg",
      "size": {
        "width": 800,
        "height": 800
      }
    },
    "facebookImage": {
      "url": "https://story.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ/preview/square.jpeg",
      "size": {
        "width": 800,
        "height": 800
      }
    },
    "snapchatTitle": ""
  },
  "pageMetadata": {
    "pageType": 11,
    "pageTitle": "jack.scalise | Spotlight on Snapchat",
    "pageDescription": {
      "value": "You are my favorite notification!😄❤️ | Check out the best music, lenses, memes and videos in all the latest Spotlight snaps, brought to you by Snapchat."
    },
    "shareId": ""
  },
  "videoMetadata": {
    "name": "Spotlight Snap",
    "description": "Another Spotlight Snap brought to you by Snapchat",
    "thumbnailUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46",
    "uploadDateMs": "1742742025631",
    "viewCount": "359951",
    "contentUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46",
    "creator": {
      "$case": "personCreator",
      "personCreator": {
        "username": "jack.scalise",
        "url": "https://www.snapchat.com/@jack.scalise",
        "name": "Jack Scalise",
        "followerCount": "0",
        "websiteUrl": ""
      }
    },
    "durationMs": "11200",
    "width": 540,
    "height": 960,
    "keywords": [],
    "shareCount": "0",
    "embeddedTextCaption": ""
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Counts in `spotlight` are numbers; the same counts in `videoMetadata` are strings, as the page gives them. A URL that is not a Spotlight URL is rejected with a free 400 before any request; an unknown Spotlight is a free 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.