> **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/albums-slug>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/ko-fi/albums-slug.mdx>

---

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

## Request

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

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