SNAPCHAT API
User Profile
Retrieve user profile from Snapchat with a single API request.
GET
/api/data/v1/snapchat/profile1credit base cost
Request parameters
Up to 1 creditSnapchat username
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/snapchat/profile?handle=zane' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"userProfile": {
"username": "zane",
"title": "Zane",
"snapcodeImageUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=zane&type=SVG&bitmoji=enable",
"badge": 1,
"categoryStringId": "",
"subcategoryStringId": "",
"subscriberCount": "1535700",
"bio": "Time to get buck wild baby",
"websiteUrl": "",
"profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvSG5jNU4zNFh5MWNacFlPR0Y2T3pxP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
"address": "",
"bitmoji3d": null,
"hasCuratedHighlights": true,
"hasSpotlightHighlights": true,
"mutableName": "",
"publisherType": "",
"squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZnl5TndBTlZVU1IzckVGWWpuQlZnP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,1080_FMjpeg",
"primaryColor": "",
"hasStory": false,
"relatedAccountsInfo": [
{
"publicProfileInfo": {
"username": "imnotscottysire",
"title": "Scotty Sire",
"snapcodeImageUrl": "",
"badge": 1,
"categoryStringId": "",
"subcategoryStringId": "",
"subscriberCount": "0",
"bio": "",
"websiteUrl": "",
"profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZUhZSzNoRVRGcEhLeHFaVEtKOEQwP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,640_FMjpeg",
"address": "",
"bitmoji3d": null,
"hasCuratedHighlights": false,
"hasSpotlightHighlights": false,
"mutableName": "",
"publisherType": "",
"squareHeroImageUrl": "",
"primaryColor": "",
"hasStory": true,
"relatedAccountsInfo": [],
"creationTimestampMs": null,
"lastUpdateTimestampMs": null,
"businessProfileId": "ebc366e6-3058-4c94-8e85-35a4e50c6737"
},
"subscribeLink": {
"oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
"pidKeys": [
"af_pid"
],
"pidFallbackValue": "consumer_web",
"campaignKeys": [
"af_c"
],
"campaignFallbackValue": "add_user",
"googleClickIdParam": "af_sub1",
"deepLinkUrl": "https://www.snapchat.com/add/imnotscottysire?sc_referrer=web",
"iosAppStoreUrl": "https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=add_user&mt=8",
"desktopPageUrl": "https://snapchat.com/download?purpose=web_stories&sp=add_user"
}
}
],
"creationTimestampMs": {
"value": "1584846804362"
},
"lastUpdateTimestampMs": {
"value": "1741518441231"
},
"businessProfileId": "e123b268-312b-41d6-8088-b51c12c6f2c6"
},
"story": null,
"curatedHighlights": [
{
"storyType": 3,
"snapList": [
{
"snapIndex": 0,
"snapId": {
"value": ""
},
"snapMediaType": 0,
"snapUrls": {
"mediaUrl": "https://cf-st.sc-cdn.net/d/21JGtXabuZ1AfXw5L5vjB.400.IRZXSOY?mo=GlQaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBQdWJsaWNJbWFnZVN0b3J5ogEQCJADIgsSACoHSVJaWFNPWaIBEAjnByILEgAqB0lSWlhTT1k%3D&uc=94",
"mediaPreviewUrl": {
"value": "https://cf-st.sc-cdn.net/d/21JGtXabuZ1AfXw5L5vjB.410.IRZXSOY?mo=GkEaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBEZkxhcmdlVGh1bWJuYWlsogEQCJoDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94"
},
"overlayUrl": null,
"attachmentUrl": null
},
"isSponsored": null,
"timestampInSec": {
"value": "1670431570"
},
"snapTitle": null,
"snapSubtitles": null,
"lat": null,
"lng": null,
"hasAttachment": null,
"intervalStartTimeMs": null,
"audioTranscriptionObjectUrl": null
}
],
"storyId": {
"value": ""
},
"storyTitle": {
"value": "FULL HAIR TRANSFORMATION (PART 1)"
},
"thumbnailUrl": {
"value": "https://cf-st.sc-cdn.net/d/bNrrl36C71xV5GeTS13qP.410.IRZXSOY?mo=GkEaGhoAGgAyAQQ6AX1CBgjxsM6eBkgDUF5gAXABWhBEZkxhcmdlVGh1bWJuYWlsogEQCJoDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94"
},
"storySubtitle": null,
"storyShareId": null,
"canonicalUrlSuffix": null,
"emoji": null,
"storyTapId": "0",
"videoTrackUrl": null,
"highlightId": {
"value": "39f6379c-1787-4f79-859c-8cee75a8076e"
},
"isAttributed": null
}
],
"spotlightHighlights": [
{
"storyType": 3,
"snapList": [
{
"snapIndex": 0,
"snapId": {
"value": "W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"
},
"snapMediaType": 1,
"snapUrls": {
"mediaUrl": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.1034.IRZXSOY?mo=GkAaDRoAGgAyAQRIA1AuYAGiAS4IiggSHAoaIAFKEQoMY0Y9R0RFR0M5OU8uEPQDWgMQsz8iCxIAKgdJUlpYU09Z&uc=46",
"mediaPreviewUrl": {
"value": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46"
},
"overlayUrl": null,
"attachmentUrl": null
},
"isSponsored": null,
"timestampInSec": {
"value": "1680981126"
},
"snapTitle": null,
"snapSubtitles": null,
"lat": null,
"lng": null,
"hasAttachment": null,
"intervalStartTimeMs": null,
"audioTranscriptionObjectUrl": null
}
],
"storyId": {
"value": "W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"
},
"storyTitle": {
"value": ""
},
"thumbnailUrl": {
"value": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46"
},
"storySubtitle": null,
"storyShareId": null,
"canonicalUrlSuffix": null,
"emoji": null,
"storyTapId": "0",
"videoTrackUrl": null,
"highlightId": {
"value": "W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"
},
"isAttributed": null
}
],
"spotlightStoryMetadata": [
{
"videoMetadata": {
"name": "Turn around sir",
"description": "Another Spotlight Snap brought to you by Snapchat",
"thumbnailUrl": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46",
"uploadDateMs": "1680981126784",
"viewCount": "11937",
"contentUrl": "https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.27.IRZXSOY?mo=GlIaDRoAGgAyAQRIAlAuYAFaEFNwb3RsaWdodFNoYXJpbmeiAS4IGxIdChsgAUoSCg2AAWRTY2VgX21QTXA9EPQDWgMQmT8iCxIAKgdJUlpYU09Z&uc=46",
"creator": {
"$case": "personCreator",
"personCreator": {
"username": "zane",
"url": "https://www.snapchat.com/add/zane",
"name": "Zane",
"followerCount": "0",
"websiteUrl": ""
}
},
"durationMs": "6200",
"width": 540,
"height": 960,
"keywords": [],
"shareCount": "0",
"embeddedTextCaption": "Turn around sir"
},
"userMetadata": null,
"lensMetadata": null,
"hashtags": [],
"contextCards": [
{
"contextType": 2,
"title": "@zane's Sound",
"subtitle": "",
"url": "",
"thumbnailUrl": "https://cf-st.sc-cdn.net/d/6YKRUxipwtyh6YMgtaJbK?bo=Eg0aABoAMgEESAJQCGAB&uc=8",
"snapcodeUrl": "",
"thumbnailType": 2,
"hasBadge": false
}
],
"engagementStats": {
"viewCount": "11937",
"shareCount": "6",
"commentCount": "10"
},
"deeplink": "https://click.snapchat.com/aVHG?pid=snapchat_download_page&af_dp=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ?sc_referrer%3Dweb&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",
"oneLinkParams": {
"oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
"pidKeys": [
"af_pid"
],
"pidFallbackValue": "consumer_web",
"campaignKeys": [
"af_c"
],
"campaignFallbackValue": "spotlight",
"googleClickIdParam": "af_sub1",
"deepLinkUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ?sc_referrer=web",
"iosAppStoreUrl": "https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=spotlight&mt=8",
"desktopPageUrl": "https://snapchat.com/download?purpose=web_stories&sp=spotlight"
},
"description": ""
}
],
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"userProfile": {
"type": "object",
"properties": {
"username": {
"type": "string"
},
"title": {
"type": "string"
},
"snapcodeImageUrl": {
"type": "string"
},
"badge": {
"type": "integer"
},
"categoryStringId": {
"type": "string"
},
"subcategoryStringId": {
"type": "string"
},
"subscriberCount": {
"type": "string"
},
"bio": {
"type": "string"
},
"websiteUrl": {
"type": "string"
},
"profilePictureUrl": {
"type": "string"
},
"address": {
"type": "string"
},
"bitmoji3d": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hasCuratedHighlights": {
"type": "boolean"
},
"hasSpotlightHighlights": {
"type": "boolean"
},
"mutableName": {
"type": "string"
},
"publisherType": {
"type": "string"
},
"squareHeroImageUrl": {
"type": "string"
},
"primaryColor": {
"type": "string"
},
"hasStory": {
"type": "boolean"
},
"relatedAccountsInfo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"publicProfileInfo": {
"type": "object",
"properties": {
"username": {
"type": "string"
},
"title": {
"type": "string"
},
"snapcodeImageUrl": {
"type": "string"
},
"badge": {
"type": "integer"
},
"categoryStringId": {
"type": "string"
},
"subcategoryStringId": {
"type": "string"
},
"subscriberCount": {
"type": "string"
},
"bio": {
"type": "string"
},
"websiteUrl": {
"type": "string"
},
"profilePictureUrl": {
"type": "string"
},
"address": {
"type": "string"
},
"bitmoji3d": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hasCuratedHighlights": {
"type": "boolean"
},
"hasSpotlightHighlights": {
"type": "boolean"
},
"mutableName": {
"type": "string"
},
"publisherType": {
"type": "string"
},
"squareHeroImageUrl": {
"type": "string"
},
"primaryColor": {
"type": "string"
},
"hasStory": {
"type": "boolean"
},
"relatedAccountsInfo": {
"type": "array"
},
"creationTimestampMs": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"lastUpdateTimestampMs": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"businessProfileId": {
"type": "string"
}
}
},
"subscribeLink": {
"type": "object",
"properties": {
"oneLinkBaseUrl": {
"type": "string"
},
"pidKeys": {
"type": "array",
"items": {
"type": "string"
}
},
"pidFallbackValue": {
"type": "string"
},
"campaignKeys": {
"type": "array",
"items": {
"type": "string"
}
},
"campaignFallbackValue": {
"type": "string"
},
"googleClickIdParam": {
"type": "string"
},
"deepLinkUrl": {
"type": "string"
},
"iosAppStoreUrl": {
"type": "string"
},
"desktopPageUrl": {
"type": "string"
}
}
}
}
}
},
"creationTimestampMs": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"lastUpdateTimestampMs": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"businessProfileId": {
"type": "string"
}
}
},
"story": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"curatedHighlights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"storyType": {
"type": "integer"
},
"snapList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"snapIndex": {
"type": "integer"
},
"snapId": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"snapMediaType": {
"type": "integer"
},
"snapUrls": {
"type": "object",
"properties": {
"mediaUrl": {
"type": "string"
},
"mediaPreviewUrl": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"overlayUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"attachmentUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"isSponsored": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"timestampInSec": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"snapTitle": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"snapSubtitles": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"lat": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"lng": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hasAttachment": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"intervalStartTimeMs": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"audioTranscriptionObjectUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
}
},
"storyId": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"storyTitle": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"thumbnailUrl": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"storySubtitle": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"storyShareId": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"canonicalUrlSuffix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"emoji": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"storyTapId": {
"type": "string"
},
"videoTrackUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"highlightId": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"isAttributed": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
}
},
"spotlightHighlights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"storyType": {
"type": "integer"
},
"snapList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"snapIndex": {
"type": "integer"
},
"snapId": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"snapMediaType": {
"type": "integer"
},
"snapUrls": {
"type": "object",
"properties": {
"mediaUrl": {
"type": "string"
},
"mediaPreviewUrl": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"overlayUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"attachmentUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"isSponsored": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"timestampInSec": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"snapTitle": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"snapSubtitles": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"lat": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"lng": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hasAttachment": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"intervalStartTimeMs": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"audioTranscriptionObjectUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
}
},
"storyId": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"storyTitle": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"thumbnailUrl": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"storySubtitle": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"storyShareId": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"canonicalUrlSuffix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"emoji": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"storyTapId": {
"type": "string"
},
"videoTrackUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"highlightId": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"isAttributed": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
}
},
"spotlightStoryMetadata": {
"type": "array",
"items": {
"type": "object",
"properties": {
"videoMetadata": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"uploadDateMs": {
"type": "string"
},
"viewCount": {
"type": "string"
},
"contentUrl": {
"type": "string"
},
"creator": {
"type": "object",
"properties": {
"$case": {
"type": "string"
},
"personCreator": {
"type": "object",
"properties": {
"username": {
"type": "string"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"followerCount": {
"type": "string"
},
"websiteUrl": {
"type": "string"
}
}
}
}
},
"durationMs": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"keywords": {
"type": "array"
},
"shareCount": {
"type": "string"
},
"embeddedTextCaption": {
"type": "string"
}
}
},
"userMetadata": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"lensMetadata": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hashtags": {
"type": "array"
},
"contextCards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"contextType": {
"type": "integer"
},
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"url": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"snapcodeUrl": {
"type": "string"
},
"thumbnailType": {
"type": "integer"
},
"hasBadge": {
"type": "boolean"
}
}
}
},
"engagementStats": {
"type": "object",
"properties": {
"viewCount": {
"type": "string"
},
"shareCount": {
"type": "string"
},
"commentCount": {
"type": "string"
}
}
},
"deeplink": {
"type": "string"
},
"oneLinkParams": {
"type": "object",
"properties": {
"oneLinkBaseUrl": {
"type": "string"
},
"pidKeys": {
"type": "array",
"items": {
"type": "string"
}
},
"pidFallbackValue": {
"type": "string"
},
"campaignKeys": {
"type": "array",
"items": {
"type": "string"
}
},
"campaignFallbackValue": {
"type": "string"
},
"googleClickIdParam": {
"type": "string"
},
"deepLinkUrl": {
"type": "string"
},
"iosAppStoreUrl": {
"type": "string"
},
"desktopPageUrl": {
"type": "string"
}
}
},
"description": {
"type": "string"
}
}
}
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}