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.
Example response
A 200 response. Live responses have the same shape with current data.
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.