Profile
curl --request GET \
--url https://api.scraperize.com/v1/snapchat/profile \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/snapchat/profile"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/snapchat/profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/snapchat/profile",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/snapchat/profile"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/snapchat/profile")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/snapchat/profile")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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-10-05T14:44:03.503Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"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"
}
}{
"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"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Snapchat
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.
GET
/
v1
/
snapchat
/
profile
Profile
curl --request GET \
--url https://api.scraperize.com/v1/snapchat/profile \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/snapchat/profile"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/snapchat/profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/snapchat/profile",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/snapchat/profile"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/snapchat/profile")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/snapchat/profile")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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-10-05T14:44:03.503Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"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"
}
}{
"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"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Cost: 1 credit per successful request. Errors and cache hits (
cache_max_age) are free.Copy for AI assistant
Copy for AI assistant
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
Prompt
I want to make an API call to /v1/snapchat/profile. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/snapchat/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.
Required Headers:
- x-api-key: Your API key
Parameters:
- handle (string) [required]: The Snapchat username (with or without a leading @), e.g. teamsnapchat.
- cache_max_age (select): 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.
Example Response:
{
"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"
}
],
"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=GkoaDRoAGgAyAQRIBlBeYAFaB0RmTWVkaWGiAS8IiggSHQobIAFKFwoSpAE6PS5DKjY3Ly08JzwpJyZNEPQDIgsSACoHSVJ…",
"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
}
]
}
],
"spotlightHighlights": [],
"counts": {
"lenses": 5,
"curatedHighlights": 3,
"spotlightHighlights": 0
}
},
"fetchedAt": "2026-10-05T14:44:03.503Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
Authorizations
Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.
Query Parameters
The Snapchat username (with or without a leading @), e.g. teamsnapchat.
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.
Available options:
1d, 3d, 7d, 14d, 30d