Skip to main content

​
Get Profile

Get public profile information for a Snapchat user.

​
Endpoint

GET /api/snapchat/profile

​
Query Parameters

​
username
string
required
Snapchat username

​
Example Request

curl -X GET "https://rocks.rive.wtf/api/snapchat/profile?username=kyliejenner" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Example

{
  "success": true,
  "data": {
    "info": {
      "username": "kyliejenner",
      "title": "King Kylie 👑",
      "bio": "",
      "subscriberCount": "33147100",
      "badge": 1,
      "profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/...",
      "snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=kyliejenner&type=SVG&bitmoji=enable",
      "squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/...",
      "websiteUrl": "kyliecosmetics.com",
      "address": "",
      "hasStory": false,
      "hasCuratedHighlights": true,
      "hasSpotlightHighlights": true,
      "shouldHideUsername": false,
      "businessProfileId": "e9bcdb52-a5cc-4dea-88ac-8baa91a78345",
      "creationTimestampMs": {
        "value": "1558548110393"
      },
      "lastUpdateTimestampMs": {
        "value": "1768248930000"
      },
      "relatedAccountsInfo": [
        {
          "publicProfileInfo": {
            "username": "kimkardashian",
            "title": "Kim Kardashian",
            "badge": 1,
            "profilePictureUrl": "https://...",
            "subscriberCount": "0"
          },
          "subscribeLink": {
            "deepLinkUrl": "https://www.snapchat.com/add/kimkardashian"
          }
        }
      ]
    },
    "metadata": {
      "pageTitle": "King Kylie 👑 (@kyliejenner) | Snapchat Stories, Spotlight & Lenses",
      "pageDescription": {
        "value": "King Kylie 👑 is on Snapchat! (@kyliejenner) | 33.1m Subscribers | Last updated: 10/11/2025"
      },
      "pageType": 18
    }
  }
}

​
Response Fields

​
success
boolean
Whether the request was successful
​
data
object
Profile data container
Only public Snapchat profiles can be accessed through this API. The subscriberCount is returned as a string and should be parsed as a number for calculations.
The snapcodeImageUrl provides a direct link to the user’s Snapcode image (SVG format), which can be scanned to add the user on Snapchat. The badge field with value 1 indicates a verified account.

​
Use Cases

Influencer Analytics

Track influencer subscriber counts and growth

Profile Verification

Verify Snapchat accounts for authenticity

Social Discovery

Discover related accounts and connections

Bot Integration

Display Snapchat profiles in Discord/Telegram bots

​
Additional Notes

​
Timestamp Conversion

Timestamps are provided in milliseconds. Convert to seconds before using with standard date libraries: 
const timestamp = parseInt(info.creationTimestampMs.value) / 1000;
const date = new Date(timestamp * 1000);

​
Subscriber Count Parsing

The subscriberCount field is returned as a string. Always parse it as an integer for calculations: 
const subscribers = parseInt(info.subscriberCount);

​
Verification Badge

A badge value of 1 indicates a verified account. Use this to display verification status: 
const isVerified = info.badge === 1;