List Gumroad wishlist items
List Gumroad wishlist items, 20 per page.
Headers
Get your API keyAPI key (`sfk_...`)
wishlistId, as returned by the Gumroad endpoint that names it.
pattern: ^[A-Za-z0-9_+=-]{1,400}$
Gumroad creator username (the storefront subdomain), e.g. `clifhuman`. A profile URL such as https://clifhuman.gumroad.com/ or https://gumroad.com/clifhuman is also accepted.
Page number, 1 to 1,000. Default: 1.
≥ 1 · ≤ 1000
Cursor from `page.nextCursor` of the previous response. It only works with the same filters; start again without it.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
Whether the item exists. `not_found` covers an unknown or deleted item (Gumroad does not tell those apart).
one of: found, not_found
The wishlist asked for.
The owner you asked for, echoed. Gumroad accepts any creator host, so this is not checked against the list's real owner.
This page of items.
Wishlist item id.
The product on the list.
Product id; null only on a landing-layout creator, whose products have no id.
The product's permalink on this route. A product can carry a short id on one route and the seller's custom permalink on another; either form resolves when you also pass the creator. Null when the route does not send one.
Product name.
`digital`, `ebook`, `course`, `membership`, `bundle`, `physical`, `call` or `commission`; unknown values pass through.
Product URL, without tracking parameters.
Thumbnail URL.
Cover image URL; null when the row has none.
Short description as Gumroad's lists show it, cut at about 100 to 164 characters. On the product record `summary` is the seller's own summary field instead.
The creator; null only when Gumroad omits it.
Creator's external id.
Storefront subdomain label, e.g. `clifhuman`.
Display name.
Storefront URL.
Avatar URL.
Whether Gumroad verified the creator.
Rating summary; null on a landing-layout creator, which has none.
Average rating, 1 to 5; null when there are no ratings.
Number of ratings.
≥ 0
The product's price in its own currency.
Price in the product's own currency, in Gumroad's smallest unit for it: cents for most currencies, whole yen for JPY, and 1/100 for KRW and TWD. 0 means free.
≥ 0
ISO 4217 code of the product's own currency, e.g. `usd`.
Price as Gumroad displays it, e.g. `$0+` or `€150`. A trailing `+` means pay-what-you-want or tiers.
Price before a sale, in the same unit as `amount`; null when not on sale or on the product record, which does not carry it.
≥ 0
Whether the buyer may pay another amount.
Suggested amount in the same unit as `amount`; null when the product does not set one.
≥ 0
Default pay-what-you-want amount in the same unit as `amount`; null when the product does not set one.
≥ 0
Sale label, e.g. `Black Friday`; null when not on sale.
Stock state.
Units left when the creator limits sales.
≥ 0
Whether the creator limits the quantity.
Whether the creator marked the product as limited.
Subscription fields a search record carries.
Billing period, e.g. `monthly`.
Membership duration in months.
≥ 0
Chosen variant.
Chosen billing period.
Quantity.
≥ 0
Whether the item is a rental.
When the item was added.
Whether the item can be bought now.
Whether the item can be gifted.
Pagination state for the current page.
Page number of this answer.
Total pages in the list; null when not published.
Rows in the whole list; null when not published.
≥ 0
Whether more rows are available. When `nextCursor` is null, `moreVia` names the route that pages the rest.
Cursor for the next page on this route; null on the last page.
When this response cannot page, the operation id that pages the rest, e.g. `gumroad.wishlist.items.list`; null when `nextCursor` pages this list.
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/gumroad/wishlist/items?wishlistId=GCNaB6KFAA5mlIj83tg18g==&owner=aliceman666" \
-H "x-api-key: YOUR_API_KEY"Responses
Gumroad wishlist items.