Linktree Scraper scraper API

Scrape public Linktree profiles (bio, email, socials, links, tier) and browse or harvest the public profile directory…

Social & content 3 capabilities stable Streaming

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Get Directory Page


            linktree.directory.get

Fetch one page (up to 18 profiles) of the Linktree public profile directory, filtered by category

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"category":"all","page":1},"capability":"linktree.directory.get"}'

Input

Field	Type	Required	Description
`category`	string	optional	Directory category filter (defaults to "all")
`page`	integer	optional	1-indexed directory page number

Output

Field	Type	Required	Description
`current_page`	integer	required
`profiles`	array<object>	required
`profiles[].avatar_url`	string	optional
`profiles[].badges`	array<string>	optional
`profiles[].category_id`	string	optional
`profiles[].category_name`	string	optional
`profiles[].profile_title`	string	optional
`profiles[].profile_url`	string	optional
`profiles[].username`	string	required
`profiles[].verified`	boolean	optional	Directory verificationTick flag
`total_pages`	integer	required

Harvest Directory Profiles


            linktree.directory.profiles

Streaming

Harvest profiles across many directory pages in a single call. Sync mode collects all profiles; stream mode emits one profile per event

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"category":"business","max_pages":3},"capability":"linktree.directory.profiles"}'

Input

Field	Type	Required	Description
`category`	string	optional	Directory category filter (defaults to "all")
`max_pages`	integer	optional	Maximum directory pages to fetch (~18 profiles each); the walk also stops at the directory's reported total

Output

Field	Type	Required	Description
`pages_fetched`	integer	required	Number of directory pages actually fetched before completion
`profiles`	array<object>	required
`profiles[].avatar_url`	string	optional
`profiles[].badges`	array<string>	optional
`profiles[].category_id`	string	optional
`profiles[].category_name`	string	optional
`profiles[].profile_title`	string	optional
`profiles[].profile_url`	string	optional
`profiles[].username`	string	required
`profiles[].verified`	boolean	optional

Get Profile


            linktree.profile.get

Fetch a Linktree profile: display name, bio, email, country, tier, verification, social handles, and all content links

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"username":"nike"},"capability":"linktree.profile.get"}'

Input

Field	Type	Required	Description
`username`	string	required	Linktree handle or full profile URL (e.g. "nike" or "https://linktr.ee/nike")

Output

Field	Type	Required	Description
`avatar_url`	string	optional
`badges`	array<string>	optional
`bio`	string	optional
`country`	string	optional	ISO country code
`created_at`	string	optional	Account creation date (YYYY-MM-DD, UTC)
`display_name`	string	optional
`email`	string	optional
`link_platforms`	array<string>	optional
`links`	array<object>	optional	All navigable content links (header and group containers excluded)
`links[].title`	string	optional
`links[].type`	string	optional
`links[].url`	string	required
`links_count`	integer	required
`profile_url`	string	optional
`social_discord`	string	optional
`social_facebook`	string	optional
`social_instagram`	string	optional
`social_linkedin`	string	optional
`social_pinterest`	string	optional
`social_snapchat`	string	optional
`social_spotify`	string	optional
`social_telegram`	string	optional
`social_threads`	string	optional
`social_tiktok`	string	optional
`social_twitch`	string	optional
`social_whatsapp`	string	optional
`social_x`	string	optional	X (formerly Twitter) profile URL
`social_youtube`	string	optional
`tier`	string	optional	Account tier label (e.g. free, pro)
`timezone`	string	optional
`username`	string	required
`verified`	boolean	optional	True when the profile carries verification badges

Run Linktree Scraper in under a minute

Get an API key