Social Fetch
Start for freeStart free
Gumroad hub

Gumroad Wishlist API

A public Gumroad wishlist with its owner and first 20 items.

GET /v1/gumroad/wishlist

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/gumroad/wishlist takes the public wishlist url, which looks like https://clifhuman.gumroad.com/wishlists/some-list. It answers { data, meta } with data.lookupStatus and data.wishlist.

On found, data.wishlist has id, name, description, url, owner, items and page. owner has the buyer's display name, storefront URL and avatar. items is the first 20 items, and each item has its own id, a product reference, option, recurrence, quantity, rent, addedAt, purchasable and giftable. data.wishlist.page reports the list's totalItems; page.hasMore is true when the list holds more than the 20 rows returned, and in that case page.nextCursor is null and moreVia (gumroad.wishlist.items.list) names the route that pages the rest.

An unknown or private list answers not_found. To page beyond the first 20 items, use the wishlist items route with the wishlist id and the owner username.

Gumroad Wishlist API FAQ

How do I name the wishlist?

Give its public URL, for example https://clifhuman.gumroad.com/wishlists/some-list. The owner is the storefront subdomain and the slug is the last path segment.

What is in each item?

An item id, the product reference (name, price, ratings, creator, URL, thumbnail and cover), the chosen option and recurrence, quantity, rent, addedAt, purchasable and giftable.

How do I get items past the first 20?

Use the wishlist items route with data.wishlist.id and the owner username from the wishlist URL. It pages the rest with page or cursor.

Why does a real-looking wishlist answer not_found?

Only public lists are readable. A private, deleted or unknown list answers not_found with data.wishlist null, so check lookupStatus before using the fields.

How many credits does a wishlist 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 Gumroad endpoints