Ko-fi

List Ko-fi creator commissions

List a Ko-fi creator's commissions with previews, add-ons, waitlist and membership requirements.

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

API key (`sfk_...`)

Parameters
5
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_-]+$

querystringoptionalquery

Search term within the commissions.

min 1 chars · max 100 chars

pageintegeroptionalquery

Zero-based page index. Advance with `page.nextPage` when `hasMore` is true.

≥ 0 · ≤ 500

limitintegeroptionalquery

Items per page, 1 to 20. Default: 6.

≥ 1 · ≤ 20

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 2048 chars

Response fields
47

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 of the prices.

Commission items; empty when the creator has none.

dataitems[]id
string

Item id (GUID).

dataitems[]alias
string

Alias used in `/s/{alias}`.

dataitems[]url
string

Public item URL.

dataitems[]name
stringnullable

Item name.

dataitems[]descriptionPreview
stringnullable

Description as Ko-fi truncates it in lists.

dataitems[]price
numbernullable

Price.

≥ 0

dataitems[]currency
stringnullable

Currency code from the profile.

Image URLs.

dataitems[]images[]
stringoptional
dataitems[]soldOut
boolean

Whether the item is sold out.

dataitems[]stockRemaining
integernullable

Remaining stock when limited; null when unlimited or unknown.

≥ 0

dataitems[]soldCount
integernullable

Units sold, as published.

≥ 0

dataitems[]payWhatYouWant
boolean

Whether the buyer chooses the price.

dataitems[]requiresShipping
boolean

Whether the item requires shipping.

dataitems[]access
string

Who can buy the item.

one of: public, members, supporters

dataitems[]discountPercent
numbernullable

Discount percent.

≥ 0

Shop category ids.

dataitems[]categoryIds[]
integeroptional
dataitems[]addOns
boolean

Whether add-ons are available.

Preview images; empty when none.

dataitems[]previews[]displayUrl
stringnullableoptional

Full-size preview URL.

dataitems[]previews[]thumbnailUrl
stringnullableoptional

Thumbnail URL.

dataitems[]previews[]width
integernullableoptional

Preview width.

≥ 0

dataitems[]previews[]height
integernullableoptional

Preview height.

≥ 0

Membership tiers the commission requires, as raw objects; null when none. Their inner shape is undocumented.

dataitems[]requiredTiers[]
objectoptional
dataitems[]waitlist
boolean

Whether the commission is a waitlist.

dataitems[]open
boolean

Whether the commission is available now: not sold out and not a waitlist.

Pagination state for the current page.

datapagepage
integernullable

Zero-based page index for a numbered list; null for offset lists.

≥ 0

datapagestart
integernullable

Offset of this page for an offset list; null for numbered lists.

≥ 0

datapagereturned
integer

Number of rows in this response.

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page index for a numbered list; null when there is none.

≥ 0

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetotal
integernullable

Total rows when Ko-fi publishes one (comments: all comments including replies); otherwise null.

≥ 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/commissions?limit=6" \
  -H "x-api-key: YOUR_API_KEY"

Responses

List a Ko-fi creator's commissions.