How to Scrape Linktree with Node.js: Profiles, Links, Socials, and a Link-Change Tracker (2026)

path status bytes notes /robots.txt 200 named bots allowed, "*" disallowed /tonyhawk 200 313,189 full profile in __NEXT_DATA__ /TonyHawk 200 usernames are case-insensitive /billieeilish 200 322,229 6 links, 6 social icons /spotify 200 241,608 6 playlist links /linktree 200 86,219 one "forwarding" link /thisusernamedoesnotexist12345 404 12,448 page is "/_error" /_next/data/<buildId>/tonyhawk.json 404 the Next.js JSON route is not exposed 

pageProps.account id, uuid, username, pageTitle, description, profilePictureUrl, profileBadges, verticals, timezone, tier, createdAt, updatedAt, ... pageProps.links [{ id, type, title, url, position, parent, children, rules, modifiers, metaData, ... }] pageProps.socialLinks [{ type, url, position }] pageProps.isProfileVerified, hasSensitiveContent, hasPagePassword, pageLockType, contentGating 

// linktree.mjs - a small Linktree profile reader + link-change tracker in Node.js. // Node 22.5+ (uses the built-in node:sqlite), no npm dependencies. // Read Linktree's terms first: they prohibit automated collection from profiles. import { DatabaseSync } from "node:sqlite"; const BASE = "https://linktr.ee"; const UA = process.env.LT_UA ?? "linktree-research-script/1.0 (+mailto:you@example.com)"; const MIN_DELAY_MS = 4000; // one profile every ~4 s, at most // ---------- Step 1: a polite fetch helper ---------- let last = 0; const sleep = (ms) => new Promise((r) => setTimeout(r, ms)); async function get(url) { const wait = last + MIN_DELAY_MS - Date.now(); if (wait > 0) await sleep(wait); last = Date.now(); const res = await fetch(url, { headers: { "user-agent": UA, accept: "text/html" }, redirect: "follow" }); if (res.status === 404) return null; // no such profile (or it was deleted) if (res.status === 429 || res.status === 403) { throw new Error(`${res.status} from ${url}: you are being limited. Stop and try again much later.`); } if (!res.ok) throw new Error(`${res.status} from ${url}`); return res.text(); } 

// ---------- Step 2: pull the Next.js page data out of the HTML ---------- function nextData(html) { const m = html.match(/<script id="__NEXT_DATA__" type="application\/json"[^>]*>([\s\S]*?)<\/script>/); if (!m) throw new Error("no __NEXT_DATA__ script: the page shape changed"); return JSON.parse(m[1]); } const iso = (ms) => (typeof ms === "number" ? new Date(ms).toISOString() : null); // Which gates are switched on for a link (age, passcode, sensitive-content, ...). function gates(link) { const g = link.rules?.gate ?? {}; const on = Object.entries(g) .filter(([k, v]) => k !== "activeOrder" && k !== "sensitiveContent" && v) .map(([k]) => k); if (g.sensitiveContent?.domain) on.push("sensitiveContent"); return on; } function normLink(l, parentId = null) { return { id: String(l.id), type: l.type, // CLASSIC, YOUTUBE_VIDEO, PRODUCT, EXTENSION, ... title: (l.title ?? "").replace(/\s+/g, " ").trim(), url: l.url || null, // empty for app-style links (PRODUCT, EXTENSION, ...) position: l.position, parentId: l.parent?.id ? String(l.parent.id) : parentId, forwarding: Boolean(l.modifiers?.isForwardingActive), gated: gates(l), locked: Boolean(l.locked), }; } 

// ---------- Step 3: one profile -> one clean object ---------- export async function profile(username) { const html = await get(`${BASE}/${encodeURIComponent(username)}`); if (!html) return null; const data = nextData(html); if (data.page !== "/[profile]") return null; // e.g. "/_error" const p = data.props?.pageProps; const a = p?.account; if (!a || !Array.isArray(p.links)) throw new Error("profile JSON without account/links: the shape changed"); const links = []; for (const l of p.links) { links.push(normLink(l)); for (const c of l.children ?? []) links.push(normLink(c, String(l.id))); // grouped links } return { username: a.username, id: a.id, url: `${BASE}/${a.username}`, displayName: a.pageTitle ?? null, bio: a.description ?? null, verified: Boolean(p.isProfileVerified), badges: a.profileBadges ?? [], verticals: a.verticals ?? [], timezone: a.timezone ?? null, tier: a.tier ?? null, createdAt: iso(a.createdAt), updatedAt: iso(a.updatedAt), sensitive: Boolean(p.hasSensitiveContent), pageLocked: Boolean(p.hasPagePassword || p.pageLockType), socials: (p.socialLinks ?? []).map((s) => ({ type: s.type, url: s.url })), links, fetchedAt: new Date().toISOString(), }; } 

{ "username": "tonyhawk", "id": 8900221, "url": "https://linktr.ee/tonyhawk", "displayName": "@tonyhawk", "bio": null, "verified": true, "badges": ["VERIFIED_AND_NOTABLE_TICK"], "verticals": [], "timezone": "America/Los_Angeles", "tier": "pro", "createdAt": "2020-09-22T17:15:38.000Z", "updatedAt": "2026-09-13T06:54:58.000Z", "sensitive": false, "pageLocked": false, "socials": [], "links": [ { "id": "582852123", "type": "CLASSIC", "title": "Order “Nearshore” by Steve Hawk here", "url": "https://stevehawkauthor.com", "position": 0, "parentId": null, "forwarding": false, "gated": [], "locked": false }, { "id": "449921776", "type": "YOUTUBE_VIDEO", "title": "My final video", "url": "https://youtu.be/KgyW24ONcUI?si=3NPP0immuN4fTTU2", "position": 3, "parentId": null, "forwarding": false, "gated": [], "locked": false } ] } 

socials: INSTAGRAM https://instagram.com/billieeilish TIKTOK https://tiktok.com/@billieeilish SPOTIFY https://open.spotify.com/artist/6qqNVTkY8uBg9cP3Jd7DAH YOUTUBE https://www.youtube.com/billieeilish APPLE_MUSIC https://music.apple.com/us/artist/billie-eilish/1065981054 X https://x.com/billieeilish links: CLASSIC WATCH HIT ME HARD AND SOFT: THE TOUR AT HOME http://billieeilish.lnk.to/ondemand YOUTUBE_VIDEO WATCH THE HIT ME HARD AND SOFT: THE TOUR ... https://www.youtube.com/watch?v=WY1zGdMyWZQ CLASSIC LISTEN TO HIT ME HARD AND SOFT https://billieeilish.lnk.to/HITMEHARDANDSOFT CLASSIC SHOP EILISH FRAGRANCES https://billieeilish.lnk.to/shopfragrance PRODUCT SHOP MERCH (no url) EXTENSION SIGN UP FOR BILLIE'S MAILING LIST (no url) 

// ---------- Step 4: snapshots in SQLite ---------- export function openDb(file = "linktree.db") { const db = new DatabaseSync(file); db.exec(` CREATE TABLE IF NOT EXISTS snapshots ( id INTEGER PRIMARY KEY, username TEXT NOT NULL, fetched_at TEXT NOT NULL, display_name TEXT, bio TEXT, verified INTEGER, n_links INTEGER, n_socials INTEGER); CREATE TABLE IF NOT EXISTS items ( snapshot_id INTEGER NOT NULL REFERENCES snapshots(id), kind TEXT NOT NULL, -- 'link' | 'social' key TEXT NOT NULL, type TEXT, title TEXT, url TEXT, position INTEGER); CREATE INDEX IF NOT EXISTS items_snap ON items(snapshot_id);`); return db; } function save(db, p) { const { lastInsertRowid: sid } = db .prepare(`INSERT INTO snapshots (username, fetched_at, display_name, bio, verified, n_links, n_socials) VALUES (?, ?, ?, ?, ?, ?, ?)`) .run(p.username.toLowerCase(), p.fetchedAt, p.displayName, p.bio, p.verified ? 1 : 0, p.links.length, p.socials.length); const ins = db.prepare(`INSERT INTO items VALUES (?, ?, ?, ?, ?, ?, ?)`); for (const l of p.links) ins.run(sid, "link", l.id, l.type, l.title, l.url, l.position); for (const s of p.socials) ins.run(sid, "social", s.type, s.type, null, s.url, null); return Number(sid); } function items(db, sid) { const rows = db.prepare(`SELECT kind, key, type, title, url FROM items WHERE snapshot_id = ?`).all(sid); return new Map(rows.map((r) => [`${r.kind}:${r.key}`, r])); } // Compare the two newest snapshots of a profile. export function diff(db, username) { const [now, prev] = db .prepare(`SELECT id, fetched_at FROM snapshots WHERE username = ? ORDER BY id DESC LIMIT 2`) .all(username.toLowerCase()); if (!prev) return null; const a = items(db, prev.id), b = items(db, now.id); const changes = []; for (const [k, r] of b) { const o = a.get(k); if (!o) changes.push({ change: "added", kind: r.kind, title: r.title ?? r.type, url: r.url }); else if (o.url !== r.url) changes.push({ change: "url", kind: r.kind, title: r.title ?? r.type, from: o.url, to: r.url }); else if (o.title !== r.title) changes.pushSource：https://dev.to/viktorhendelmann/how-to-scrape-linktree-with-nodejs-profiles-links-socials-and-a-link-change-tracker-2026-2i82
My favorites