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

---

# Linkme Profile API

One public Linkme profile with its identity, followers, featured links, socials and gallery.

`GET /v1/linkme/profiles/{handle}` takes the path after `link.me/`, for example `danucd`. A leading `@` or the profile URL is accepted, and the handle is lowercased.

On `found`, `data.profile` carries `handle`, `displayName`, `firstName`, `lastName`, `bio`, `avatarUrl`, `profileUrl`, `verified`, `followers`, `profileViews`, `private`, `adult`, `customDomainUrl`, `createdAt` and `updatedAt`. `data.links` holds the featured links, each with `id`, `title`, `description`, `url`, `type`, `thumbnailUrl`, `position` and `group`; `data.linksTotal` is the number of links, counted as in `data.links`, and is null when `data.linksTruncated` is true because the list may be incomplete. `data.socials`, `data.gallery` and `data.sections` hold the icons, photos and section order. A handle with no profile returns HTTP 200 with `lookupStatus: "not_found"`, `profile: null` and empty lists.

## Request

- **Endpoint:** `GET /v1/linkme/profiles/{handle}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by handle
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/linkme/profiles/handle/get)
- **Platform page:** [/platforms/linkme](https://www.socialfetch.dev/platforms/linkme)

## FAQ

### Which handle format should I send?

The path after link.me/, for example danucd. A leading @ or the profile URL is accepted, and the handle is lowercased.

### How are headings and carousels returned?

A heading is not a link: the links after it carry it as their group. A carousel's links are returned in its place, each with the carousel as its group.

### How does not_found look?

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

### How many credits does a profile lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
