Linkme hub

Linkme Profile API

One public Linkme profile with its identity, followers, featured links, socials and gallery.

GET /v1/linkme/profiles/{handle}

1 credit Failed requests are free

About this endpoint

GET /v1/linkme/profiles/{handle} takes the path after link.me/, for example danucd. A leading @ or the profile URL is accepted, and the handle is lowercased.

On found, data.profile carries handle, displayName, firstName, lastName, bio, avatarUrl, profileUrl, verified, followers, profileViews, private, adult, customDomainUrl, createdAt and updatedAt. data.links holds the featured links, each with id, title, description, url, type, thumbnailUrl, position and group; data.linksTotal is the number of links, counted as in data.links, and is null when data.linksTruncated is true because the list may be incomplete. data.socials, data.gallery and data.sections hold the icons, photos and section order. A handle with no profile returns HTTP 200 with lookupStatus: "not_found", profile: null and empty lists.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Linkme Profile API FAQ

Which handle format should I send?

The path after link.me/, for example danucd. A leading @ or the profile URL is accepted, and the handle is lowercased.

How are headings and carousels returned?

A heading is not a link: the links after it carry it as their group. A carousel's links are returned in its place, each with the carousel as its group.

How does not_found look?

HTTP 200 with data.lookupStatus not_found, data.profile null and every list empty. Branch on lookupStatus, not on the HTTP status.

How many credits does a profile lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.