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

---

# Ko-fi Gallery Item API

One public gallery item with every image, its description, owner and likes.

`GET /v1/ko-fi/gallery-items/{id}` takes the gallery item id, for example `IN3G429XO7C` from `https://ko-fi.com/i/IN3G429XO7C`. On `found`, `data.item` has `id`, `url`, `title`, `description`, `owner` (`id`, `name`), `postedAtRelative`, `images`, `access` and `likes`. Each image has the display `url`, a `highResUrl` when a larger version exists, and `alt` text.

`postedAtRelative` is a relative time such as `2 days ago`; Ko-fi gives no absolute time for gallery items. `access` is `restricted` for a locked item, whose `images` list is empty because only a placeholder is public and whose `description` is null because the lock notice is not a description. A removed or unknown item returns `lookupStatus: not_found` with `item: null`. An id in the wrong shape is refused with HTTP 400, which is a caller input error and is not billed.

## Request

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

## FAQ

### Where do I find the gallery item id?

It is the last segment of a /i/ URL, such as IN3G429XO7C from https://ko-fi.com/i/IN3G429XO7C. The gallery list returns the same id in each tile so you can walk from a page to one item.

### Why does a malformed id return 400 instead of not_found?

An id with characters outside letters and digits cannot be a gallery item id, so it is refused as bad input: HTTP 400, no retry and no charge. A well-formed id that does not exist returns lookupStatus: not_found instead.

### Are all images returned?

Every public image the item provides is returned in data.item.images, up to 100. highResUrl is present when a larger version exists; otherwise it is null. A restricted item returns no images.

### How many credits does a gallery item 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.