# Komi (/docs/komi)

Read a Komi link-in-bio page. Display name, bio, avatar, and every outbound link with its title and destination

Komi is a link-in-bio service aimed at the higher end of the creator market, which shows in who uses it: pages tend to belong to talent with real commercial operations behind them.

Base URL: `/v1/komi/...`

  Komi puts the handle in a subdomain (`{handle}.komi.io`) rather than a path,
  so the `url` you pass looks like `https://kimkardashian.komi.io/`, not
  `https://komi.io/kimkardashian`.

## Quickstart

### 1. Read the page

```bash title="cURL"
curl "https://www.socialcrawl.dev/v1/komi/page?url=https://kimkardashian.komi.io/" \
  -H "x-api-key: YOUR_API_KEY"
```

### 2. Follow the links you found

The outbound social links turn one handle into the creator's full account set. Feed each handle into its platform's profile endpoint.

```bash title="cURL"
curl "https://www.socialcrawl.dev/v1/instagram/profile?handle=kimkardashian" \
  -H "x-api-key: YOUR_API_KEY"
```

## Read a page

| Endpoint            | Credits | What it returns                                                                      | Key parameters            |
| ------------------- | ------- | ------------------------------------------------------------------------------------ | ------------------------- |
| `GET /v1/komi/page` | 1       | Display name, bio, avatar, and every link on the page with its title and destination | `url` (the full page URL) |

The link list is the valuable part. It is a creator's own declaration of where their audience should go next, which usually includes the shops they sell through, the affiliate networks they run, the newsletter they own, and the social accounts they actually maintain rather than the ones they merely registered.

Two ways that is used in practice. For **creator vetting**, the destinations reveal commercial relationships that a profile bio does not: an affiliate subdomain or a brand-specific landing page is a disclosed partnership. For **cross-platform resolution**, the outbound social links turn one handle into the creator's full account set.

## All endpoints

## Platform notes

- **Destinations are as-published, not resolved.** A link that points at a shortener or a tracking redirect comes back as that URL. Follow it yourself if you need the final destination, and expect UTM parameters to survive.
- **One page per call, and no discovery.** There is no way to search Komi pages or list a creator's page from their social handle. You need the page URL. It usually comes from a social profile's bio link (`author.ext.bio_link` where a platform exposes one) or from the bio text itself.
- **Each link-in-bio service has its own endpoint.** [Linktree](/docs/linktree.md), [lnk.bio](/docs/linkbio.md), [Linkme](/docs/linkme.md) and [Pillar](/docs/pillar.md) are separate paths that return the same shape, so one parser handles all of them. Only the base path changes.
- A page with no links returns an empty link list rather than an error.
- The `url` must be the public page URL, including the scheme.

## Next steps

- [Author schema](/docs/schema/author.md): The unified shape a resolved handle comes back in.
- [Prism creator card](/docs/prism.md): One handle to profiles across several networks in a single call.
- [Credits](/docs/credits.md): How billing, caching, and refunds work.