Linktree page API
A Linktree page: the creator's name, bio, avatar, every link in page order and the social accounts it points to.
100 free credits. No card needed.
linktr.ee/miguela...
Sent with the link
- Cost
- 1 credit
- Fields
- 10
- Cached
- 30 days
One link page a request
What you get in each link page
What you can build with it
Every account behind one handle. socials lists the accounts a Linktree points to, in order. The sample's leads to Instagram, Spotify and SoundCloud, so one handle opens a creator's whole footprint.
- https://instagram.com/miguelang...
- spotify
- https://open.spotify.com/artist...
- soundcloud
- https://soundcloud.com/miguelan...
What a creator sells, and for how much. Product and group links carry their type, thumbnail and price in extra.link_details. Read a roster's pages and you have a table of what each creator sells.
- spotify_album
- new project "BEFORE THE SUN...
- spotify_song
- stream "NOVEMBERR"
- youtube_video
- watch "INNOCENCE" video
The email they chose to show. A published email comes back in extra.emails with where it was found, so outreach starts from the address the creator put on the page.
- handle
- miguelangeles
- country
- CA
- link_count
- 7
- created_at
- 2021-05-12
From a key to JSON.
url (linktr.ee/miguelangeles).data.The request. GET /v1/linktree
curl -G "https://api.socialscrape.dev/v1/linktree" \ --data-urlencode "url=https://linktr.ee/miguelangeles" \ -H "x-api-key: $SOCIALSCRAPE_API_KEY"
import requests r = requests.get( "https://api.socialscrape.dev/v1/linktree", params={"url": "https://linktr.ee/miguelangeles"}, headers={"x-api-key": KEY}, ) link_page = r.json()["data"]
const url = new URL("https://api.socialscrape.dev/v1/linktree"); url.searchParams.set("url", "https://linktr.ee/miguelangeles"); const res = await fetch(url, { headers: { "x-api-key": KEY }, }); const { data } = await res.json();
The response. A sample, in the shape every call returns.
{
"ok": true,
"credits_charged": 1,
"data": {
"name": "MIGUEL ANGELES",
"handle": "miguelangeles",
"url": "https://linktr.ee/miguelangeles",
"bio": "☆☆☆☆ IRL ANGEL ☆☆☆☆ ψ EMBRACE...",
"avatar_url": "https://ugc.production.linktr.ee/...",
"links": [ ..., ..., ... ],
"socials": [ ..., ..., ... ]
}
}
Ask in plain words. Ask your agent for Linktree page in plain words, and the SocialScrape MCP server makes the call.
Get the page for linktr.ee/miguelangeles.
Here is the link page: "MIGUEL ANGELES".
One tool call
Linktree page, given the link.
Same price as the API
1 credit a call; a repeat within 30 days is free.
Runs on your machine
Your key stays in your agent's settings.
Pay only for data you get.
Failed requests and cached repeats are free.
1,000 credits
$13 one time
Get an API key- $13.00 per 1,000 credits
- Credits never expire
- No subscription
25,000 credits
$55 one time
Get an API key- $2.20 per 1,000 credits
- Credits never expire
- No subscription
230,000 credits
$349 one time
Get an API key- $1.52 per 1,000 credits
- Credits never expire
- No subscription
Questions, answered.
Common questions
Do I need the full Linktree URL?
No. Pass handle (miguelangeles) or the page url (https://linktr.ee/miguelangeles); both read the same page.
Does a Linktree page say where its creator is?
extra.country gives the country Linktree records for the page and extra.created_at the day it was made: CA and 12 May 2021 for the sample.
How many links does a Linktree page have?
extra.link_count gives the number, 7 for the sample, and links lists them in the order the page shows them.
What does it return?
Product and group links carry their type, thumbnail and price in extra.link_details; a published email is in extra.emails and socials. Pass the page url or just the handle. The link page has up to 10 fields, and the sample fills handle, url, name, bio, avatar_url, links and socials.
What do I send?
Send one of url or handle.
url: Linktree page URL.
handle: A username (with or without @) or a page URL (linktr.ee/<name>).
Which errors can it return?
invalid_params, unsupported_url and not_found. None is charged, and the errors list says which to retry.
Is there an SDK call for it?
client.linktree.get(...) in Python and client.linktree.get() in TypeScript.
Start pulling social data.
100 free credits. No card needed.