Social Fetch
Start for freeStart free
Ko-fi hub

Ko-fi Gallery Item API

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

GET /v1/ko-fi/gallery-items/{id}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Ko-fi Gallery Item API 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.

Other Ko-fi endpoints