Linktree · Guide

How to get Linktree page

TL;DR

To get Linktree page, sign up for a free Captapi key, then send one GET request to /v1/linktree/page with your input. You get clean JSON back in seconds for 1 credit per call — no OAuth, scraping or platform SDKs. Link-in-bio → creator graph: typed links, socialAccounts{} that feed TikTok/Instagram/Spotify/SoundCloud, email, verticals. Flat 1 credit.

Get your free API key API reference

How to get Linktree page (step by step)

1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
2
Call the Linktree Page API
Send an authenticated GET request to /v1/linktree/page with your input. No OAuth, no scraping setup.
3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/linktree/page?url=https%3A%2F%2Flinktr.ee%2Fmiguelangeles" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "linktree",
    "url": "https://linktr.ee/miguelangeles",
    "id": 15278008,
    "username": "miguelangeles",
    "name": "MIGUEL ANGELES",
    "description": "☆☆☆☆ IRL ANGEL ☆☆☆☆\nψ EMBRACE CHAOS ψ",
    "avatar": "https://ugc.production.linktr.ee/d3141538-f586-4f3f-bc9a-a82fbebab798_DEATHRATTLE-slowed-COVER.jpeg",
    "verified": false,
    "verticals": [
      "music",
      "creative"
    ],
    "linkPlatforms": [
      "TikTok",
      "Instagram"
    ],
    "timezone": "America/New_York",
    "email": "miguel@irlangel.com",
    "linkCount": 8,
    "links": [
      {
        "title": "new project \"BEFORE THE SUN RISES & WINTERR ENDS\"",
        "type": "SPOTIFY_ALBUM",
        "id": "463416775",
        "url": "https://open.spotify.com/album/0pgrg7phBbnwGJ2HBEl9EG?si=Zub7J4I3RySAaM9WVX3Okg",
        "thumbnail": "https://ugc.production.linktr.ee/8ed131c7-6d74-47fc-bceb-8be7f6bae4c8_ab67616d0000b2739bd93cc6e406b820dfff691f.jpeg"
      },
      {
        "title": "stream \"NOVEMBERR\"",
        "type": "SPOTIFY_SONG",
        "id": "460281204",
        "url": "https://open.spotify.com/track/62HnBMEdZjeFCd2T8g37T8?si=7bd35dd0e9f24d65",
        "thumbnail": "https://ugc.production.linktr.ee/3bd59146-cd44-4187-9601-4341b21070d2_ab67616d0000b2739ad10104c60fb9deff5b7f34.jpeg"
      }
    ],
    "socials": [
      {
        "type": "INSTAGRAM",
        "url": "https://instagram.com/miguelangeles"
      },
      {
        "type": "TIKTOK",
        "url": "https://tiktok.com/@irlangel"
      }
    ],
    "socialAccounts": {
      "instagram": "https://instagram.com/miguelangeles",
      "tiktok": "https://tiktok.com/@irlangel",
      "spotify": "https://open.spotify.com/artist/14xRX3JR8H4RWh8R7V3fvZ?si=EgRxWIPiRcaEHtSnqk5PAQ",
      "youtube": "https://www.youtube.com/watch?v=xiFUzOJaiC4",
      "soundcloud": "https://soundcloud.com/miguelangeles",
      "appleMusic": "https://music.apple.com/ca/artist/miguel-angeles/1209423162"
    }
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

Name	Type	Required	Description
url	string	Yes	Linktree profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
cache	boolean	No	Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits.
cacheMaxAge	string	No	Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL (SC cache_max_age). Envelope: cached + cachedAt.

Frequently asked questions

What does the Linktree Page API do?

The Linktree Page API lets you fetch full metadata and key stats from a public Linktree page using one GET request to /v1/linktree/page. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Linktree Page API cost?

Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Linktree API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the Linktree Page API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to get Linktree page?

Start free with 100 credits — no credit card required.

Get your free API key