Social Fetch
Start for freeStart free
Ko-fi hub

Ko-fi Album API

One public album with its gallery tiles, 15 at a time, and the ids to open each item.

GET /v1/ko-fi/albums/{slug}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/ko-fi/albums/{slug} takes the album slug from a URL such as https://ko-fi.com/album/Belle-Cards-Y8Y616PKXL. On found, data.album has id, slug, title, url and items, 15 gallery tiles a page. Each tile has id, title, image (url, alt), access and imageCount; a locked tile has access: restricted and a null image. The tile id is the gallery item id for GET /v1/ko-fi/gallery-items/{id}.

Continue with page.nextCursor while page.hasMore is true. The page block uses start rather than page because an album is an offset list. A missing album returns lookupStatus: not_found with album: null. A slug in the wrong shape is refused with HTTP 400.

Ko-fi Album API FAQ

How do I get the album slug?

It is the last segment of an album URL. For example https://ko-fi.com/album/Belle-Cards-Y8Y616PKXL has the slug Belle-Cards-Y8Y616PKXL. The creator's albums route returns the same slug on each album.

How many tiles are in a page?

Fifteen. Follow data.page.nextCursor while hasMore is true; the cursor carries the album slug, so a cursor from another album is refused.

What does access mean on a tile?

public means the tile image is available. restricted means the item is locked, so its image is null and its gallery item returns no images. The id is still returned so the item can be looked up.

How many credits does an album 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. Each paginated page is a separate billed request.

Other Ko-fi endpoints