Get Gumroad wishlist
Get a Gumroad wishlist with its owner and first items.
Headers
Get your API keyAPI key (`sfk_...`)
Public wishlist URL, e.g. https://clifhuman.gumroad.com/wishlists/some-list.
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 when found. Its first 20 items are here; page the rest with the wishlist items endpoint.
Wishlist id.
List name.
List description.
Public wishlist URL.
The buyer who published the list.
Owner's display name.
Owner's storefront URL.
Owner's avatar URL.
The first 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?url=https://aliceman666.gumroad.com/wishlists/1-588657779" \
-H "x-api-key: YOUR_API_KEY"Responses
Gumroad wishlist.