Linktree Profile API
Get a public Linktree page by URL: title, bio, picture, contact email, linked social accounts, and every link card with its destination.
Pricing and providers
Linktree Profile API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get Linktree profile in one request
{
"data": {
"avatarUrl": "https://example.com/image.jpg",
"description": "A short example description of this item.",
"email": "alex@example.com",
"facebook": "example",
"id": "a1b2c3d4",
"instagram": "example",
"links": [
{
"id": "a1b2c3d4",
"locked": true,
"thumbnailUrl": "https://example.com/image.jpg",
"title": "Example title",
"type": "general",
"url": "https://example.com/page"
}
],
"spotify": "example",
"tiktok": "example",
"timezone": "2024-01-15T09:30:00Z",
"title": "Example title",
"username": "alex_rivera",
"verticals": [
"example"
],
"x": "example",
"youtube": "example"
},
"found": true,
"reason": "not_found"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-19 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- urlstring
https://linktr.ee/mkbhd
The Linktree profile URL, e.g. https://linktr.ee/mkbhd.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `title`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a page that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Response
JSON, one example value per field.
The Linktree page record, or null when nothing was found.
- avatarUrlstring
Profile picture URL; null when none is set. Populated whenever the provider has data for the entity.
- descriptionstring
The page's bio as plain text; null when none is set.
- emailstring
Contact email listed on the page; null when none is listed.
- facebookstring
Facebook page URL listed in the page's social icons; null when none.
- idstring
Linktree account id.
- instagramstring
Instagram profile URL listed in the page's social icons; null when none.
- spotifystring
Spotify artist or show URL listed in the page's social icons; null when none.
- tiktokstring
TikTok profile URL listed in the page's social icons; null when none.
- timezonestring
The account's timezone as the page reports it, e.g. America/New_York.
- titlestringcan require
The page's title; the username when none is set. Null when this source does not report it.
- usernamestring
The page's Linktree username. Populated whenever the provider has data for the entity.
- verticalsstring[]
Creator categories picked on Linktree, e.g. Creator or Music.
- xstring
X (Twitter) profile URL listed in the page's social icons; null when none.
- youtubestring
YouTube channel URL listed in the page's social icons; null when none.
The page's link cards in page order. Headers and group cards have no url. Populated whenever the provider has data for the entity.
- idstring
Link card id. Populated whenever the provider has data for the entity.
- lockedbooleancan require
True when Linktree locks the card and withholds its destination. Null when this source does not report it.
- thumbnailUrlstringcan require
Card thumbnail URL; null when none is set or when this source does not report it.
- titlestringcan require
Card title; null when none is set.
- typestring
Linktree card type, e.g. CLASSIC, HEADER, GROUP or YOUTUBE_VIDEO. Populated whenever the provider has data for the entity.
- urlstring
Where the card links to; null for headers, groups and locked cards. Populated whenever the provider has data for the entity.
- foundboolean
True when the Linktree page was found; false when no public page exists at this URL.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Linktree Profile API
The AnyAPI Linktree Profile API returns Linktree profile data as normalized JSON from one POST call to /v1/run/linktree.profile. Get a public Linktree page by URL: title, bio, picture, contact email, linked social accounts, and every link card with its destination. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $1.10 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Linktree profile calls through AnyAPI succeeded, with a median response time of 0.6 seconds across 1 measured calls.