/v1/snapchat/profile

GET

User Profile

Get Snapchat user profile

Credit cost	Default: 1 credit How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Not specified in the published contract.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`handle` Snapchat username	query / required	`string`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v1/snapchat/profile?handle=YOUR_HANDLE' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/snapchat/profile?handle=YOUR_HANDLE", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v1/snapchat/profile?handle=YOUR_HANDLE",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

userProfilerequired

object

usernamerequired

string

titlerequired

string

snapcodeImageUrlrequired

string

badgerequired

integer

categoryStringIdrequired

string

subcategoryStringIdrequired

string

subscriberCountrequired

string

biorequired

string

websiteUrlrequired

string

profilePictureUrlrequired

string

addressrequired

string

bitmoji3drequired

null

hasCuratedHighlightsrequired

boolean

hasSpotlightHighlightsrequired

boolean

mutableNamerequired

string

publisherTyperequired

string

squareHeroImageUrlrequired

string

primaryColorrequired

string

hasStoryrequired

boolean

relatedAccountsInforequired

array

Array items

object

publicProfileInforequired

object

usernamerequired

string

titlerequired

string

snapcodeImageUrlrequired

string

badgerequired

integer

categoryStringIdrequired

string

subcategoryStringIdrequired

string

subscriberCountrequired

string

biorequired

string

websiteUrlrequired

string

profilePictureUrlrequired

string

addressrequired

string

bitmoji3drequired

null

hasCuratedHighlightsrequired

boolean

hasSpotlightHighlightsrequired

boolean

mutableNamerequired

string

publisherTyperequired

string

squareHeroImageUrlrequired

string

primaryColorrequired

string

hasStoryrequired

boolean

relatedAccountsInforequired

array

creationTimestampMsrequired

null

lastUpdateTimestampMsrequired

null

businessProfileIdrequired

string

sameAsLinksoptional

array

shouldHideUsernameoptional

boolean

audienceGateSettingsoptional

null

hostUserIdoptional

string

subscribeLinkrequired

object

oneLinkBaseUrlrequired

string

pidKeysrequired

array

Array items

string

pidFallbackValuerequired

string

campaignKeysrequired

array

Array items

string

campaignFallbackValuerequired

string

googleClickIdParamrequired

string

deepLinkUrlrequired

string

iosAppStoreUrlrequired

string

desktopPageUrlrequired

string

creationTimestampMsrequired

object

valuerequired

string

lastUpdateTimestampMsrequired

object

valuerequired

string

businessProfileIdrequired

string

sameAsLinksoptional

array

shouldHideUsernameoptional

boolean

audienceGateSettingsoptional

null

hostUserIdoptional

string

storyrequired

null

curatedHighlightsrequired

array

Array items

object

storyTyperequired

integer

snapListrequired

array

Array items

object

snapIndexrequired

integer

snapIdrequired

object

valuerequired

string

snapMediaTyperequired

integer

snapUrlsrequired

object

mediaUrlrequired

string

mediaPreviewUrlrequired

object

valuerequired

string

overlayUrlrequired

null

attachmentUrlrequired

null

isSponsoredrequired

null

timestampInSecrequired

object

valuerequired

string

snapTitlerequired

null

snapSubtitlesrequired

null

latrequired

null

lngrequired

null

hasAttachmentrequired

null

intervalStartTimeMsrequired

null

audioTranscriptionObjectUrlrequired

null

storyIdrequired

object

valuerequired

string

storyTitlerequired

object

valuerequired

string

thumbnailUrlrequired

object

valuerequired

string

storySubtitlerequired

null

storyShareIdrequired

null

canonicalUrlSuffixrequired

null

emojirequired

null

storyTapIdrequired

string

videoTrackUrlrequired

null

highlightIdrequired

object

valuerequired

string

isAttributedrequired

null

thumbnailTilesoptional

array

spotlightHighlightsrequired

array

Array items

object

storyTyperequired

integer

snapListrequired

array

Array items

object

snapIndexrequired

integer

snapIdrequired

object

valuerequired

string

snapMediaTyperequired

integer

snapUrlsrequired

object

mediaUrlrequired

string

mediaPreviewUrlrequired

object

valuerequired

string

overlayUrlrequired

null

attachmentUrlrequired

null

isSponsoredrequired

null

timestampInSecrequired

object

valuerequired

string

snapTitlerequired

null

snapSubtitlesrequired

null

latrequired

null

lngrequired

null

hasAttachmentrequired

null

intervalStartTimeMsrequired

null

audioTranscriptionObjectUrlrequired

object

valuerequired

string

storyIdrequired

object

valuerequired

string

storyTitlerequired

object

valuerequired

string

thumbnailUrlrequired

object

valuerequired

string

storySubtitlerequired

null

storyShareIdrequired

null

canonicalUrlSuffixrequired

null

emojirequired

null

storyTapIdrequired

string

videoTrackUrlrequired

null

highlightIdrequired

object

valuerequired

string

isAttributedrequired

object

valuerequired

boolean

thumbnailTilesoptional

array

Array items

object

tileTyperequired

integer

urlrequired

object

valuerequired

string

tileIdrequired

null

vlmSwapEligibleoptional

boolean

spotlightStoryMetadatarequired

array

Array items

object

videoMetadatarequired

object

namerequired

string

descriptionrequired

string

thumbnailUrlrequired

string

uploadDateMsrequired

string

viewCountrequired

string

contentUrlrequired

string

creatorrequired

object

$caserequired

string

personCreatorrequired

object

usernamerequired

string

urlrequired

string

namerequired

string

followerCountrequired

string

websiteUrlrequired

string

durationMsrequired

string

widthrequired

integer

heightrequired

integer

keywordsrequired

array

shareCountrequired

string

embeddedTextCaptionrequired

string

userMetadatarequired

null

lensMetadatarequired

null

hashtagsrequired

array

contextCardsrequired

array

Array items

object

contextTyperequired

integer

titlerequired

string

subtitlerequired

string

urlrequired

string

thumbnailUrlrequired

string

snapcodeUrlrequired

string

thumbnailTyperequired

integer

hasBadgerequired

boolean

idoptional

string

engagementStatsrequired

object

viewCountrequired

string

shareCountrequired

string

commentCountrequired

string

boostCountoptional

string

recommendCountoptional

string

deeplinkrequired

string

oneLinkParamsrequired

object

oneLinkBaseUrlrequired

string

pidKeysrequired

array

Array items

string

pidFallbackValuerequired

string

campaignKeysrequired

array

Array items

string

campaignFallbackValuerequired

string

googleClickIdParamrequired

string

deepLinkUrlrequired

string

iosAppStoreUrlrequired

string

desktopPageUrlrequired

string

descriptionrequired

string

llmDescriptionoptional

string

llmKeywordsoptional

array

Array items

string

s2iTagsoptional

array

llmTitleoptional

string

textMetadataKeywordsoptional

array

Array items

string

cuSignalsoptional

array

Array items

object

signalrequired

object

$caserequired

string

textMetadataoptional

object

descriptionrequired

string

keywordsrequired

array

Array items

string

detectedLanguageoptional

object

languageScoresrequired

array

Array items

object

languageCoderequired

string

scorerequired

schema

anyOf

number

anyOf

integer

llmPredictionoptional

object

llmPromptResultrequired

object

promptNamerequired

string

promptResultrequired

object

titlerequired

object

resultrequired

object

$caserequired

string

stringValuerequired

string

keywordsrequired

object

resultrequired

object

$caserequired

string

stringValuerequired

string

descriptionrequired

object

resultrequired

object

$caserequired

string

stringValuerequired

string

s2iTagsoptional

object

tagsrequired

array

Array items

string

scoredTagsrequired

array

Array items

object

namerequired

string

scorerequired

number

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited