> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/ko-fi/profiles-handle-supporters>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/ko-fi/profiles-handle-supporters.mdx>

---

# 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` 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.

## Request

- **Endpoint:** `GET /v1/ko-fi/profiles/{handle}/supporters`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by handle or page id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/ko-fi/profiles/handle/supporters/get)
- **Platform page:** [/platforms/ko-fi](https://www.socialfetch.dev/platforms/ko-fi)

## 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.