Social Fetch
Start for freeStart free
Ko-fi hub

Ko-fi Albums API

A creator's public albums with titles, cover images and the slugs you need to open them.

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/ko-fi/profiles/{handle}/albums returns data.albums in the published order, with the creator's id, canonical handle and name. Each album has id, slug, title, coverUrl and url. The slug is the last segment of the album URL, so https://ko-fi.com/album/Belle-Cards-Y8Y616PKXL gives Belle-Cards-Y8Y616PKXL.

The route returns the creator's public albums in one response, up to 100, and has no cursor. coverUrl is null when an album has no cover image. A creator with no albums returns found and an empty list; a missing creator returns not_found with null identity fields.

Ko-fi Albums API FAQ

Is the albums list paged?

No. The response returns the creator's public albums in one list, capped at 100. There is no data.page block and no cursor on this route.

What can I do with an album slug?

The slug is the last segment of the public album URL, which is also returned as album.url. Pass it to GET /v1/ko-fi/albums/{slug} to get the album's gallery tiles.

Why is coverUrl null for some albums?

The creator has not set a cover image for that album. The title, slug, id and URL are still returned, so the row is still usable.

How many credits does an albums 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