> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/ko-fi/profiles-handle-albums>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/ko-fi/profiles-handle-albums.mdx>

---

# 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` 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.

## Request

- **Endpoint:** `GET /v1/ko-fi/profiles/{handle}/albums`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by handle or page id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/ko-fi/profiles/handle/albums/get)
- **Platform page:** [/platforms/ko-fi](https://www.socialfetch.dev/platforms/ko-fi)

## 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.