Get a Snapchat user 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-09-14T12:14:53.199Z"
},
"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 was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Snapchat
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.
GET
/
v1
/
snapchat
/
profile
Get a Snapchat user 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-09-14T12:14:53.199Z"
},
"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 was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}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