Snapchat User Profile

Retrieves a Snapchat user's public profile by handle, including identity, stories, and spotlight content.

1 credit / request

GET /v1/snapchat/profile Try it

Snapchat User Profile
GET /v1/snapchat/profile

Retrieves a Snapchat user's public profile by handle, including identity, stories, and spotlight content.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/snapchat/profile?handle=zane

Parameters:
- handle (query · string · required) = zane

Overview

WakeScrap exposes this Snapchat endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

Retrieves a Snapchat user's public profile by handle, including identity, stories, and spotlight content. Returns userProfile with username, title, snapcodeImageUrl, subscriberCount, bio, and profilePictureUrl. Also includes highlightStoryMetadata with individual story snaps (mediaUrl, mediaType, thumbnailUrl) and spotlightStoryMetadata with video details and engagement stats (viewCount, shareCount, commentCount).

Required params: handle.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

handle string required

Snapchat username

Example:

zane


              curl 'https://api.datawake.ai/v1/snapchat/profile?handle=zane' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/snapchat/profile?handle=zane", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/snapchat/profile?handle=zane",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/snapchat/profile?handle=zane",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/snapchat/profile?handle=zane", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/snapchat/profile?handle=zane"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "success": true,
  "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": "",
    "...": "5 more fields"
  },
  "story": null,
  "curatedHighlights": [
    {
      "storyType": 3,
      "snapList": [
        {
          "snapIndex": "...",
          "snapId": "...",
          "snapMediaType": "...",
          "snapUrls": "...",
          "isSponsored": "...",
          "timestampInSec": "...",
          "snapTitle": "...",
          "snapSubtitles": "...",
          "lat": "...",
          "lng": "...",
          "hasAttachment": "...",
          "intervalStartTimeMs": "...",
          "audioTranscriptionObjectUrl": "..."
        }
      ],
      "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": "...",
          "snapId": "...",
          "snapMediaType": "...",
          "snapUrls": "...",
          "isSponsored": "...",
          "timestampInSec": "...",
          "snapTitle": "...",
          "snapSubtitles": "...",
          "lat": "...",
          "lng": "...",
          "hasAttachment": "...",
          "intervalStartTimeMs": "...",
          "audioTranscriptionObjectUrl": "..."
        }
      ],
      "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=4...",
        "creator": {
          "$case": "...",
          "personCreator": "..."
        },
        "durationMs": "6200",
        "width": 540,
        "height": 960,
        "keywords": [],
        "shareCount": "0",
        "embeddedTextCaption": "Turn around sir"
      },
      "userMetadata": null,
      "lensMetadata": null,
      "hashtags": [],
      "contextCards": [
        {
          "contextType": "...",
          "title": "...",
          "subtitle": "...",
          "url": "...",
          "thumbnailUrl": "...",
          "snapcodeUrl": "...",
          "thumbnailType": "...",
          "hasBadge": "..."
        }
      ],
      "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...",
      "oneLinkParams": {
        "oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
        "pidKeys": [
          "..."
        ],
        "pidFallbackValue": "consumer_web",
        "campaignKeys": [
          "..."
        ],
        "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": ""
    }
  ]
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}