Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rocks.docs.rive.wtf/llms.txt

Use this file to discover all available pages before exploring further.

Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.
Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.

​
Quick Start

1

Choose a username

Use the public Snapchat username you want.
2

Call the profile route

Send a request to /api/snapchat/profile?username=....
3

Read the profile data

Use the response for profile info, metadata, and related account details.
This route only works for public Snapchat profiles.

​
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"

​
Example Response

{
  "success": true,
  "data": {
    "username": "kyliejenner",
    "source_url": "https://www.snapchat.com/add/kyliejenner",
    "snapcode_image_url": "https://app.snapchat.com/web/deeplink/snapcode?username=kyliejenner&type=SVG&bitmoji=enable",
    "display_name": "King Kylie 👑",
    "subscriber_count": "32811400",
    "profile_picture_url": "https://cf-st.sc-cdn.net/aps/bolt/...",
    "website_url": "kyliecosmetics.com",
    "has_story": false,
    "has_curated_highlights": true,
    "has_spotlight_highlights": true,
    "business_profile_id": "e9bcdb52-a5cc-4dea-88ac-8baa91a78345",
    "badge": 1,
    "should_hide_username": false,
    "page_title": "King Kylie 👑 (@kyliejenner) | Snapchat Stories, Spotlight & Lenses",
    "page_description": "King Kylie 👑 is on Snapchat! (@kyliejenner) | 32.8m Subscribers | Last updated: 03/18/2026",
    "canonical_url": "https://www.snapchat.com/@kyliejenner",
    "last_updated_text": "03/18/2026",
    "subscriber_count_text": "33M",
    "spotlight_post_count": 15,
    "spotlight_posts": [
      {
        "url": "https://www.snapchat.com/@kyliejenner/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYdXFqcmV2ZHlsAZxP6MmtAZxP5_58AAAAAQ",
        "label": "132k 285 385"
      }
    ],
    "topics": [
      {
        "name": "Kourtney Kardashian",
        "url": "https://www.snapchat.com/topic/kourtney-kardashian"
      }
    ],
    "recommended_accounts": [
      {
        "username": "kimkardashian",
        "display_name": "The Kardashians",
        "url": "https://www.snapchat.com/add/kimkardashian"
      }
    ],
    "next_data_summary": {
      "build_id": "cDIxYWeQsb1J_rFjnNH2_",
      "page": "/at/[username]",
      "query": {
        "username": "@kyliejenner"
      },
      "page_props_keys": [
        "curatedHighlights",
        "spotlightHighlights",
        "spotlightStoryMetadata",
        "story",
        "storyMetadata",
        "userProfile",
        "viewerInfo"
      ]
    }
  }
}

​
Response Fields

​
success
boolean
Whether the request was successful.
​
data
object
Flattened public profile data scraped from Snapchat’s public web page.
Only public Snapchat profiles can be accessed through this API.
snapcode_image_url is a direct Snapcode image link. A badge value of 1 usually means the account is verified.
FieldTypeDescription
usernamestringSnapchat username
source_urlstringPublic /add/ page URL
snapcode_image_urlstringDirect Snapcode image URL
display_namestringPublic display name
subscriber_countstringSubscriber count as a raw string
profile_picture_urlstringProfile image URL
website_urlstringPublic website URL if available
has_storybooleanWhether the page indicates an active story
has_curated_highlightsbooleanWhether curated highlights are available
has_spotlight_highlightsbooleanWhether spotlight highlights are available
business_profile_idstringPublic business profile ID when exposed
badgenumberVerification-like badge value
should_hide_usernamebooleanWhether the username should be hidden on the page
page_titlestringPublic page title
page_descriptionstringPublic meta description
canonical_urlstringCanonical public profile URL
last_updated_textstringLast updated text from the page
subscriber_count_textstringShort subscriber count text like 33M
spotlight_post_countnumberNumber of spotlight links found
spotlight_postsarraySpotlight links found on the public page
topicsarrayTopic links found on the page
recommended_accountsarrayRecommended account links found on the page
next_data_summaryobjectSummary of exposed __NEXT_DATA__ frontend keys

​
Use Cases

Influencer Analytics

Track influencer subscriber counts and growth

Profile Verification

Verify Snapchat accounts for authenticity

Social Discovery

Discover related accounts, topics, and profile links

Bot Integration

Display Snapchat profiles in Discord/Telegram bots

​
Additional Notes

​
Subscriber Count Parsing

subscriber_count is returned as a string. Parse it before using it in calculations: 
const subscribers = parseInt(data.subscriber_count, 10);

​
Verification Badge

A badge value of 1 usually means the account is verified: 
const isVerified = data.badge === 1;