Linkme

Get Linkme profile

Get a Linkme profile: name, bio, avatar, follower total, featured links with headings and carousels, social and contact icons, gallery photos and section order.

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

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

Linkme handle, the profile path, e.g. `danucd` for link.me/danucd. A leading @ or the full profile URL is accepted.

min 1 chars · max 200 chars

Response fields
49

Endpoint-specific response payload.

datalookupStatus
string

Whether the public link-in-bio page was found.

one of: found, not_found

The profile when found; null when not.

dataprofileplatform
string

Platform id.

one of: linkme

dataprofilehandle
string

Canonical public username/handle without a leading @.

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 profile URL, `https://link.me/{handle}`.

min 1 chars

dataprofileverified
boolean

Whether the platform marks the profile as verified.

dataprofileid
string

Linkme profile id.

min 1 chars

dataprofilefirstName
stringnullable

First name, when given.

dataprofilelastName
stringnullable

Last name, when given.

dataprofilefollowers
integernullable

Total followers across the connected accounts, as the profile shows it.

≥ 0

dataprofileprofileViews
stringnullable

Profile view count as the profile shows it, e.g. `68k`.

dataprofileprivate
boolean

Whether the owner marked the profile private.

dataprofileadult
boolean

Whether the profile is marked for adults (age gate).

dataprofilecustomDomainUrl
stringnullable

The profile's own domain, when it has one.

min 1 chars

dataprofilecreatedAt
stringnullable

When the profile was created, as the site gives it (UTC).

dataprofileupdatedAt
stringnullable

When the profile last changed, as the site gives it (UTC).

Featured links in display order, with carousel links in place.

datalinks[]id
stringnullable

Stable link id from the platform when available.

datalinks[]title
stringnullable

Link title as displayed on the profile.

datalinks[]url
string

Destination URL.

min 1 chars

datalinks[]type
stringnullable

The service the link points at as the profile labels it, e.g. `youtube`, `spotify` or `link`.

datalinks[]thumbnailUrl
stringnullable

Optional thumbnail image URL for the link.

min 1 chars

datalinks[]position
integer

Zero-based display order.

≥ 0

datalinks[]description
stringnullable

Second line shown on the link, when any.

The heading or carousel this link sits under, when any.

datalinks[]groupid
string

Heading or carousel id.

min 1 chars

datalinks[]grouptitle
stringnullable

Heading text, when it has one.

datalinksTotal
integernullable

How many links the profile has, counted as in `links` (each carousel link counts). It equals the number of links returned when the response holds every link, and is null when it does not (`linksTruncated`).

≥ 0

datalinksTruncated
boolean

True when the links list may be incomplete: the profile has more featured entries than the first page the site sends.

Social, music and contact icons, in the profile's order.

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

Gallery photos, in order.

datagallery[]id
stringnullable

Image id.

datagallery[]url
string

Image URL.

min 1 chars

datagallery[]position
integer

Display order.

≥ 0

The sections the profile shows, in order.

datasections[]name
string

Section name as the profile names it, e.g. `web_links`, `bio`, `featured_links`, `gallery`, `contact_info` or `shop`.

min 1 chars

datasections[]position
integer

Display order.

≥ 0

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

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

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

Responses

Linkme profile.