Linktree

Get Linktree profile

Get a public Linktree profile by handle, including links and socials.

GET/v1/linktree/profiles/{handle}
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
handle*stringpath

Linktree handle to look up, with or without a leading @.

min 1 chars · max 64 chars

Response fields
25

Endpoint-specific response payload.

datalookupStatus
string

Whether the page was found.

one of: found, not_found

Profile when lookupStatus is `found`; null when `not_found`.

dataprofileplatform
string

Social platform for this profile.

one of: linktree

dataprofilehandle
string

Canonical public username/handle without a leading @.

min 1 chars

dataprofiledisplayName
stringnullable

Public display title shown on the page.

dataprofilebio
stringnullable

Public bio/description text when the page provides one.

dataprofileavatarUrl
stringnullable

Best available avatar image URL; null when only a blank placeholder is shown.

min 1 chars

dataprofileprofileUrl
string

Canonical public profile URL on the owning platform.

min 1 chars

dataprofileverified
boolean

Whether the platform marks the profile as verified.

Primary page links; empty when not found.

datalinks[]id
stringnullable

Stable link id from the platform when available.

datalinks[]title
stringnullable

Link title shown on the page.

datalinks[]url
string

Destination URL.

min 1 chars

datalinks[]type
stringnullable

Platform link type when available (e.g. CLASSIC, SPOTIFY_ALBUM).

datalinks[]thumbnailUrl
stringnullable

Optional thumbnail image URL for the link.

min 1 chars

datalinks[]position
integernullable

Zero-based display order when the platform provides it.

≥ 0

Social/contact entries; empty when not found.

datasocials[]platform
string

Normalized social platform slug (e.g. instagram, tiktok, email).

min 1 chars

datasocials[]url
string

Social profile or contact destination.

min 1 chars

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/linktree/profiles/miguelangeles" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Linktree profile lookup result.