Social Fetch
Dashboard
Ko-fi

List Ko-fi creator membership tiers

List a Ko-fi creator's membership tiers with prices, benefits, previews and active member counts.

Try in Playground
GET/v1/ko-fi/profiles/{handle}/tiers
1credit

Headers

Get your API key
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
29

Endpoint-specific response payload.

datalookupStatus
string

Whether the requested entity exists.

one of: found, not_found

dataid
stringnullable

Creator page id; null when not found.

datahandle
stringnullable

Canonical handle; null when not found.

dataname
stringnullable

Creator display name.

datacurrency
stringnullable

Currency the monthly prices are in.

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

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

datamembershipunlockableposts
integer

Unlockable posts.

≥ 0

datamembershipunlockablegalleryItems
integer

Unlockable gallery items.

≥ 0

datamembershipunlockableshopItems
integer

Unlockable shop items.

≥ 0

datamembershipunlockablecommissions
integer

Unlockable commissions.

≥ 0

datamembershipunlockablediscounts
integer

Unlockable discounts.

≥ 0

datamembershipunlockablepolls
integer

Unlockable polls.

≥ 0

Membership tiers in page order; empty when the creator has none.

datatiers[]id
string

Tier id (GUID).

datatiers[]name
stringnullable

Tier name.

datatiers[]pricePerMonth
numbernullable

Monthly price.

≥ 0

datatiers[]description
stringnullable

Tier description.

Benefit lines in the creator's order.

datatiers[]benefits[]
stringoptional
datatiers[]spotsAvailable
integernullable

Remaining limited spots; null when the tier is unlimited.

≥ 0

Preview image URLs.

datatiers[]images[]
stringoptional
datatiers[]activeMembers
integernullable

Active member count.

≥ 0

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/tiers" \
  -H "x-api-key: YOUR_API_KEY"

Responses

List a Ko-fi creator's membership tiers.

Top supporters

List a Ko-fi creator's ranked supporters, up to ten from the leaderboard or else the top three, with rank and avatar.

Posts

List a Ko-fi creator's posts feed with optional type, audience and tag filters, 12 items a page.