Ko-fi

List Ko-fi creator posts

List a Ko-fi creator's posts feed with optional type, audience and tag filters, 12 items a page.

GET/v1/ko-fi/profiles/{handle}/posts
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
6
handlestringrequiredpath

A creator's Ko-fi handle (e.g. `ligianunes`) or page id (e.g. `A644275F`). Case-insensitive.

min 1 chars · max 64 chars · pattern: ^[A-Za-z0-9_-]+$

typestringoptionalquery

Only items of this kind: `updates`, `posts`, `images`, `videos`, `audio` or `polls`.

one of: updates, posts, images, videos, audio, polls

accessstringoptionalquery

Only items the creator set to this exact audience: `public`, `supporters` or `members`. `supporters` does not include `members` items.

one of: public, supporters, members

tagstringoptionalquery

Only posts tagged with this tag, e.g. `build`. Letters, digits, underscores and hyphens only.

min 1 chars · max 64 chars · pattern: ^[A-Za-z0-9_-]+$

pageintegeroptionalquery

Zero-based page index; 12 posts a page. Advance with `page.nextPage` when `hasMore` is true.

≥ 0 · ≤ 500

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 2048 chars

Response fields
33

Endpoint-specific response payload.

datalookupStatus
string

Whether the requested entity exists.

one of: found, not_found

dataid
stringnullable

Creator page id; null when not found.

datahandle
stringnullable

Canonical handle; null when not found.

dataname
stringnullable

Creator display name.

Feed items in page order; empty when the page is past the end.

dataposts[]id
string

Feed item id (GUID).

dataposts[]type
string

Kind of feed item.

one of: post, image, message, poll

dataposts[]pinned
boolean

Whether the creator pinned the item.

dataposts[]relativeTime
stringnullable

Relative time as Ko-fi displays it, e.g. `2 days ago`; feed items have no absolute date.

dataposts[]title
stringnullable

Title; present for post, image and poll items.

dataposts[]excerpt
stringnullable

Excerpt or message text.

dataposts[]url
stringnullable

Absolute link to the post, image or poll; null for a message.

dataposts[]slug
stringnullable

Post slug when the item links to a post.

dataposts[]galleryItemId
stringnullable

Gallery item id when the item is a gallery image.

An image on a feed item.

dataposts[]imageurl
string

Image URL.

dataposts[]imagealt
stringnullable

Image alt text.

dataposts[]likes
integernullable

Like count.

≥ 0

dataposts[]commentCount
integernullable

Comment count.

≥ 0

dataposts[]access
stringnullable

`members` or `supporters` when the feed shows a lock marker; null when it does not. A public item is never labelled `public`.

one of: supporters, members, null

Pagination state for the current page.

datapagepage
integernullable

Zero-based page index for a numbered list; null for offset lists.

≥ 0

datapagestart
integernullable

Offset of this page for an offset list; null for numbered lists.

≥ 0

datapagereturned
integer

Number of rows in this response.

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page index for a numbered list; null when there is none.

≥ 0

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetotal
integernullable

Total rows when Ko-fi publishes one (comments: all comments including replies); otherwise null.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/ko-fi/profiles/ligianunes/posts?type=images&page=0" \
  -H "x-api-key: YOUR_API_KEY"

Responses

List a Ko-fi creator's posts.