Komi hub

Komi Page API

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

GET /v1/komi/profiles/{handle}

1 credit Failed requests are free

About this endpoint

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.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Komi Page API 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.