Snapchat

Get Snapchat profile

Get a public Snapchat profile by handle.

GET/v1/snapchat/profiles/{handle}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

Snapchat username to look up, with or without a leading @.

min 1 chars · max 255 chars

Response fields
92

Endpoint-specific response payload.

datalookupStatus
string

Whether the profile was found.

one of: found, not_found

Profile details when found.

dataprofileplatform
string

Social platform for this profile.

one of: snapchat

dataprofilehandle
string

Snapchat username without the leading @.

min 1 chars

dataprofiledisplayName
stringnullable

Public display name shown on the profile.

dataprofilebio
stringnullable

Profile biography text.

dataprofileavatarUrl
stringnullable

Profile image URL when available.

dataprofilebannerUrl
stringnullable

Large square profile image URL when available.

dataprofileprofileUrl
string

Canonical public Snapchat profile URL.

min 1 chars

dataprofilewebsiteUrl
stringnullable

Website listed on the profile.

dataprofilesnapcodeUrl
stringnullable

Snapcode image URL for the profile.

dataprofileaddress
stringnullable

Address listed on the profile.

dataprofilecategory
stringnullable

Public profile category identifier when available.

dataprofilesubcategory
stringnullable

Public profile subcategory identifier when available.

dataprofilepublisherType
stringnullable

Publisher type when the profile is a publisher.

dataprofilebusinessProfileId
stringnullable

Snapchat business profile identifier when available.

dataprofilehasStory
boolean

Whether the profile has a story posted right now.

dataprofilecreatedAt
stringnullable

ISO-8601 timestamp when the profile was created.

dataprofileupdatedAt
stringnullable

ISO-8601 timestamp when the profile was last updated.

Profile metrics when found.

datametricsfollowers
integernullable

Follower (subscriber) count when available.

≥ 0

Recent public Spotlight videos (may be empty).

dataspotlights[]id
string

Spotlight snap identifier.

min 1 chars

dataspotlights[]url
string

Canonical public Snapchat Spotlight URL.

min 1 chars

dataspotlights[]caption
stringnullable

Caption written by the creator.

dataspotlights[]generatedTitle
stringnullable

Auto-generated title when available.

dataspotlights[]generatedDescription
stringnullable

Auto-generated description when available.

Auto-generated keywords (may be empty).

dataspotlights[]keywords[]
stringoptional

Hashtags on the video (may be empty).

dataspotlights[]hashtags[]
stringoptional

Sound used in the video when available.

dataspotlights[]soundtitle
string

Sound title.

dataspotlights[]soundcreatorHandle
stringnullable

Snapchat username of the sound's creator when available.

dataspotlights[]thumbnailUrl
stringnullable

Thumbnail image URL when available.

dataspotlights[]videoUrl
stringnullable

Video file URL when available.

dataspotlights[]durationSeconds
numbernullable

Video duration in seconds when available.

≥ 0

dataspotlights[]width
integernullable

Video width in pixels when available.

≥ 0

dataspotlights[]height
integernullable

Video height in pixels when available.

≥ 0

dataspotlights[]createdAt
stringnullable

ISO-8601 timestamp when the video was posted.

Creator of the video when available.

dataspotlights[]authorhandle
stringnullable

Snapchat username without the leading @.

dataspotlights[]authordisplayName
stringnullable

Public display name when available.

dataspotlights[]authorprofileUrl
stringnullable

Public Snapchat profile URL when available.

dataspotlights[]authoravatarUrl
stringnullable

Profile image URL when available.

Engagement metrics for the video.

dataspotlights[]metricsviews
integernullable

View count when available.

≥ 0

dataspotlights[]metricsshares
integernullable

Share count when available.

≥ 0

dataspotlights[]metricscomments
integernullable

Comment count when available.

≥ 0

dataspotlights[]metricsboosts
integernullable

Boost count when available.

≥ 0

dataspotlights[]metricsrecommends
integernullable

Recommend count when available.

≥ 0

Spotlight highlights shown on the profile (may be empty).

dataspotlightHighlights[]id
stringnullable

Highlight identifier when available.

dataspotlightHighlights[]title
stringnullable

Highlight title when available.

dataspotlightHighlights[]thumbnailUrl
stringnullable

Thumbnail image URL when available.

Snaps in the highlight.

dataspotlightHighlights[]snaps[]id
stringnullable

Snap identifier when available.

dataspotlightHighlights[]snaps[]mediaType
stringnullable

Whether the snap is an image or a video.

one of: image, video, null

dataspotlightHighlights[]snaps[]mediaUrl
stringnullable

Media file URL when available.

dataspotlightHighlights[]snaps[]previewUrl
stringnullable

Preview image URL when available.

dataspotlightHighlights[]snaps[]createdAt
stringnullable

ISO-8601 timestamp when the snap was posted.

Curated highlights shown on the profile (may be empty).

datacuratedHighlights[]id
stringnullable

Highlight identifier when available.

datacuratedHighlights[]title
stringnullable

Highlight title when available.

datacuratedHighlights[]thumbnailUrl
stringnullable

Thumbnail image URL when available.

Snaps in the highlight.

datacuratedHighlights[]snaps[]id
stringnullable

Snap identifier when available.

datacuratedHighlights[]snaps[]mediaType
stringnullable

Whether the snap is an image or a video.

one of: image, video, null

datacuratedHighlights[]snaps[]mediaUrl
stringnullable

Media file URL when available.

datacuratedHighlights[]snaps[]previewUrl
stringnullable

Preview image URL when available.

datacuratedHighlights[]snaps[]createdAt
stringnullable

ISO-8601 timestamp when the snap was posted.

Current public story when available.

datastoryid
stringnullable

Highlight identifier when available.

datastorytitle
stringnullable

Highlight title when available.

datastorythumbnailUrl
stringnullable

Thumbnail image URL when available.

Snaps in the highlight.

datastorysnaps[]id
stringnullable

Snap identifier when available.

datastorysnaps[]mediaType
stringnullable

Whether the snap is an image or a video.

one of: image, video, null

datastorysnaps[]mediaUrl
stringnullable

Media file URL when available.

datastorysnaps[]previewUrl
stringnullable

Preview image URL when available.

datastorysnaps[]createdAt
stringnullable

ISO-8601 timestamp when the snap was posted.

Related accounts suggested on the profile (may be empty).

datarelatedAccounts[]handle
stringnullable

Snapchat username without the leading @.

datarelatedAccounts[]displayName
stringnullable

Public display name when available.

datarelatedAccounts[]profileUrl
stringnullable

Public Snapchat profile URL when available.

datarelatedAccounts[]avatarUrl
stringnullable

Profile image URL when available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/snapchat/profiles/kingbach" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Snapchat profile lookup result.