List Ko-fi creator shop items
List a Ko-fi creator's shop items with price, stock, sold count, images and audience.
Headers
Get your API keyAPI key (`sfk_...`)
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_-]+$
Only items in this shop category id (from `categoryIds`).
≥ 0
Search term within the shop.
min 1 chars · max 100 chars
Zero-based page index. Default: 0. Advance with `page.nextPage` when `hasMore` is true.
≥ 0 · ≤ 500
Items per page, 1 to 20. Default: 12.
≥ 1 · ≤ 20
Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
min 1 chars · max 2048 chars
Endpoint-specific response payload.
Whether the requested entity exists.
one of: found, not_found
Creator page id; null when not found.
Canonical handle; null when not found.
Creator display name.
Currency of the prices.
Shop items; empty when the creator has no shop or the page is past the end.
Item id (GUID).
Alias used in `/s/{alias}`.
Public item URL.
Item name.
Description as Ko-fi truncates it in lists.
Price.
≥ 0
Currency code from the profile.
Image URLs.
Whether the item is sold out.
Remaining stock when limited; null when unlimited or unknown.
≥ 0
Units sold, as published.
≥ 0
Whether the buyer chooses the price.
Whether the item requires shipping.
Who can buy the item.
one of: public, members, supporters
Discount percent.
≥ 0
Shop category ids.
Pagination state for the current page.
Zero-based page index for a numbered list; null for offset lists.
≥ 0
Offset of this page for an offset list; null for numbered lists.
≥ 0
Number of rows in this response.
≥ 0
Whether another page is available.
Next page index for a numbered list; null when there is none.
≥ 0
Cursor for the next page; null on the last page.
Total rows when Ko-fi publishes one (comments: all comments including replies); otherwise null.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/ko-fi/profiles/ligianunes/shop?limit=12" \
-H "x-api-key: YOUR_API_KEY"Responses
List a Ko-fi creator's shop items.