> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/linktree>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/linktree.mdx>

---

# Linktree scraper API. One link, every account.

Pull any public Linktree by handle: profile, every link and connected social accounts, as JSON in one request. One call finds someone's Instagram, TikTok and YouTube.

- Connected social accounts
- One call per profile

Link-in-bio pages list shop, newsletter, and secondary social links that TikTok and Instagram bios truncate. Social Fetch exposes one GET: public profile by handle. Pass the `linktr.ee/{handle}` username (with or without `@`) and read `{ data, meta }` with `data.lookupStatus`, links, socials, `meta.requestId`, and `meta.creditsCharged`.

Public profiles only. Missing handles return typed `not_found`. Use Linktree's product to edit a tree; use this route for enrichment beside social networks on one marketplace key.

## What you can get

- Public Linktree profile by handle — display name, bio, avatar, and presentation fields when present.
- Ordered public links with titles and destination URLs.
- Social account pointers listed on the tree when the page exposes them.
- `data.lookupStatus` of `found` or `not_found` so misses stay typed.
- Same Social Fetch API key and `{ data, meta }` envelope as the rest of the marketplace.

## Linktree endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Profile | GET /v1/linktree/profiles/{handle} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/linktree/profiles/handle/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits — enough to smoke-test several live Linktree handles before you wire batch jobs.
2. **Call the profile route.** Send `GET /v1/linktree/profiles/{handle}` with `x-api-key`. Pass the public username with or without `@`. Use the playground for one-offs; use the TypeScript SDK or curl in production.
3. **Join links to social rows.** Branch on `data.lookupStatus` before writing. Persist destinations and social pointers on the same person record as TikTok or Instagram handles. Log `meta.requestId`; bill from `meta.creditsCharged`.

## Pricing

The Linktree profile route charges 1 credit per successful completed lookup. Credits never expire on pay-as-you-go packs. Confirm every response with `meta.creditsCharged` — that field is the billing source of truth.

## Compared with the official API

Linktree's product and partner APIs are for creators editing trees and account management. Social Fetch is public-profile enrichment: handle in, JSON out, no Linktree login.

## FAQ

### Is there a Linktree scraper API / Linktree data API?

Yes. Social Fetch provides `GET /v1/linktree/profiles/{handle}` for public Linktree profiles. Authenticate with a Social Fetch API key (`x-api-key`). You do not need a Linktree creator login for these public lookups.

### What Linktree data does Social Fetch return?

On `lookupStatus: found`, the response includes profile presentation fields plus public links and social pointers when the page exposes them. Exact fields live under `/docs/api` and on this hub's endpoint page. Missing handles return `not_found`.

### What handle format does the route accept?

Pass the public Linktree username used on `linktr.ee/{handle}` — letters, numbers, dots, underscores, and hyphens — with or without a leading `@`. The API normalizes casing for the lookup.

### How much does the Linktree API cost?

You buy credit packs (or use the 100 free signup credits). The profile lookup costs 1 credit per successful completed request. Always check `meta.creditsCharged`. There is no required monthly subscription for pay-as-you-go packs.

### Can I access private or unpublished Linktree pages?

No. Only publicly visible profiles. Restricted or missing trees resolve through `data.lookupStatus` (for example `not_found`) rather than inventing empty link lists.

### Does HTTP 200 always mean the profile was found?

No. HTTP 200 means the request finished. Check `data.lookupStatus`: `found` means you got profile data; `not_found` means the handle did not resolve. Persist `meta.requestId` when you need to debug a miss.

### Can I use Linktree routes from agents or MCP?

Yes. The same operation appears as a typed MCP tool and can be reached via Ask (`POST /v1/ask`) for plain-English exploration. For production jobs, pin `GET /v1/linktree/profiles/{handle}` so routing stays explicit.

### Is scraping Linktree data legal?

Social Fetch returns publicly visible data. You are responsible for how you use it under Linktree's terms, applicable law, and your own compliance review. We do not give legal advice.

## Related

- [Linktree Profile API](https://www.socialfetch.dev/platforms/linktree/profiles-handle): Handle → profile, links, and socials (`GET /v1/linktree/profiles/{handle}`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Linktree question to the matching marketplace operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Linktree tools from Cursor or Claude with the same credit metering as REST.