SNAPCHAT API

User Profile

Retrieve user profile from Snapchat with a single API request.

GET/api/data/v1/snapchat/profile
1credit base cost

Request parameters

Up to 1 credit

Snapchat username

Try in the console

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."
    }
  }
}