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": null,
"categoryStringId": null,
"subcategoryStringId": null,
"bio": "Time to get buck wild baby",
"websiteUrl": "",
"profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvSG5jNU4zNFh5MWNacFlPR0Y2T3pxP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
"address": "",
"mutableName": null,
"publisherType": null,
"squareHeroImageUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZnl5TndBTlZVU1IzckVGWWpuQlZnP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,1080_FMjpeg",
"primaryColor": null,
"businessProfileId": "e123b268-312b-41d6-8088-b51c12c6f2c6",
"hostUserId": "3ced38c6-62da-4b2e-99ac-a0622ef844e9",
"hasCuratedHighlights": true,
"hasSpotlightHighlights": false,
"hasStory": null,
"shouldHideUsername": false,
"badge": 1,
"subscriberCount": "1455400",
"bitmoji3d": null,
"audienceGateSettings": null,
"creationTimestampMs": {
"value": "1584846804362"
},
"lastUpdateTimestampMs": {
"value": "1794864655600"
},
"sameAsLinks": [
"https://www.youtube.com/channel/UCiIFLzjBUX5WpkVqVDVWMTQ"
],
"relatedAccountsInfo": [
{
"publicProfileInfo": {
"username": "imnotscottysire",
"title": "Scotty Sire",
"snapcodeImageUrl": null,
"categoryStringId": null,
"subcategoryStringId": null,
"bio": null,
"websiteUrl": null,
"profilePictureUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZUhZSzNoRVRGcEhLeHFaVEtKOEQwP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,640_FMjpeg",
"address": null,
"mutableName": null,
"publisherType": null,
"squareHeroImageUrl": null,
"primaryColor": null,
"businessProfileId": null,
"hostUserId": null,
"hasCuratedHighlights": null,
"hasSpotlightHighlights": null,
"hasStory": null,
"shouldHideUsername": null,
"badge": 1,
"subscriberCount": null,
"bitmoji3d": null,
"audienceGateSettings": null,
"creationTimestampMs": null,
"lastUpdateTimestampMs": null,
"sameAsLinks": null,
"relatedAccountsInfo": null
},
"subscribeLink": null
}
]
},
"story": null,
"curatedHighlights": [
{
"storyType": null,
"snapList": [
{
"snapIndex": 0,
"snapId": {
"value": "ce2fdc29-ea2e-4440-a3b4-655f80d56518"
},
"snapMediaType": 0,
"snapUrls": {
"mediaUrl": "https://cf-st.sc-cdn.net/d/21JGtXabuZ1AfXw5L5vjB.400.IRZXSOY?mo=GlQaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBQdWJsaWNJbWFnZVN0b3J5ogEQCJADIgsSACoHSVJaWFNPWaIBEAjnByILEgAqB0lSWlhTT1k%3D&uc=94",
"mediaPreviewUrl": null,
"overlayUrl": null,
"attachmentUrl": null
},
"isSponsored": null,
"timestampInSec": null,
"snapTitle": null,
"snapSubtitles": null,
"lat": null,
"lng": null,
"hasAttachment": null,
"intervalStartTimeMs": null,
"audioTranscriptionObjectUrl": null
}
],
"storyId": null,
"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": null,
"videoTrackUrl": null,
"highlightId": {
"value": "39f6379c-1787-4f79-859c-8cee75a8076e"
},
"isAttributed": null,
"thumbnailTiles": null
}
],
"spotlightHighlights": [],
"spotlightStoryMetadata": [],
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Illustrative response with example values adapted for FetchGoblin. Run a request to retrieve current platform 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",
"object",
"array",
"number",
"boolean",
"null"
]
},
"categoryStringId": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"subcategoryStringId": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"bio": {
"type": "string"
},
"websiteUrl": {
"type": "string"
},
"profilePictureUrl": {
"type": "string"
},
"address": {
"type": "string"
},
"mutableName": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"publisherType": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"squareHeroImageUrl": {
"type": "string"
},
"primaryColor": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"businessProfileId": {
"type": "string"
},
"hostUserId": {
"type": "string"
},
"hasCuratedHighlights": {
"type": "boolean"
},
"hasSpotlightHighlights": {
"type": "boolean"
},
"hasStory": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"shouldHideUsername": {
"type": "boolean"
},
"badge": {
"type": "integer"
},
"subscriberCount": {
"type": "string"
},
"bitmoji3d": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"audienceGateSettings": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"creationTimestampMs": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"lastUpdateTimestampMs": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"sameAsLinks": {
"type": "array",
"items": {
"type": "string"
}
},
"relatedAccountsInfo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"publicProfileInfo": {
"type": "object",
"properties": {
"username": {
"type": "string"
},
"title": {
"type": "string"
},
"snapcodeImageUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"categoryStringId": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"subcategoryStringId": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"bio": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"websiteUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"profilePictureUrl": {
"type": "string"
},
"address": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"mutableName": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"publisherType": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"squareHeroImageUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"primaryColor": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"businessProfileId": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hostUserId": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hasCuratedHighlights": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hasSpotlightHighlights": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"hasStory": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"shouldHideUsername": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"badge": {
"type": "integer"
},
"subscriberCount": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"bitmoji3d": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"audienceGateSettings": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"creationTimestampMs": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"lastUpdateTimestampMs": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"sameAsLinks": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"relatedAccountsInfo": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"subscribeLink": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
}
}
}
},
"story": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"curatedHighlights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"storyType": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"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": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"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": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"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": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"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",
"object",
"array",
"number",
"boolean",
"null"
]
},
"videoTrackUrl": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"highlightId": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
}
},
"isAttributed": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"thumbnailTiles": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
}
},
"spotlightHighlights": {
"type": "array"
},
"spotlightStoryMetadata": {
"type": "array"
},
"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."
}
}
}