Ko-fi

Get Ko-fi profile

Get a Ko-fi creator's public profile: identity, bio, links, support settings, goal and badges.

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

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

A creator's Ko-fi handle (e.g. `ligianunes`) or page id (e.g. `A644275F`). Case-insensitive.

min 1 chars · max 64 chars · pattern: ^[A-Za-z0-9_-]+$

Response fields
58

Endpoint-specific response payload.

datalookupStatus
string

Whether the requested entity exists.

one of: found, not_found

The profile when `lookupStatus` is `found`; otherwise null.

dataprofileid
string

Creator page id, e.g. `A644275F`.

dataprofilehandle
stringnullable

Canonical handle from the profile's canonical URL; null when not published.

dataprofilename
stringnullable

Display name.

dataprofileavatarUrl
stringnullable

Avatar image URL.

dataprofilecoverUrl
stringnullable

Cover image URL; null when the page has no cover.

dataprofileisGold
boolean

Whether the creator is a Ko-fi Gold member.

The follower/supporter count in the profile header; null when not shown.

dataprofilefollowerskind
string

Whether the header count names followers or supporters.

one of: followers, supporters

dataprofilefollowerscount
integernullable

Displayed count; null when Ko-fi shows only a label or a link.

≥ 0

dataprofilefollowersapproximate
boolean

True when Ko-fi rounds the count (e.g. `2.8M Followers`), so `count` is approximate.

dataprofilepageMode
stringnullable

Kind of page; null when the title does not say.

one of: tip, membership, shop, commissions, supporter, null

dataprofilebio
stringnullable

About text, with line breaks kept.

dataprofilewebsite
stringnullable

Website link from the About section.

Social links from the About section.

dataprofilesocials[]platform
stringnullable

Platform id, e.g. `INSTAGRAM`, `X`, `TUMBLR`; null for a custom link.

dataprofilesocials[]url
string

Link target.

dataprofilesocials[]label
stringnullable

Label the creator set for the link; null when none.

Tags on the creator's profile.

dataprofiletags[]
stringoptional

The creator's goal widget; null when the page has none.

dataprofilegoaltitle
stringnullable

Goal title.

dataprofilegoalpercent
numbernullable

Percent of the goal reached, as Ko-fi displays it. Ko-fi never publishes the amount.

≥ 0 · ≤ 100

dataprofilegoaldescription
stringnullable

Goal description as text.

Visible badges.

dataprofilebadges[]
stringoptional

A visible badge title, e.g. `Gold member`.

Commission widget summary; null when the page has no commission widget.

dataprofilecommissionsslotsText
stringnullable

The slots line, e.g. `1 slots left`.

dataprofilecommissionsslotsLeft
integernullable

The number in the creator's `N slots left` line; it is the creator's text, not a live availability check.

≥ 0

The embedded checkout/support model; null for a supporter account or a creator who cannot receive support.

dataprofilesupportcurrency
stringnullable

Currency code from the checkout model, e.g. `USD`, `EUR`, `GBP`.

dataprofilesupportitemName
stringnullable

The creator's own wording for a unit of support, e.g. `Coffee`, `Ramen`.

dataprofilesupportactionLabel
stringnullable

The call-to-action wording, e.g. `Tip` or `Donate`.

dataprofilesupportunitAmount
numbernullable

Default amount of one unit.

≥ 0

dataprofilesupportminimumAmount
numbernullable

Minimum amount the checkout accepts.

≥ 0

Suggested one-off amounts; empty when the page suggests none.

dataprofilesupportsuggestedAmounts[]
numberoptional

≥ 0

dataprofilesupportrecurring
booleannullable

Whether the creator accepts recurring support.

dataprofilesupportdiscordRewards
booleannullable

Whether Discord rewards are available.

dataprofilesupportdiscordRewardsSubscribersOnly
booleannullable

Whether Discord rewards are limited to subscribers.

Membership benefit counts from the checkout model; null when there is no model.

Monthly benefits a membership unlocks, as counted by the profile.

dataprofilemembershipunlockableposts
integer

Unlockable posts.

≥ 0

dataprofilemembershipunlockablegalleryItems
integer

Unlockable gallery items.

≥ 0

dataprofilemembershipunlockableshopItems
integer

Unlockable shop items.

≥ 0

dataprofilemembershipunlockablecommissions
integer

Unlockable commissions.

≥ 0

dataprofilemembershipunlockablediscounts
integer

Unlockable discounts.

≥ 0

dataprofilemembershipunlockablepolls
integer

Unlockable polls.

≥ 0

Open Graph metadata.

dataprofileogtitle
stringnullable

Open Graph title.

dataprofileogdescription
stringnullable

Open Graph description.

dataprofileogimageUrl
stringnullable

Open Graph share image.

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

Code example

curl "https://api.socialfetch.dev/v1/ko-fi/profiles/ligianunes" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Get a Ko-fi profile.