CaptapiCaptapi
Snapchat · Guide

How to get Snapchat user profile

TL;DR
To get Snapchat user profile, sign up for a free Captapi key, then send one GET request to /v1/snapchat/user-profile with your input. You get clean JSON back in seconds for 1 credit per call — no OAuth, scraping or platform SDKs. Snapchat profile — stable identity card, millisecond timestamps, mediaType image/video (1 credit).
Get your free API keyAPI reference

How to get Snapchat user profile (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Snapchat User Profile API

    Send an authenticated GET request to /v1/snapchat/user-profile with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/snapchat/user-profile?url=https%3A%2F%2Fwww.snapchat.com%2F%40nba" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "snapchat",
    "username": "nba",
    "url": "https://www.snapchat.com/@nba",
    "displayName": "NBA",
    "bio": "30 teams, 1 goal.",
    "category": "Business Group",
    "categoryId": "public-profile-category-v3-business-group",
    "subcategory": "Sports League",
    "subcategoryId": "public-profile-subcategory-v3-sports-league",
    "followers": 3550600,
    "verified": true,
    "badge": 1,
    "avatar": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvcGxQanhqRDFZRk9IUWdGMUZLRHNqP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,90_FMjpeg",
    "banner": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvOWJ6SW1LWGpXYkxVNXRTSGZNQjE0P2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,1080_FMjpeg",
    "snapcode": "https://app.snapchat.com/web/deeplink/snapcode?username=nba&type=SVG&bitmoji=enable",
    "website": "https://NBA.com",
    "businessProfileId": "ea71b19b-5eb1-4dda-afb8-13ced485f180",
    "createdAt": "2018-05-17T22:48:15.058Z",
    "updatedAt": "2026-10-19T12:54:00.000Z",
    "hasStory": false,
    "hasCuratedHighlights": true,
    "hasSpotlightHighlights": true,
    "story": {
      "snapCount": 24,
      "thumbnailUrl": "https://cf-st.sc-cdn.net/d/TlHei8q8fnibjGArv54yb.256.IRZXSOY?mo=GlMaDjICBH1IAlBLYAFoDXABUI4BWhBEZkxhcmdlVGh1bWJuYWlsogEUCIACIg8KAmgNEgAqB0lSWlhTT1miARQImgoiDwoCaA0SACoHSVJaWFNPWQ%3D%3D&uc=75",
      "snapList": [
        {
          "snapIndex": 0,
          "snapId": "2wzhbo4SSiWIG-fd9lWR2wAAgZWdkcnpydGVyAaFPoHFHAaFPoG--AAAAAA",
          "mediaType": "image",
          "mediaUrl": "https://cf-st.sc-cdn.net/d/TlHei8q8fnibjGArv54yb.1023.IRZXSOY?mo=GmoaDjICBH1IAlBLYAFoDXABUGBaEVBvcHVsYXJJbWFnZVN0b3J5ogEUCP8HIg8KAmgNEgAqB0lSWlhTT1miARQI5wciDwoCaA0SACoHSVJaWFNPWaIBFAjUByIPCgJoDRIAKgdJUlpYU09Z&uc=75",
          "mediaPreviewUrl": "https://cf-st.sc-cdn.net/d/TlHei8q8fnibjGArv54yb.256.IRZXSOY?mo=GlMaDjICBH1IAlBLYAFoDXABUI4BWhBEZkxhcmdlVGh1bWJuYWlsogEUCIACIg8KAmgNEgAqB0lSWlhTT1miARQImgoiDwoCaA0SACoHSVJaWFNPWQ%3D%3D&uc=75",
          "publishedAt": "2026-10-18T15:27:56.000Z",
          "raw": {
            "snapMediaType": 0,
            "timestampInSec": 1792337276
          }
        },
        {
          "snapIndex": 1,
          "snapId": "2wzhbo4SSiWIG-fd9lWR2wAAga2h5cnFia3RtAaFPwRo6AaFPwRjAAAAAAA",
          "mediaType": "image",
          "mediaUrl": "https://cf-st.sc-cdn.net/d/XmZWSpNetWmcUV96dHO6x.1023.IRZXSOY?mo=GmoaDjICBH1IAlBLYAFoDXABUGBaEVBvcHVsYXJJbWFnZVN0b3J5ogEUCP8HIg8KAmgNEgAqB0lSWlhTT1miARQI5wciDwoCaA0SACoHSVJaWFNPWaIBFAjUByIPCgJoDRIAKgdJUlpYU09Z&uc=75",
          "mediaPreviewUrl": "https://cf-st.sc-cdn.net/d/XmZWSpNetWmcUV96dHO6x.256.IRZXSOY?mo=GlMaDjICBH1IAlBLYAFoDXABUI4BWhBEZkxhcmdlVGh1bWJuYWlsogEUCIACIg8KAmgNEgAqB0lSWlhTT1miARQImgoiDwoCaA0SACoHSVJaWFNPWQ%3D%3D&uc=75",
          "publishedAt": "2026-10-18T16:03:37.000Z",
          "raw": {
            "snapMediaType": 0,
            "timestampInSec": 1792339417
          }
        }
      ]
    },
    "highlights": [
      {
        "highlightId": "029f2cc3-c0df-46c2-b610-485c137f9a0a",
        "storyTitle": "2025-26 NBA Finals 🏆",
        "thumbnailUrl": "https://cf-st.sc-cdn.net/d/ZXSSacNIpSYqxAm21SSGc.410?mo=GjcaFjIBBDoBfUIGCMqG99AGSAJQXmABcAFQxQFaEERmTGFyZ2VUaHVtYm5haWyiAQcImgMiAhIA&uc=94",
        "snapCount": 4,
        "snapList": [
          {
            "snapIndex": 0,
            "mediaType": "image",
            "mediaUrl": "https://cf-st.sc-cdn.net/d/ZXSSacNIpSYqxAm21SSGc.400?mo=Gk8aDDIBBDoBfVBeYAFwAVDBAVoQUHVibGljSW1hZ2VTdG9yeaIBEwiQAyIOCgpCBgjKhvfQBkgCEgCiARMI5wciDgoKQgYIy4b30AZIAxIA&uc=94",
            "mediaPreviewUrl": "https://cf-st.sc-cdn.net/d/ZXSSacNIpSYqxAm21SSGc.410?mo=GjcaFjIBBDoBfUIGCMqG99AGSAJQXmABcAFQxQFaEERmTGFyZ2VUaHVtYm5haWyiAQcImgMiAhIA&uc=94",
            "publishedAt": "2026-06-01T17:36:48.000Z",
            "raw": {
              "snapMediaType": 0,
              "timestampInSec": 1780335408
            }
          },
          {
            "snapIndex": 1,
            "mediaType": "image",
            "mediaUrl": "https://cf-st.sc-cdn.net/d/FgntIqJi6clNRLmaxXkXN.400?mo=Gk0aDjIBBDoBfUgCUF5gAXABUMEBWhBQdWJsaWNJbWFnZVN0b3J5ogERCJADIgwKCEIGCMuG99AGEgCiAREI5wciDAoIQgYIyob30AYSAA%3D%3D&uc=94",
            "mediaPreviewUrl": "https://cf-st.sc-cdn.net/d/FgntIqJi6clNRLmaxXkXN.410?mo=GjcaFjIBBDoBfUIGCMuG99AGSAJQXmABcAFQxQFaEERmTGFyZ2VUaHVtYm5haWyiAQcImgMiAhIA&uc=94",
            "publishedAt": "2026-06-01T17:36:48.000Z",
            "raw": {
              "snapMediaType": 0,
              "timestampInSec": 1780335408
            }
          }
        ]
      },
      {
        "highlightId": "2941c1a3-96ba-45aa-bdf4-30b344e63e42",
        "storyTitle": "Your 2025-26 Kia NBA MVP 🏆",
        "thumbnailUrl": "https://cf-st.sc-cdn.net/d/iqFfVpTceYNBTtMJvlQns.410.IRZXSOY?mo=GkAaFjIBBDoBfUIGCPa5qdAGSAJQXmABcAFQxQFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94",
        "snapCount": 19,
        "snapList": [
          {
            "snapIndex": 0,
            "mediaType": "image",
            "mediaUrl": "https://cf-st.sc-cdn.net/d/iqFfVpTceYNBTtMJvlQns.400.IRZXSOY?mo=GlwaCTIBBFBeYAFwAVDBAVoQUHVibGljSW1hZ2VTdG9yeaIBHwiQAyIaCg06AX1CBgj2uanQBkgCEgAqB0lSWlhTT1miARcI5wciEgoFMgF9SAQSACoHSVJaWFNPWQ%3D%3D&uc=94",
            "mediaPreviewUrl": "https://cf-st.sc-cdn.net/d/iqFfVpTceYNBTtMJvlQns.410.IRZXSOY?mo=GkAaFjIBBDoBfUIGCPa5qdAGSAJQXmABcAFQxQFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94",
            "publishedAt": "2026-05-17T23:43:34.000Z",
            "raw": {
              "snapMediaType": 0,
              "timestampInSec": 1779061414
            }
          },
          {
            "snapIndex": 1,
            "mediaType": "video",
            "mediaUrl": "https://cf-st.sc-cdn.net/d/eHfqR7qRY9kuVjZbupqN4.1034.IRZXSOY?mo=GlgaDDICBH1IA1BeYAFwAVDIAVoHRGZNZWRpYaIBNwiKCBIlCiMIk84gIAEw4AM41AZAAUoOCgk9ExQVFBIUFRUQ9ANQ_E1oAiILEgAqB0lSWlhTT1mQA_xN&uc=94",
            "mediaPreviewUrl": "https://cf-st.sc-cdn.net/d/eHfqR7qRY9kuVjZbupqN4.410.IRZXSOY?mo=GkAaFjIBBDoBfUIGCP25qdAGSAJQXmABcAFQxQFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94",
            "publishedAt": "2026-05-17T23:50:52.000Z",
            "raw": {
              "snapMediaType": 1,
              "timestampInSec": 1779061852
            }
          }
        ]
      }
    ],
    "spotlightHighlights": [
      {
        "id": "W7_EDlXWTBiXAEEniNoMPwAAYdXZ0Y3B4c3V1AaFRm-D-AaFRm8ooAAAAAQ",
        "title": "VJ EDGECOMBE MADE THIS FAN’S NIGHT UNFORGETTABLE LAST SEASON 😮",
        "description": "#vjedgecombe #nba #basketball #sixers",
        "caption": "VJ EDGECOMBE MADE THIS FAN’S NIGHT UNFORGETTABLE LAST SEASON 😮",
        "thumbnailUrl": "https://cf-st.sc-cdn.net/d/DS80Xlo80FAVzIbvFELJ7.256.IRZXSOY?mo=GlAaCzIBBEgCUC5gAWgNUKABWhBEZkxhcmdlVGh1bWJuYWlsogEUCIACIg8KAmgNEgAqB0lSWlhTT1miARQImgoiDwoCaA0SACoHSVJaWFNPWQ%3D%3D&uc=46",
        "contentUrl": "https://cf-st.sc-cdn.net/d/DS80Xlo80FAVzIbvFELJ7.27.IRZXSOY?mo=GmQaCzIBBEgCUC5gAWgNUKIBWhBTcG90bGlnaHRTaGFyaW5nogE7CBsSJgokCJW2fiABMJwEOMAHQAFKDwoKgQEsMmNJS1daRhD0A1CYXGgCIg8KAmgNEgAqB0lSWlhTT1mQA5hc&uc=46",
        "durationMs": 11800,
        "width": 540,
        "height": 960,
        "publishedAt": "2026-10-19T00:42:06.760Z",
        "deeplink": "https://click.snapchat.com/aVHG?pid=snapchat_download_page&af_dp=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYdXZ0Y3B4c3V1AaFRm-D-AaFRm8ooAAAAAQ&af_web_dp=https://snapchat.com/download?purpose%3Dweb_stories%26sp%3Dspotlight&af_ios_url=https://apps.apple.com/app/apple-store/id447188370?pt%3D614006%26ct%3Dspotlight%26mt%3D8",
        "hashtags": [
          "#vjedgecombe",
          "#nba"
        ],
        "creator": {
          "username": "nba",
          "displayName": "NBA",
          "url": "https://www.snapchat.com/@nba"
        },
        "engagement": {
          "shares": 2,
          "comments": 0,
          "boosts": 263,
          "recommends": 5,
          "views": 6759
        },
        "snapList": [
          {
            "snapIndex": 0,
            "snapId": "W7_EDlXWTBiXAEEniNoMPwAAYdXZ0Y3B4c3V1AaFRm-D-AaFRm8ooAAAAAQ",
            "mediaType": "video",
            "mediaUrl": "https://cf-st.sc-cdn.net/d/DS80Xlo80FAVzIbvFELJ7.27.IRZXSOY?mo=GmQaCzIBBEgCUC5gAWgNUKIBWhBTcG90bGlnaHRTaGFyaW5nogE7CBsSJgokCJW2fiABMJwEOMAHQAFKDwoKgQEsMmNJS1daRhD0A1CYXGgCIg8KAmgNEgAqB0lSWlhTT1mQA5hc&uc=46",
            "mediaPreviewUrl": "https://cf-st.sc-cdn.net/d/DS80Xlo80FAVzIbvFELJ7.256.IRZXSOY?mo=GlAaCzIBBEgCUC5gAWgNUKABWhBEZkxhcmdlVGh1bWJuYWlsogEUCIACIg8KAmgNEgAqB0lSWlhTT1miARQImgoiDwoCaA0SACoHSVJaWFNPWQ%3D%3D&uc=46",
            "publishedAt": "2026-10-19T00:42:06.000Z",
            "raw": {
              "snapMediaType": 1,
              "timestampInSec": 1792370526
            }
          }
        ],
        "raw": {
          "uploadDateMs": 1792370526760
        }
      },
      {
        "id": "W7_EDlXWTBiXAEEniNoMPwAAYZWRydmR4b2hzAaFRjMr3AaFRjKtAAAAAAQ",
        "title": "WARRIORS SHOWING LOVE TO THE FANS AT OPEN PRACTICE 🤩🙌",
        "description": "#warriors #stephcurry #basketball #nba",
        "caption": "WARRIORS SHOWING LOVE TO THE FANS AT OPEN PRACTICE 🤩🙌",
        "thumbnailUrl": "https://cf-st.sc-cdn.net/d/vesQKw6ezPsfQuesc49Dh.256.IRZXSOY?mo=GlAaCzIBBEgCUC5gAWgNUKABWhBEZkxhcmdlVGh1bWJuYWlsogEUCIACIg8KAmgNEgAqB0lSWlhTT1miARQImgoiDwoCaA0SACoHSVJaWFNPWQ%3D%3D&uc=46",
        "contentUrl": "https://cf-st.sc-cdn.net/d/vesQKw6ezPsfQuesc49Dh.27.IRZXSOY?mo=GmgaCzIBBEgCUC5gAWgNUKIBWhBTcG90bGlnaHRTaGFyaW5nogE-CBsSKQonCIrk1QEgATCcBDjAB0ABShAKC50BSldzZ1hciAFGEPQDUOCPAWgCIg8KAmgNEgAqB0lSWlhTT1mQA-CPAQ%3D%3D&uc=46",
        "durationMs": 18400,
        "width": 540,
        "height": 960,
        "publishedAt": "2026-10-19T00:25:35.808Z",
        "deeplink": "https://click.snapchat.com/aVHG?pid=snapchat_download_page&af_dp=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZWRydmR4b2hzAaFRjMr3AaFRjKtAAAAAAQ&af_web_dp=https://snapchat.com/download?purpose%3Dweb_stories%26sp%3Dspotlight&af_ios_url=https://apps.apple.com/app/apple-store/id447188370?pt%3D614006%26ct%3Dspotlight%26mt%3D8",
        "hashtags": [
          "#warriors",
          "#stephcurry"
        ],
        "creator": {
          "username": "nba",
          "displayName": "NBA",
          "url": "https://www.snapchat.com/@nba"
        },
        "engagement": {
          "shares": 2,
          "comments": 0,
          "boosts": 106,
          "recommends": 8,
          "views": 1657
        },
        "snapList": [
          {
            "snapIndex": 0,
            "snapId": "W7_EDlXWTBiXAEEniNoMPwAAYZWRydmR4b2hzAaFRjMr3AaFRjKtAAAAAAQ",
            "mediaType": "video",
            "mediaUrl": "https://cf-st.sc-cdn.net/d/vesQKw6ezPsfQuesc49Dh.27.IRZXSOY?mo=GmgaCzIBBEgCUC5gAWgNUKIBWhBTcG90bGlnaHRTaGFyaW5nogE-CBsSKQonCIrk1QEgATCcBDjAB0ABShAKC50BSldzZ1hciAFGEPQDUOCPAWgCIg8KAmgNEgAqB0lSWlhTT1mQA-CPAQ%3D%3D&uc=46",
            "mediaPreviewUrl": "https://cf-st.sc-cdn.net/d/vesQKw6ezPsfQuesc49Dh.256.IRZXSOY?mo=GlAaCzIBBEgCUC5gAWgNUKABWhBEZkxhcmdlVGh1bWJuYWlsogEUCIACIg8KAmgNEgAqB0lSWlhTT1miARQImgoiDwoCaA0SACoHSVJaWFNPWQ%3D%3D&uc=46",
            "publishedAt": "2026-10-19T00:25:35.000Z",
            "raw": {
              "snapMediaType": 1,
              "timestampInSec": 1792369535
            }
          }
        ],
        "raw": {
          "uploadDateMs": 1792369535808
        }
      }
    ],
    "relatedAccounts": [
      {
        "username": "warriors",
        "displayName": "Golden State Warriors",
        "url": "https://www.snapchat.com/@warriors",
        "avatar": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvNjRqVjdIRlJMaHk1V21yS0MwNUZ2P2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg",
        "verified": true,
        "hasStory": true,
        "hasCuratedHighlights": false,
        "hasSpotlightHighlights": false,
        "subscribeLink": {
          "oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
          "deepLinkUrl": "https://www.snapchat.com/@warriors",
          "iosAppStoreUrl": "https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=add_user&mt=8"
        }
      },
      {
        "username": "nfl",
        "displayName": "NFL Official",
        "url": "https://www.snapchat.com/@nfl",
        "avatar": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvT3NjakFOS0dwSWh1VzQwek9qRnowP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg",
        "verified": true,
        "hasStory": true,
        "hasCuratedHighlights": false,
        "hasSpotlightHighlights": false,
        "subscribeLink": {
          "oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
          "deepLinkUrl": "https://www.snapchat.com/@nfl",
          "iosAppStoreUrl": "https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=add_user&mt=8"
        }
      }
    ],
    "raw": {
      "creationTimestampMs": 1526597295058,
      "lastUpdateTimestampMs": 1792414440000
    },
    "mediaUrlsExpireAt": null
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
urlstring YesSnapchat username or profile URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
cachebooleanNoSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Frequently asked questions

What does the Snapchat User Profile API do?

The Snapchat User Profile API lets you fetch profile or page details and audience stats from a public Snapchat profile or page using one GET request to /v1/snapchat/user-profile. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Snapchat User Profile API cost?

Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Snapchat API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle access, rate limits, retries, and authentication for you.

Why did a made-up handle return verified: false and 1 credit?

That was a miss-path bug: badge was absent, so verified became false and the stub shipped as a profile. An unresolved handle is now 404 NOT_FOUND at 0 credits. The error echoes username and url so a fan-out across handles is distinguishable. verified is only derived when a profile actually resolved (badge === 1). A miss is not an unverified account.

Why is highlights missing on one account and an array on another?

It isn't anymore. This is an identity card — highlights is always keyed. hasCuratedHighlights: false means we looked and there are none, so the value is [] (not omitted, not null). profile.highlights.length is safe on every resolved account.

Where did creationTimestampMs / snapMediaType / firstSnapUrl go?

Unix twins and the raw enum live under raw (same move as tiktok/channel-details createTimeUnix). firstSnapUrl / firstSnapType were copies of snapList[0] — read the list. thumbnailUrl stays; it is Snapchat's album cover.

Do the sc-cdn.net URLs expire?

They carry mo= + uc= (they look signed). mo= decodes to the snap's content timestamp — the same instant as publishedAt ± seconds — not a CDN expiry. A June 2026 highlight URL still returned 200 in August; Cache-Control max-age=86400 is a cache hint, not when the URL dies. mediaUrlsExpireAt is null because we will not invent a lifetime. Persist the profile and refetch if a URL 403s.

Is the Snapchat User Profile API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to get Snapchat user profile?

Start free with 100 credits — no credit card required.

Get your free API key