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

---

# Komi API. Creator pages as JSON.

Read a public Komi page by its handle: the creator's identity and socials, then every link, product, video, release, podcast and event the page shows, in order.

- Links + products + music
- Page order kept
- 1 credit per request

Social Fetch exposes one route under `/v1/komi`. `GET /v1/komi/profiles/{handle}` returns one public Komi page, the page at `{handle}.komi.io`. The handle is the page's subdomain, for example `kimkardashian`; a leading `@` or the full page URL also works, and the handle is lowercased.

`data.profile` carries the identity: `handle`, `displayName`, `firstName`, `lastName`, `bio`, `avatarUrl`, `websiteUrl`, the fan club name and benefits, and the page `id`. `data.socials` holds the header icons with a lowercase `platform` and a `url`. `data.links` uses the same link shape as the Linktree and Lnk.Bio routes, plus the block and group each link sits in.

Komi pages are built from blocks, and the response keeps them: `data.sections` lists every visible block in page order with its type, heading, group and item count, and the items are split by kind into `products` (title, URL, price, currency, image), `videos` (YouTube and TikTok), `music` (title, artists, album, release year, cover, ISRC, UPC and where to listen), `podcasts`, `events` (date, venue, location, tickets, sold out) and `texts`. Hidden blocks are left out, as the page leaves them out.

Every response uses the `{ data, meta }` envelope. A handle with no page comes back as HTTP 200 with `data.lookupStatus` set to `not_found`.

## What you can get

- Creator identity: display name, first and last name, bio, avatar, website, fan club name and benefits, and whether the page takes bookings.
- Social icons from the page header with a normalized platform slug, in the shared link-in-bio shape.
- Links with title, URL, thumbnail and position, plus the block and group heading each one sits under.
- Products with title, URL, price, currency and image; YouTube and TikTok videos with title and thumbnail.
- Music releases with artists, album, release year, cover art, preview, ISRC, UPC and every streaming link; podcasts and episodes with their services.
- Tour dates and events with start time, venue, location, ticket link and sold-out flag, and the page's text blocks.

## Komi endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Page | GET /v1/komi/profiles/{handle} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/komi/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 page route.** Send `GET /v1/komi/profiles/kimkardashian` with `x-api-key`. The handle is the part before `.komi.io`.
3. **Branch on lookupStatus.** Check `data.lookupStatus` before storing a row, then read the lists you need. `data.sections` gives the page layout if you want to rebuild it in order.

## Pricing

The Komi 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

Komi has no public API for reading another creator's page. Social Fetch returns the public page as typed JSON, in the same link-in-bio shape as its Linktree, Lnk.Bio and Stan Store routes, with Komi's products, music, videos, podcasts and events added.

## FAQ

### Is there a Komi API for creator pages?

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

### What handle do I send?

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

### Which parts of the page come back?

The identity and socials, then links, products, videos, music, podcasts, events and text blocks, each with its position and the block and group it sits in. data.sections lists every visible block in page order, including sign-up forms and ticket widgets that carry no items here.

### Are hidden blocks included?

No. Blocks and items the creator has hidden are left out, as the page leaves them out. A sign-up block is listed by type and heading only; what a visitor gets after signing up is never returned.

### How does a missing page look?

HTTP 200 with data.lookupStatus not_found, data.profile null and every list empty. HTTP status alone only means the request finished, so branch on lookupStatus.

### Does the response match the Linktree and Lnk.Bio routes?

The core does: lookupStatus, profile (platform, handle, displayName, bio, avatarUrl, profileUrl, verified), links (id, title, url, type, thumbnailUrl, position) and socials (platform, url) share one shape across the link-in-bio routes. Komi adds its own lists beside them.

### How much does the Komi 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 Komi 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

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