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

---

# Komi Page API

One public Komi page with the creator's identity, socials and every block the page shows.

`GET /v1/komi/profiles/{handle}` takes the page's subdomain, for example `kimkardashian` for kimkardashian.komi.io. A leading `@` or the full page URL is accepted, and the handle is lowercased.

On `found`, `data.profile` carries `handle`, `displayName`, `firstName`, `lastName`, `bio`, `avatarUrl`, `profileUrl`, `websiteUrl`, `fanClubName`, `fanClubBenefits`, `hasBooking`, `isActive` (false when Komi reports the account as anything but active) and the page `id`. `data.socials` holds the header icons. `data.links` holds the links, each with `id`, `title`, `url`, `type`, `thumbnailUrl`, `position`, `section` and `group`.

`data.sections` lists the page's visible blocks in order with `type`, `title`, `group` and `itemCount`. The items are in `data.products`, `data.videos`, `data.music`, `data.podcasts`, `data.events` and `data.texts`, each row with its position and the block it sits in. A handle with no page returns HTTP 200 with `lookupStatus: "not_found"`, `profile: null` and empty lists.

## Request

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

## FAQ

### Which handle format should I send?

The page's subdomain, for example kimkardashian. Letters, numbers and hyphens, 2 to 63 characters. A leading @ or the full page URL is accepted.

### What is in data.sections?

Every visible block on the page in display order: its type (LINK, PRODUCT, MUSIC, YOUTUBE_VIDEO, PODCAST, EVENTS, TEXT, a sign-up form and so on), its heading, the group it sits in, and how many visible items it has. Use it to rebuild the page layout.

### What does a music row carry?

Title, kind (TRACK or ALBUM), artists, album, release year, cover art, an audio preview when the page has one, ISRC and UPC, and the streaming links with a lowercase platform such as spotify or apple_music.

### 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 page 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.
