logoPandorLabs
social data api

Snapchat logoSnapchat

Public profiles, Spotlight videos and Spotlight comments.

Public profile1 request
Spotlight video1 request
Spotlight comments1 request
GET/v1/snapchat/profile

Public profile

1 request

Returns a Snapchat account's public profile from its handle. userProfile holds username, title, snapcodeImageUrl, subscriberCount, bio and profilePictureUrl. highlightStoryMetadata lists the story snaps (mediaUrl, mediaType, thumbnailUrl), and spotlightStoryMetadata covers Spotlight videos with viewCount, shareCount and commentCount.

Query parameters

handle
stringrequired
Snapchat username.
curl "https://api.pandorlabs.com/v1/snapchat/profile?handle=zane" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "userProfile": {
    "username": "zane",
    "title": "Zane",
    "snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=zane&type=SVG&bitmoji=enable",
    "badge": 1,
    "categoryStringId": "",
    "subcategoryStringId": "",
    "subscriberCount": "1535700",
    "bio": "Time to get buck wild baby",
    "websiteUrl": "",
    "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvSG5jNU4zNFh5MWNacFlPR0Y2T3pxP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
    "address": "",
    "bitmoji3d": null,
    "hasCuratedHighlights": true,
    "hasSpotlightHighlights": true,
    "mutableName": "",
    "publisherType": "",
    "squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZnl5TndBTlZVU1IzckVGWWpuQlZnP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,1080_FMjpeg",
    "primaryColor": "",
    "hasStory": false,
    "relatedAccountsInfo": [
      {
        "publicProfileInfo": {
          "username": "imnotscottysire",
          "title": "Scotty Sire",
          "snapcodeImageUrl": "",
          "badge": 1,
          "categoryStringId": "",
          "subcategoryStringId": "",
          "subscriberCount": "0",
          "bio": "",
          "websiteUrl": "",
          "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZUhZSzNoRVRGcEhLeHFaVEtKOEQwP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,640_FMjpeg",
          "address": "",
          "bitmoji3d": null,
          "hasCuratedHighlights": false,
          "hasSpotlightHighlights": false,
          "mutableName": "",
          "publisherType": "",
          "squareHeroImageUrl": "",
          "primaryColor": "",
          "hasStory": true,
          "relatedAccountsInfo": [],
          "creationTimestampMs": null,
          "lastUpdateTimestampMs": null,
          "businessProfileId": "ebc366e6-3058-4c94-8e85-35a4e50c6737"
        },
        "subscribeLink": {
          "oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
          "pidKeys": [
            "af_pid"
          ],
          "pidFallbackValue": "consumer_web",
          "campaignKeys": [
            "af_c"
          ],
          "campaignFallbackValue": "add_user",
          "googleClickIdParam": "af_sub1",
          "deepLinkUrl": "https://www.snapchat.com/add/imnotscottysire?sc_referrer=web",
          "iosAppStoreUrl": "https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=add_user&mt=8",
          "desktopPageUrl": "https://snapchat.com/download?purpose=web_stories&sp=add_user"
        }
      }
    ],
    "creationTimestampMs": {
      "value": "1584846804362"
    },
    "lastUpdateTimestampMs": {
      "value": "1741518441231"
    },
    "businessProfileId": "e123b268-312b-41d6-8088-b51c12c6f2c6"
  },
  "story": null,
  "curatedHighlights": [
    {
      "storyType": 3,
      "snapList": [
        {
          "snapIndex": 0,
          "snapId": {
            "value": ""
          },
          "snapMediaType": 0,
          "snapUrls": {
            "mediaUrl": "https://cf-st.sc-cdn.net/d/21JGtXabuZ1AfXw5L5vjB.400.IRZXSOY?mo=GlQaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBQdWJsaWNJbWFnZVN0b3J5ogEQCJADIgsSACoHSVJaWFNPWaIBEAjnByILEgAqB0lSWlhTT1k%3D&uc=94",
            "mediaPreviewUrl": {
              "value": "https://cf-st.sc-cdn.net/d/21JGtXabuZ1AfXw5L5vjB.410.IRZXSOY?mo=GkEaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBEZkxhcmdlVGh1bWJuYWlsogEQCJoDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94"
            },
            "overlayUrl": null,
            "attachmentUrl": null
          },
          "isSponsored": null,
          "timestampInSec": {
            "value": "1670431570"
          },
          "snapTitle": null,
          "snapSubtitles": null,
          "lat": null,
          "lng": null,
          "hasAttachment": null,
          "intervalStartTimeMs": null,
          "audioTranscriptionObjectUrl": null
        }
      ],
      "storyId": {
        "value": ""
      },
      "storyTitle": {
        "value": "FULL HAIR TRANSFORMATION (PART 1)"
      },
      "thumbnailUrl": {
        "value": "https://cf-st.sc-cdn.net/d/bNrrl36C71xV5GeTS13qP.410.IRZXSOY?mo=GkEaGhoAGgAyAQQ6AX1CBgjxsM6eBkgDUF5gAXABWhBEZkxhcmdlVGh1bWJuYWlsogEQCJoDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94"
      },
      "storySubtitle": null,
      "storyShareId": null,
      "canonicalUrlSuffix": null,
      "emoji": null,
      "storyTapId": "0",
      "videoTrackUrl": null,
      "highlightId": {
        "value": "39f6379c-1787-4f79-859c-8cee75a8076e"
      },
      "isAttributed": null
    }
  ],
  "spotlightHighlights": [
    {
      "storyType": 3,
      "snapList": [
        {
          "snapIndex": 0,
          "snapId": {
            "value": "W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"
          },
          "snapMediaType": 1,
          "snapUrls": {
            "mediaUrl": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.1034.IRZXSOY?mo=GkAaDRoAGgAyAQRIA1AuYAGiAS4IiggSHAoaIAFKEQoMY0Y9R0RFR0M5OU8uEPQDWgMQsz8iCxIAKgdJUlpYU09Z&uc=46",
            "mediaPreviewUrl": {
              "value": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46"
            },
            "overlayUrl": null,
            "attachmentUrl": null
          },
          "isSponsored": null,
          "timestampInSec": {
            "value": "1680981126"
          },
          "snapTitle": null,
          "snapSubtitles": null,
          "lat": null,
          "lng": null,
          "hasAttachment": null,
          "intervalStartTimeMs": null,
          "audioTranscriptionObjectUrl": null
        }
      ],
      "storyId": {
        "value": "W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"
      },
      "storyTitle": {
        "value": ""
      },
      "thumbnailUrl": {
        "value": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46"
      },
      "storySubtitle": null,
      "storyShareId": null,
      "canonicalUrlSuffix": null,
      "emoji": null,
      "storyTapId": "0",
      "videoTrackUrl": null,
      "highlightId": {
        "value": "W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"
      },
      "isAttributed": null
    }
  ],
  "spotlightStoryMetadata": [
    {
      "videoMetadata": {
        "name": "Turn around sir",
        "description": "Another Spotlight Snap brought to you by Snapchat",
        "thumbnailUrl": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46",
        "uploadDateMs": "1680981126784",
        "viewCount": "11937",
        "contentUrl": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.27.IRZXSOY?mo=GlIaDRoAGgAyAQRIAlAuYAFaEFNwb3RsaWdodFNoYXJpbmeiAS4IGxIdChsgAUoSCg2AAWRTY2VgX21QTXA9EPQDWgMQmT8iCxIAKgdJUlpYU09Z&uc=46",
        "creator": {
          "$case": "personCreator",
          "personCreator": {
            "username": "zane",
            "url": "https://www.snapchat.com/add/zane",
            "name": "Zane",
            "followerCount": "0",
            "websiteUrl": ""
          }
        },
        "durationMs": "6200",
        "width": 540,
        "height": 960,
        "keywords": [],
        "shareCount": "0",
        "embeddedTextCaption": "Turn around sir"
      },
      "userMetadata": null,
      "lensMetadata": null,
      "hashtags": [],
      "contextCards": [
        {
          "contextType": 2,
          "title": "@zane's Sound",
          "subtitle": "",
          "url": "",
          "thumbnailUrl": "https://cf-st.sc-cdn.net/d/6YKRUxipwtyh6YMgtaJbK?bo=Eg0aABoAMgEESAJQCGAB&uc=8",
          "snapcodeUrl": "",
          "thumbnailType": 2,
          "hasBadge": false
        }
      ],
      "engagementStats": {
        "viewCount": "11937",
        "shareCount": "6",
        "commentCount": "10"
      },
      "deeplink": "https://click.snapchat.com/aVHG?pid=snapchat_download_page&af_dp=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ?sc_referrer%3Dweb&af_web_dp=https://snapchat.com/download?purpose%3Dweb_stories%…",
      "oneLinkParams": {
        "oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
        "pidKeys": [
          "af_pid"
        ],
        "pidFallbackValue": "consumer_web",
        "campaignKeys": [
          "af_c"
        ],
        "campaignFallbackValue": "spotlight",
        "googleClickIdParam": "af_sub1",
        "deepLinkUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ?sc_referrer=web",
        "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": ""
    }
  ]
}
GET/v1/snapchat/spotlight

Spotlight video

1 request

Returns a Snapchat Spotlight video from its URL: the snap id, its creator and description, engagement counts, the thumbnail and the content URL, for whichever of these Snapchat makes public.

Query parameters

url
stringrequired
Link to the Spotlight video.
curl "https://api.pandorlabs.com/v1/snapchat/spotlight?url=https%3A%2F%2Fwww.snapchat.com%2F%40jack.scalise%2Fspotlight%2FW7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "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.",
    "viewCount": 359935,
    "shareCount": 35057,
    "commentCount": 636,
    "engagementStats": {
      "viewCount": 359935,
      "shareCount": 35057,
      "commentCount": 636,
      "boostCount": 35666,
      "recommendCount": 1842
    },
    "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": {}
  },
  "linkPreview": {},
  "pageMetadata": {},
  "videoMetadata": {}
}
GET/v1/snapchat/spotlight/comments

Spotlight comments

1 request

Returns the public comments on a Snapchat Spotlight video. The response has the snap id, the comments, hasMore, and a cursor; send that cursor back to load the next batch.

Query parameters

url
stringrequired
Link to the Spotlight video.
cursor
string
Cursor from the previous response.
curl "https://api.pandorlabs.com/v1/snapchat/spotlight/comments?url=https%3A%2F%2Fwww.snapchat.com%2F%40lilah4823%2Fspotlight%2FW7_EDlXWTBiXAEEniNoMPwAAYY2pvZnd0ZXVmAZ8fgG8pAZ8ff-_IAAAAAQ" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "snapId": "W7_EDlXWTBiXAEEniNoMPwAAYY2pvZnd0ZXVmAZ8fgG8pAZ8ff-_IAAAAAQ",
  "comments": [
    {
      "replyText": "Guys who can't even read a paragraph are hilarious 😭 get yourself a better man",
      "replyPosterDisplayName": "🎸Callie✌️",
      "replyTimestampMs": "1782948905027",
      "threadedReplyCount": 152,
      "reactCounts": [
        {
          "reactTypeId": 1,
          "reactCount": 829
        }
      ]
    }
  ],
  "cursor": "CpMCEpACQ3NjQkNnZ0tBbkp6RWdJSUJBb05DZ0owY3hJSENLZjA1TW55TXhLbkFXb1hjMzVrWld4MFlTMW1iM0pqWlMxdVlXMDFMWEJ5YjJSeWl3RUxFaEJUY0c5MGJHbG5hSFJTWlhCc2FXVnpJanRYTjE5RlJHeFlWMVJDYVZoQlJVVnVhVTV2VFZCM1FVRlpXVEp3ZGxwdVpEQmFXRlp0UVZvNFptZEhPSEJCV2pobVpp…",
  "hasMore": true
}