Ko-fi

List Ko-fi creator albums

Try in Playground

List a Ko-fi creator's public albums with titles, covers and slugs.

Try in Playground

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

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

15

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.

Albums in page order; empty when the creator has none.

dataalbums[]id

string

Album id from the slug's last segment.

dataalbums[]slug

string

Album slug from `/album/{slug}`.

dataalbums[]title

stringnullable

Album title.

dataalbums[]coverUrl

stringnullable

Cover image URL; null when the album has no cover.

dataalbums[]url

string

Public album URL.

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

Responses

List a Ko-fi creator's albums.

Gallery item

Get one Ko-fi gallery item with its images, owner, description and like count.

Album

Get one public Ko-fi album with its gallery tiles, 15 a page.