> **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/linkme>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/linkme.mdx>

---

# Linkme API. Profiles as JSON.

Read a public Linkme profile by its handle: identity, follower total, every featured link in order, the social and contact icons and the photo gallery.

- Links + socials + followers
- Page order kept
- 1 credit per request

Social Fetch exposes one route under `/v1/linkme`. `GET /v1/linkme/profiles/{handle}` returns one public Linkme profile, the page at `link.me/{handle}`. Send the handle as it appears in the address, for example `danucd`; a leading `@` or the profile URL also works, and the handle is lowercased.

`data.profile` carries the identity: `handle`, `displayName`, `firstName`, `lastName`, `bio`, `avatarUrl`, `verified`, `followers` (the total across connected accounts, as the profile shows it), `profileViews`, `private`, `adult`, `customDomainUrl`, `createdAt` and `updatedAt`. `data.links` uses the same link shape as the Linktree, Lnk.Bio, Komi and Pillar routes, plus a `description` line and the `group` (a heading or a carousel) each link sits under. `data.linksTotal` is the number of links, counted as in `data.links`, and `data.linksTruncated` is true when the profile has more than the first page the site sends; `linksTotal` is then null.

`data.socials` holds the social, music and contact icons. `data.gallery` holds the gallery photos, and `data.sections` the sections the profile shows, in order. Every response uses the `{ data, meta }` envelope. A handle with no profile comes back as HTTP 200 with `data.lookupStatus` set to `not_found`.

## What you can get

- Identity: display name, first and last name, bio, avatar, verified flag, custom domain, created and updated times.
- Follower total across the connected accounts and the profile view count, as the profile shows them.
- Featured links with title, description, URL, thumbnail, service type and position, grouped under their heading or carousel.
- Social, music and contact icons with a normalized platform slug, in the shared link-in-bio shape.
- Gallery photos and the order of the profile's sections.
- Private and adult flags, so you can tell what the owner restricted.

## Linkme endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Profile | GET /v1/linkme/profiles/{handle} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/linkme/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.
2. **Call the profile route.** Send `GET /v1/linkme/profiles/danucd` with `x-api-key`. The handle is the path after `link.me/`.
3. **Branch on lookupStatus.** Check `data.lookupStatus` before storing a row, then read `data.links`, `data.socials` and `data.profile.followers`.

## Pricing

The Linkme route charges one credit per completed request, found or not found. `meta.creditsCharged` on every response is the billing source of truth. New accounts start with 100 free credits.

## Compared with the official API

Linkme has no public API for reading another person's profile. Social Fetch returns the public profile as typed JSON, in the same link-in-bio shape as its Linktree, Lnk.Bio, Komi, Pillar and Stan Store routes.

## FAQ

### Is there a Linkme API for profiles?

Yes. GET /v1/linkme/profiles/{handle} returns a public Linkme profile as JSON. Authenticate with your Social Fetch API key in x-api-key.

### What handle do I send?

The path after link.me/, for example danucd. Letters in any script, numbers, dots, underscores, hyphens and $, up to 64 characters. A leading @ or the profile URL is accepted, and the handle is lowercased.

### What is linksTotal?

The number of links the profile has, counted as in data.links: each link in a carousel counts, and headings are not links. When the response holds every link, linksTotal equals data.links.length. When the profile has more entries than the first page the site sends, linksTruncated is true and linksTotal is null.

### What does followers count?

The follower total the profile shows across the accounts the owner connected. It is null when the profile does not show one.

### How does a missing profile look?

HTTP 200 with data.lookupStatus not_found, data.profile null and every list empty. Branch on lookupStatus, not on the HTTP status.

### How much does the Linkme API cost?

One credit per completed request, found or not found. Check meta.creditsCharged on every response. New accounts get 100 free credits.

### Can I use the Linkme route from agents or MCP?

Yes. The route is a typed MCP tool and is reachable through Ask (POST /v1/ask) in plain English. Use the typed route for production jobs.

## Related

- [Linkme Profile API](https://www.socialfetch.dev/platforms/linkme/profiles-handle): A profile with its links, socials and followers (`GET /v1/linkme/profiles/{handle}`).
- [Komi API](https://www.socialfetch.dev/platforms/komi): The same link-in-bio shape for Komi creator pages.
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Linkme question to the matching operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call the Linkme tool from Cursor or Claude with the same credit metering as REST.
