Profile

GET/v1/snapchat/profile1 credit

Returns a public Snapchat profile: display name, bio, subscriber count, website, profile and snapcode images, plus the profile's curated highlights and Spotlight highlights.

01Query parameters

Name	Type	Description
handlerequired	string	The Snapchat username (a leading `@` is fine) or a profile URL, e.g. `zane`.

02Request

curl "https://api.scrapesocial.ai/v1/snapchat/profile?handle=zane" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/snapchat/profile?handle=zane

{
  "success": true,
  "credits_remaining": 4980,
  "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": "1459100",
    "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": false,
    "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": false,
          "relatedAccountsInfo": [],
          "creationTimestampMs": null,
          "lastUpdateTimestampMs": null,
          "businessProfileId": "ebc366e6-3058-4c94-8e85-35a4e50c6737",
          "sameAsLinks": [],
          "shouldHideUsername": false,
          "audienceGateSettings": null,
          "hostUserId": ""
        },
        "subscribeLink": {
          "oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
          "pidKeys": [
            "af_pid",
            "utm_source"
          ],
          "pidFallbackValue": "consumer_web",
          "campaignKeys": [
            "af_c",
            "utm_campaign"
          ],
          "campaignFallbackValue": "add_user",
          "googleClickIdParam": "af_sub1",
          "deepLinkUrl": "https://www.snapchat.com/@imnotscottysire",
          "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"
        }
      },
      {
        "publicProfileInfo": {
          "username": "toddysmithy",
          "title": "toddysmithy",
          "snapcodeImageUrl": "",
          "badge": 1,
          "categoryStringId": "",
          "subcategoryStringId": "",
          "subscriberCount": "0",
          "bio": "",
          "websiteUrl": "",
          "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvRU0yNWJseUVVaTJWVFNNUk9vNkJvP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg",
          "address": "",
          "bitmoji3d": null,
          "hasCuratedHighlights": false,
          "hasSpotlightHighlights": false,
          "mutableName": "",
          "publisherType": "",
          "squareHeroImageUrl": "",
          "primaryColor": "",
          "hasStory": true,
          "relatedAccountsInfo": [],
          "creationTimestampMs": null,
          "lastUpdateTimestampMs": null,
          "businessProfileId": "98af2236-b98c-48f6-81c1-b788b6216624",
          "sameAsLinks": [],
          "shouldHideUsername": false,
          "audienceGateSettings": null,
          "hostUserId": ""
        },
        "subscribeLink": {
          "oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
          "pidKeys": [
            "af_pid",
            "utm_source"
          ],
          "pidFallbackValue": "consumer_web",
          "campaignKeys": [
            "af_c",
            "utm_campaign"
          ],
          "campaignFallbackValue": "add_user",
          "googleClickIdParam": "af_sub1",
          "deepLinkUrl": "https://www.snapchat.com/@toddysmithy",
          "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": "1789159931958"
    },
    "businessProfileId": "e123b268-312b-41d6-8088-b51c12c6f2c6",
    "sameAsLinks": [
      "https://www.youtube.com/channel/UCiIFLzjBUX5WpkVqVDVWMTQ"
    ],
    "shouldHideUsername": false,
    "audienceGateSettings": null,
    "hostUserId": "3ced38c6-62da-4b2e-99ac-a0622ef844e9"
  },
  "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
        },
        {
          "snapIndex": 1,
          "snapId": {
            "value": ""
          },
          "snapMediaType": 0,
          "snapUrls": {
            "mediaUrl": "https://cf-st.sc-cdn.net/d/LH9oHM9Xat2FvnKwaPzfI.400.IRZXSOY?mo=GlQaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBQdWJsaWNJbWFnZVN0b3J5ogEQCJADIgsSACoHSVJaWFNPWaIBEAjnByILEgAqB0lSWlhTT1k%3D&uc=94",
            "mediaPreviewUrl": {
              "value": "https://cf-st.sc-cdn.net/d/LH9oHM9Xat2FvnKwaPzfI.410.IRZXSOY?mo=GkEaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBEZkxhcmdlVGh1bWJuYWlsogEQCJoDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94"
            },
            "overlayUrl": null,
            "attachmentUrl": null
          },
          "isSponsored": null,
          "timestampInSec": {
            "value": "1670431723"
          },
          "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,
      "thumbnailTiles": []
    }
  ],
  "spotlightHighlights": [],
  "spotlightStoryMetadata": []
}

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

The profile sits in `userProfile`; `subscriberCount` is a string, as Snapchat sends it. An unknown username is a free 404; a value that is not a username is a free 400.

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.