Komi

Get Komi page

Get a Komi creator page: name, avatar, social icons, links, products, videos, music, podcasts, events and text blocks, in page order.

GET/v1/komi/profiles/{handle}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

Komi handle, the page's subdomain, e.g. `kimkardashian` for kimkardashian.komi.io. A leading @ or the full page URL is accepted.

min 1 chars · max 200 chars

Response fields
142

Endpoint-specific response payload.

datalookupStatus
string

Whether the public link-in-bio page was found.

one of: found, not_found

The page when found; null when not.

dataprofileplatform
string

Platform id.

one of: komi

dataprofilehandle
string

Canonical public username/handle without a leading @.

min 1 chars

dataprofiledisplayName
stringnullable

Public display title of the profile.

dataprofilebio
stringnullable

Public bio or description text, when the profile has one.

dataprofileavatarUrl
stringnullable

Best available avatar image URL; null when the profile has only a blank placeholder.

min 1 chars

dataprofileprofileUrl
string

The public page URL, `https://{handle}.komi.io/`.

min 1 chars

dataprofileverified
boolean

Always false: Komi pages carry no verified mark.

dataprofileid
string

Komi page id.

min 1 chars

dataprofileuserId
stringnullable

Komi's numeric account id, as a string.

dataprofilefirstName
stringnullable

First name, when given.

dataprofilelastName
stringnullable

Last name, when given.

dataprofilewebsiteUrl
stringnullable

Website the page links in its header, when any.

min 1 chars

dataprofilefanClubName
stringnullable

Fan club name, when the page has one.

dataprofilefanClubBenefits
stringnullable

Fan club benefits text, when the page has one.

dataprofilehasBooking
booleannullable

Whether the page offers bookings.

dataprofileisActive
booleannullable

Whether Komi reports the account as active. False for any other account status Komi reports; null when it gives none.

Links on the page, in display order.

datalinks[]id
stringnullable

Stable link id from the platform when available.

datalinks[]title
stringnullable

Link title as displayed on the profile.

datalinks[]url
string

Destination URL.

min 1 chars

datalinks[]type
stringnullable

Platform link type when available (e.g. CLASSIC, SPOTIFY_ALBUM).

datalinks[]thumbnailUrl
stringnullable

Optional thumbnail image URL for the link.

min 1 chars

datalinks[]position
integer

Zero-based display order within this list.

≥ 0

The page block this item is shown in.

datalinks[]sectionid
string

Block id.

min 1 chars

datalinks[]sectiontitle
stringnullable

Heading shown above the block, when the page shows one.

The group heading the block sits under, when it is in a group.

datalinks[]groupid
string

Block id.

min 1 chars

datalinks[]grouptitle
stringnullable

Heading shown above the block, when the page shows one.

Social icons in the page header.

datasocials[]platform
string

Normalized social platform slug (e.g. instagram, tiktok, email).

min 1 chars

datasocials[]url
string

Social profile or contact destination.

min 1 chars

The page's visible blocks in display order, including blocks with no items here (sign-up forms, ticket widgets).

datasections[]id
string

Block id.

min 1 chars

datasections[]type
string

Block type as the page names it, e.g. `LINK`, `PRODUCT`, `MUSIC`, `YOUTUBE_VIDEO`, `PODCAST`, `EVENTS`, `TEXT` or `DATA_CAPTURE_SIGNUP`.

min 1 chars

datasections[]title
stringnullable

Heading shown above the block, when the page shows one.

datasections[]position
integer

Zero-based display order within this list.

≥ 0

The group heading the block sits under, when it is in a group.

datasections[]groupid
string

Block id.

min 1 chars

datasections[]grouptitle
stringnullable

Heading shown above the block, when the page shows one.

datasections[]itemCount
integer

Visible items in the block.

≥ 0

Products on the page.

dataproducts[]id
stringnullable

Product id.

dataproducts[]title
stringnullable

Product name.

dataproducts[]url
string

Product page URL.

min 1 chars

dataproducts[]price
numbernullable

Price shown, when any.

dataproducts[]currency
stringnullable

ISO 4217 currency of the price, e.g. `USD`.

dataproducts[]thumbnailUrl
stringnullable

Product image URL.

min 1 chars

dataproducts[]position
integer

Zero-based display order within this list.

≥ 0

The page block this item is shown in.

dataproducts[]sectionid
string

Block id.

min 1 chars

dataproducts[]sectiontitle
stringnullable

Heading shown above the block, when the page shows one.

The group heading the block sits under, when it is in a group.

dataproducts[]groupid
string

Block id.

min 1 chars

dataproducts[]grouptitle
stringnullable

Heading shown above the block, when the page shows one.

YouTube and TikTok videos on the page.

datavideos[]id
stringnullable

Item id.

datavideos[]platform
string

Where the video is hosted.

one of: youtube, tiktok

datavideos[]url
string

Video URL.

min 1 chars

datavideos[]title
stringnullable

Video title, when known.

datavideos[]thumbnailUrl
stringnullable

Video thumbnail URL, when known.

min 1 chars

datavideos[]authorName
stringnullable

Channel or author name, when known.

datavideos[]position
integer

Zero-based display order within this list.

≥ 0

The page block this item is shown in.

datavideos[]sectionid
string

Block id.

min 1 chars

datavideos[]sectiontitle
stringnullable

Heading shown above the block, when the page shows one.

The group heading the block sits under, when it is in a group.

datavideos[]groupid
string

Block id.

min 1 chars

datavideos[]grouptitle
stringnullable

Heading shown above the block, when the page shows one.

Music releases on the page.

datamusic[]id
stringnullable

Item id.

datamusic[]title
stringnullable

Track or album name.

datamusic[]kind
stringnullable

Release type as the page names it, e.g. `TRACK`, `ALBUM`.

Artist names, in billing order.

datamusic[]artists[]
stringoptional
datamusic[]albumName
stringnullable

Album name, when known.

datamusic[]releaseYear
integernullable

Release year, when known.

datamusic[]imageUrl
stringnullable

Cover art URL, when known.

min 1 chars

datamusic[]previewUrl
stringnullable

Audio preview URL, when the page has one.

min 1 chars

datamusic[]isrc
stringnullable

ISRC code, when known.

datamusic[]upc
stringnullable

UPC code, when known.

Where to listen, in the page's order.

datamusic[]links[]platform
string

Service, lowercase, e.g. `spotify`, `apple_music`.

min 1 chars

datamusic[]links[]url
string

Link to the release on it.

min 1 chars

datamusic[]position
integer

Zero-based display order within this list.

≥ 0

The page block this item is shown in.

datamusic[]sectionid
string

Block id.

min 1 chars

datamusic[]sectiontitle
stringnullable

Heading shown above the block, when the page shows one.

The group heading the block sits under, when it is in a group.

datamusic[]groupid
string

Block id.

min 1 chars

datamusic[]grouptitle
stringnullable

Heading shown above the block, when the page shows one.

Podcasts and episodes on the page.

datapodcasts[]id
stringnullable

Item id, when the page has one.

datapodcasts[]title
stringnullable

Episode or show title.

datapodcasts[]show
stringnullable

Show name, when the item is an episode.

datapodcasts[]publisher
stringnullable

Publisher or author.

datapodcasts[]imageUrl
stringnullable

Artwork URL, when known.

min 1 chars

datapodcasts[]previewUrl
stringnullable

Audio preview URL, when the page has one.

min 1 chars

Where to listen, in the page's order.

datapodcasts[]links[]platform
string

Service, lowercase, e.g. `spotify`, `apple_music`.

min 1 chars

datapodcasts[]links[]url
string

Link to the release on it.

min 1 chars

datapodcasts[]position
integer

Zero-based display order within this list.

≥ 0

The page block this item is shown in.

datapodcasts[]sectionid
string

Block id.

min 1 chars

datapodcasts[]sectiontitle
stringnullable

Heading shown above the block, when the page shows one.

The group heading the block sits under, when it is in a group.

datapodcasts[]groupid
string

Block id.

min 1 chars

datapodcasts[]grouptitle
stringnullable

Heading shown above the block, when the page shows one.

Shows, games and events on the page.

dataevents[]id
stringnullable

Event id.

dataevents[]title
stringnullable

Event name as the page shows it.

dataevents[]startsAt
stringnullable

Start date and time as the page gives it (ISO 8601; a time without a zone is local to the venue).

dataevents[]venueName
stringnullable

Venue name, when known.

dataevents[]location
stringnullable

City or place, when known.

dataevents[]ticketUrl
stringnullable

Ticket or event page URL, when any.

min 1 chars

dataevents[]soldOut
booleannullable

Whether the page marks it sold out.

dataevents[]position
integer

Zero-based display order within this list.

≥ 0

The page block this item is shown in.

dataevents[]sectionid
string

Block id.

min 1 chars

dataevents[]sectiontitle
stringnullable

Heading shown above the block, when the page shows one.

The group heading the block sits under, when it is in a group.

dataevents[]groupid
string

Block id.

min 1 chars

dataevents[]grouptitle
stringnullable

Heading shown above the block, when the page shows one.

Text blocks on the page.

datatexts[]id
stringnullable

Item id.

datatexts[]content
string

The text, as plain text.

min 1 chars

datatexts[]position
integer

Zero-based display order within this list.

≥ 0

The page block this item is shown in.

datatexts[]sectionid
string

Block id.

min 1 chars

datatexts[]sectiontitle
stringnullable

Heading shown above the block, when the page shows one.

The group heading the block sits under, when it is in a group.

datatexts[]groupid
string

Block id.

min 1 chars

datatexts[]grouptitle
stringnullable

Heading shown above the block, when the page shows one.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/komi/profiles/kimkardashian" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Komi page.