Social Fetch
Start for freeStart free
Ko-fi hub

Ko-fi Profile API

One creator's public identity and support settings, by handle or page id.

GET /v1/ko-fi/profiles/{handle}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/ko-fi/profiles/{handle} accepts the handle from the page URL, such as ligianunes, or the page id, such as A644275F. The response reports the canonical handle even when the request used a different spelling. profile.id is the stable creator id shared with the other routes, and profile.pageMode says whether the page is a tip page, a membership page, a shop, a commissions page or a supporter account.

On found, data.profile carries name, avatarUrl, coverUrl, isGold, followers (kind, count, approximate), bio, website, socials, tags, goal, badges, commissions (slotsText, slotsLeft; the creator's own slots line) and the embedded support model (currency, itemName, actionLabel, unitAmount, minimumAmount, suggestedAmounts, recurring, discordRewards). membership.unlockable gives the benefit counts. og holds the page title, description and share image. Fields a page does not publish are null, so support is null for a supporter account and goal is null when there is no goal widget. A missing handle returns lookupStatus: not_found with profile: null.

Ko-fi Profile API FAQ

Should I pass a handle or a page id?

Either works. Use the handle from the page URL when you have it, and the page id when that is what your data already stores. The response reports the canonical profile.handle, which can differ from the spelling you sent.

What is in data.profile.support?

The checkout settings the page publishes: currency, the creator's own itemName, the actionLabel, unitAmount, minimumAmount, suggestedAmounts, recurring, discordRewards and discordRewardsSubscribersOnly. It is null for a supporter account or a creator who cannot receive support.

What does lookupStatus mean?

found means the profile was returned. not_found means the handle or page id does not exist. HTTP 200 only means the request finished, so branch on lookupStatus.

How many credits does a profile 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.

Other Ko-fi endpoints