> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a Snapchat user profile > Fetches a public Snapchat profile by username (handle): identity (display name, bio, avatar, snapcode, verification badge, subscriber count, category, timestamps), the current story, curated + spotlight highlights (with snaps), and the profile lenses. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/snapchat/profile openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: Google description: Google Search scraping endpoints paths: /v1/snapchat/profile: get: tags: - Snapchat summary: Get a Snapchat user profile description: >- Fetches a public Snapchat profile by username (handle): identity (display name, bio, avatar, snapcode, verification badge, subscriber count, category, timestamps), the current story, curated + spotlight highlights (with snaps), and the profile lenses. parameters: - name: handle in: query required: true description: >- The Snapchat username (with or without a leading @), e.g. teamsnapchat. schema: type: string example: heycalacademy - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The Snapchat profile. content: application/json: schema: type: object properties: data: type: object properties: profile: type: object fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: profile: profileType: publicProfileInfo username: heycalacademy displayName: California Academy of Sciences bio: >- An aquarium, planetarium, rainforest, natural history museum, & research institution—all under one living roof. 🌈 address: San Francisco, CA, USA websiteUrl: null profilePictureUrl: >- https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvQ1BTdGxxbmZkdFZMS01xcEhFWENBP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg snapcodeImageUrl: >- https://app.snapchat.com/web/deeplink/snapcode?username=heycalacademy&type=SVG&bitmoji=enable squareHeroImageUrl: null subscriberCount: 0 badge: 0 isOfficial: false category: null subcategory: null publisherType: null primaryColor: null hasStory: false hasCuratedHighlights: true hasSpotlightHighlights: false createdAt: '2021-10-19T23:35:42.458Z' updatedAt: '2026-05-08T00:42:39.000Z' businessProfileId: fd3eba83-bb8c-4126-8040-0c09e7535a2a hostUserId: 544713de-2838-41d5-97d7-b3b82744926f bitmoji3dUrl: null canonicalUrl: https://www.snapchat.com/@heycalacademy previewImageUrl: >- https://www.snapchat.com/web-capture/www.snapchat.com/@heycalacademy/preview/square.jpeg?xp_id=1 relatedAccounts: [] sameAsLinks: [] story: null lenses: - id: 838c73413c2d4892b38c14cb9319059a name: Moray Eel creatorDisplayName: California Academy of Sciences creatorUsername: null previewImageUrl: >- https://lens-preview-storage.storage.googleapis.com/previewmedia/preview_thumbnail/33bb420f-5161-4f37-a2f8-c7b67b44b7ab.webp previewVideoUrl: null iconUrl: >- https://bolt-gcdn.sc-cdn.net/3/CrwAPWKfthKhklmyg1YTN?bo=EhgaABoAMgF9OgEEQgYIkabE8AVIAlASYAE%3D&uc=18 unlockUrl: >- https://www.snapchat.com/unlock/?type=SNAPCODE&uuid=838c73413c2d4892b38c14cb9319059a&metadata=01 scannableImageUrl: null isOfficial: false updatedAt: '2026-05-08T00:39:26.000Z' - id: 468ac9adad7e4a089f20fd891579e11f name: Green Sea Turtle creatorDisplayName: California Academy of Sciences creatorUsername: null previewImageUrl: >- https://lens-preview-storage.storage.googleapis.com/previewmedia/preview_thumbnail/3424af99-81db-4457-aef6-7f49210a8137.webp previewVideoUrl: null iconUrl: >- https://bolt-gcdn.sc-cdn.net/3/j96Nf2DUbMJ6IkZ25pUAH?bo=EhgaABoAMgF9OgEEQgYI8-jO8AVIAlASYAE%3D&uc=18 unlockUrl: >- https://www.snapchat.com/unlock/?type=SNAPCODE&uuid=468ac9adad7e4a089f20fd891579e11f&metadata=01 scannableImageUrl: null isOfficial: false updatedAt: '2026-05-08T00:42:39.000Z' - id: 610083f754b34a63bc9ecb342c1d99ed name: Nudibranch creatorDisplayName: California Academy of Sciences creatorUsername: null previewImageUrl: >- https://lens-preview-storage.storage.googleapis.com/previewmedia/preview_thumbnail/a9a90649-a554-4b99-af7a-9323ee58caf6.webp previewVideoUrl: null iconUrl: >- https://bolt-gcdn.sc-cdn.net/3/2ehdYAJGp2TDUljFnOsea?bo=EhgaABoAMgF9OgEEQgYIs_nS8AVIAlASYAE%3D&uc=18 unlockUrl: >- https://www.snapchat.com/unlock/?type=SNAPCODE&uuid=610083f754b34a63bc9ecb342c1d99ed&metadata=01 scannableImageUrl: null isOfficial: false updatedAt: '2026-05-08T00:40:04.000Z' curatedHighlights: - id: 2a0dc52c-99ce-443b-be0d-f6d2ccb41dd4 storyId: null title: null subtitle: null thumbnailUrl: >- https://cf-st.sc-cdn.net/d/fS9yXoP12P2XITGaycT4g.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 emoji: null canonicalUrlSuffix: null snapCount: 1 snaps: - index: 0 mediaType: 1 mediaUrl: >- https://cf-st.sc-cdn.net/d/fS9yXoP12P2XITGaycT4g.1034.IRZXSOY?mo=GkoaDRoAGgAyAQRIBlBeYAFaB0RmTWVkaWGiAS8IiggSHQobIAFKFwoSpAE6PS5DKjY3Ly08JzwpJyZNEPQDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94 previewUrl: >- https://cf-st.sc-cdn.net/d/fS9yXoP12P2XITGaycT4g.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 overlayUrl: null timestamp: '2022-03-02T17:06:25.000Z' title: null lat: null lng: null - id: 0e026a65-6801-4fa1-b60b-bafc129fef49 storyId: null title: tiny aquarium wonders✨ subtitle: null thumbnailUrl: >- https://cf-st.sc-cdn.net/d/Vxva98QRxtaCuTOMMk905.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 emoji: null canonicalUrlSuffix: null snapCount: 6 snaps: - index: 0 mediaType: 1 mediaUrl: >- https://cf-st.sc-cdn.net/d/Vxva98QRxtaCuTOMMk905.1034.IRZXSOY?mo=GkoaDRoAGgAyAQRIBlBeYAFaB0RmTWVkaWGiAS8IiggSHQobIAFKFwoSNhIRCw8SEwwRDg0LDhAPCzcIEPQDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94 previewUrl: >- https://cf-st.sc-cdn.net/d/Vxva98QRxtaCuTOMMk905.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 overlayUrl: null timestamp: '2021-10-22T19:55:29.000Z' title: null lat: null lng: null - index: 1 mediaType: 1 mediaUrl: >- https://cf-st.sc-cdn.net/d/hrWbO7LdnTJPOkszNbElx.1325.IRZXSOY?mo=GqoCGgsaABoAMgEEUF5gAVoHRGZNZWRpYaIBQgitChIsCiogAUoYChM_DREKDg0NCQ4LDQgMDgwJOwoKEPQDWgMQ9CJaBwiVQRCz3w8iDwoCSAISACoHSVJaWFNPWaIBQgiRChIsCiogAUoYChMtCwkGCgkIBwgKCAUJCgkFKAUIEPQDWgMQ8iVaBwiVQRC15goiDwoCSAMSACoHSVJaWFNPWaIBQgiBChIsCiogAUoYChMZBQQDBAUEAwQEBAIFBAQDFwMDEPQDWgMQ8SVaBwiVQRDFrQUiDwoCSAMSACoHSVJaWFNPWaIBQgieChIsCiogAUoYChMdAwMEBAMEAgQCAwMEAwQCGwICEPQDWgMQ7yJaBwiVQRCy9wQiDwoCSAMSACoHSVJaWFNPWQ%3D%3D&uc=94 previewUrl: >- https://cf-st.sc-cdn.net/d/hrWbO7LdnTJPOkszNbElx.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 overlayUrl: null timestamp: '2021-10-22T19:55:47.000Z' title: null lat: null lng: null - index: 2 mediaType: 1 mediaUrl: >- https://cf-st.sc-cdn.net/d/wuxdeeRNGEcuUMN17NXgo.1325.IRZXSOY?mo=GvYBGgsaABoAMgEEUF5gAVoHRGZNZWRpYaIBNQitChIfCh0gAUoUCg88DA4IDA0KCgwPDAwNCQoQ9ANaAxC0HCIPCgJIAhIAKgdJUlpYU09ZogE1CJEKEh8KHSABShQKDyoKCQcICQcGCQoIBggJBxD0A1oDEO0eIg8KAkgDEgAqB0lSWlhTT1miATUIgQoSHwodIAFKFAoPFwQFAgQEBAIEBgIFBAIEEPQDWgMQ5B4iDwoCSAMSACoHSVJaWFNPWaIBNQieChIfCh0gAUoUCg8bAwQCAwMCBAMDBAMDAwIQ9ANaAxCvHCIPCgJIAxIAKgdJUlpYU09Z&uc=94 previewUrl: >- https://cf-st.sc-cdn.net/d/wuxdeeRNGEcuUMN17NXgo.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 overlayUrl: null timestamp: '2021-10-22T19:55:47.000Z' title: null lat: null lng: null - id: 447cb02d-f63c-439f-8af9-879d2bfce31c storyId: null title: Turn your world into a coral reef 🐠 subtitle: null thumbnailUrl: >- https://cf-st.sc-cdn.net/d/TyoZBvwTRbG1HVV35Vyvr.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 emoji: null canonicalUrlSuffix: null snapCount: 10 snaps: - index: 0 mediaType: 1 mediaUrl: >- https://cf-st.sc-cdn.net/d/kB9E1lNtfeLJbTIwIUel0.1325.IRZXSOY?mo=GqoCGgsaABoAMgEEUF5gAVoHRGZNZWRpYaIBQgitChIsCiogAUoYChNlIyMeISEjHCEjGCcZIyEjXh0cEPQDWgMQkiNaBwiuQRCe4CUiDwoCSAISACoHSVJaWFNPWaIBQgiRChIsCiogAUoYChNzIS4pKiIoLSEqISsfLyEjUDAbEPQDWgMQ4CRaBwiuQRDL7isiDwoCSAISACoHSVJaWFNPWaIBQgiBChIsCiogAUoYChNbGSEfHxgfIRcfFx8WIRggRiIUEPQDWgMQ6SRaBwiuQRDIhCEiDwoCSAMSACoHSVJaWFNPWaIBQgieChIsCiogAUoYChNLGRsWGhkTGxkTFx4TGRkbRxMUEPQDWgMQ_CJaBwiuQRDeixwiDwoCSAMSACoHSVJaWFNPWQ%3D%3D&uc=94 previewUrl: >- https://cf-st.sc-cdn.net/d/kB9E1lNtfeLJbTIwIUel0.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 overlayUrl: null timestamp: '2021-10-22T22:10:04.000Z' title: null lat: null lng: null - index: 1 mediaType: 1 mediaUrl: >- https://cf-st.sc-cdn.net/d/G0S2bVSd7nvpQoiPj75G0.1325.IRZXSOY?mo=GuYBGgsaABoAMgEEUF5gAVoHRGZNZWRpYaIBMQitChIbChkgAUoQCgszFxoWKhccHRQVExD0A1oDEJYXIg8KAkgCEgAqB0lSWlhTT1miATEIkQoSGwoZIAFKEAoLLRMWFh8UGBoQEhAQ9ANaAxCMGSIPCgJIAhIAKgdJUlpYU09ZogExCIEKEhsKGSABShAKCyYPExIaEBQUDQ8MEPQDWgMQjRkiDwoCSAMSACoHSVJaWFNPWaIBMQieChIbChkgAUoQCgsnDxIPGxUSEREOCRD0A1oDEIgXIg8KAkgDEgAqB0lSWlhTT1k%3D&uc=94 previewUrl: >- https://cf-st.sc-cdn.net/d/G0S2bVSd7nvpQoiPj75G0.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 overlayUrl: null timestamp: '2021-10-22T22:10:04.000Z' title: null lat: null lng: null - index: 2 mediaType: 1 mediaUrl: >- https://cf-st.sc-cdn.net/d/37V9GiKlmId81AnnTnbdB.1325.IRZXSOY?mo=GuIBGgsaABoAMgEEUF5gAVoHRGZNZWRpYaIBMAitChIaChggAUoPCgo3HyASGRUTGxUbEPQDWgMQqhYiDwoCSAISACoHSVJaWFNPWaIBMAiRChIaChggAUoPCgosGxcNEw4SEBUUEPQDWgMQnxgiDwoCSAISACoHSVJaWFNPWaIBMAiBChIaChggAUoPCgonFRQQDQoNEg8QEPQDWgMQoBgiDwoCSAMSACoHSVJaWFNPWaIBMAieChIaChggAUoPCgolFhYQEAsOEw8TEPQDWgMQpBYiDwoCSAMSACoHSVJaWFNPWQ%3D%3D&uc=94 previewUrl: >- https://cf-st.sc-cdn.net/d/37V9GiKlmId81AnnTnbdB.410.IRZXSOY?mo=GjQaDRoAGgAyAQRIBFBeYAFaEERmTGFyZ2VUaHVtYm5haWyiARAImgMiCxIAKgdJUlpYU09Z&uc=94 overlayUrl: null timestamp: '2021-10-22T22:10:04.000Z' title: null lat: null lng: null spotlightHighlights: [] counts: lenses: 5 curatedHighlights: 3 spotlightHighlights: 0 fetchedAt: '2026-09-14T12:14:53.199Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: Profile not found / unavailable. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (missing or malformed handle). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '502': description: Upstream block. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source was temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ````