Lnk.Bio

Get Lnk.Bio profile

Get a Lnk.Bio profile's identity, bio, avatar, social icons, page tabs and main-page links.

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

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

lnk.bio handle, case preserved, e.g. `sportsillustrated`, `Curate.in`, `S&S` or `@brastel.thai`. A percent-encoded handle is accepted in the public path.

min 2 chars · max 128 chars · pattern: ^[A-Za-z0-9._&+*@/-]+$

Response fields
48

Endpoint-specific response payload.

datalookupStatus
string

Whether the public lnk.bio page was found.

one of: found, not_found

Profile when found; null when not.

dataprofileplatform
string

Platform id.

one of: lnk-bio

dataprofilehandle
string

Canonical handle, with the case the profile uses.

min 1 chars

dataprofiledisplayName
stringnullable

Public display title of the profile.

dataprofilebio
stringnullable

Public bio or description text, when the profile has one.

dataprofileavatarUrl
stringnullable

Best available avatar image URL; null when the profile has only a blank placeholder.

min 1 chars

dataprofileprofileUrl
string

The public lnk.bio profile URL; a custom domain is in `customDomainUrl`.

min 1 chars

dataprofileverified
boolean

Whether the platform marks the profile as verified.

dataprofileid
stringnullable

Numeric profile id; may be negative.

dataprofileconnectedUsername
stringnullable

The connected Instagram or TikTok style name, when the profile has one.

dataprofiletimezone
stringnullable

IANA time zone, when known.

dataprofilecustomDomainUrl
stringnullable

The profile's custom domain, when it is served from one and it is not lnk.bio.

min 1 chars

dataprofileshareImageUrl
stringnullable

Social share image URL, when valid.

min 1 chars

dataprofilewelcomePlaceholder
boolean

True when the profile shows Lnk.Bio's `Welcome to Lnk.Bio` placeholder instead of content.

The page tabs the profile carries, in document order.

dataprofilepages[]id
string

Page block id, e.g. `PAGE_LNKS`.

min 1 chars

dataprofilepages[]title
stringnullable

Title when the page provides one.

dataprofilepages[]heading
stringnullable

Heading shown on an extra page tab, when it has one.

dataprofilepages[]text
stringnullable

Descriptive text shown on an extra page tab, when it has some.

Links on the profile's main page, in display order.

datalinks[]id
stringnullable

Stable link id from the platform when available.

datalinks[]title
stringnullable

Link title as displayed on the profile.

datalinks[]url
stringnullable

Destination URL; null for a block link such as a contact form.

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 position in the profile's link list when known; on search, null for links not in the profile's first 48.

≥ 0

The group heading shown above this link, when any.

datalinks[]groupid
string

Group id; `u` is ungrouped.

min 1 chars

datalinks[]grouptitle
stringnullable

Heading printed before the group, when the page has one.

datalinks[]badge
stringnullable

Badge text shown on the link box, e.g. `TOP`.

datalinks[]blockType
stringnullable

Block type when the link opens a block instead of a URL, e.g. `form`.

Social icons.

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

datasocials[]title
stringnullable

Icon title on the profile, e.g. `Instagram`.

datasocials[]networkCode
string

Lnk.Bio's own code for the icon, for example `SOCIAL_IG`.

min 1 chars

datalinksTotal
integernullable

Total number of links when known, otherwise null; list the links for the full count.

≥ 0

datalinksTruncated
boolean

True when the links list may be incomplete; call the links route for the full list.

Embed blocks printed on the main page.

dataembeds[]provider
string

Provider inferred from the embed host, e.g. `youtube`.

min 1 chars

dataembeds[]url
string

The iframe source URL.

min 1 chars

dataembeds[]title
stringnullable

Heading printed before the embed, when the page has one.

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

Code example

curl "https://api.socialfetch.dev/v1/lnk-bio/profiles/sportsillustrated" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Profile.