Social Fetch
Start for freeStart free
Ko-fi hub

Ko-fi Top Supporters API

The ranked supporters a creator shows, up to ten, with names, avatars and rank.

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/ko-fi/profiles/{handle}/supporters returns data.supporters in rank order. A creator with a leaderboard returns up to ten supporters from the last 90 days; a creator whose leaderboard is switched off returns the top three supporters. Each row has id, name, avatarUrl and rank, where rank 1 is the gold ring, 2 is silver, 3 is bronze, and 4 to 10 are the leaderboard positions. The response also carries the creator's id, canonical handle and name.

Many creators show no supporters, and that is a found response with an empty list. A missing creator is not_found with null identity fields.

Ko-fi Top Supporters API FAQ

How many supporters are returned?

Up to ten when the creator has a leaderboard, otherwise the top three supporters. The schema caps data.supporters at ten.

Why is the list empty for a real creator?

The creator may have no supporters to show. Either way lookupStatus is found and supporters is []. Use lookupStatus, not the list length, to decide whether the creator exists.

What does rank mean?

rank 1 to 3 are the gold, silver and bronze rings. Ranks 4 to 10 are the supporter's position on the creator's leaderboard. It reflects Ko-fi's ranking order, not a live donation amount.

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