Social Fetch
Start for freeStart free
Gumroad hub

Gumroad Wishlist Items API

The items on a public Gumroad wishlist, 20 per page, with the product behind each one.

GET /v1/gumroad/wishlist/items

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/gumroad/wishlist/items takes a wishlistId and the owner username, plus page or a cursor. It answers { data, meta } with data.lookupStatus, data.wishlistId, data.owner, data.items and data.page.

Each item has id, product, option, recurrence, quantity, rent, addedAt, purchasable and giftable. product is the full product reference: id, permalink, name, type, URL, thumbnail, summary, creator, ratings, price, sale label, stock and subscription. Items are 20 per page, so follow page.nextCursor while page.hasMore is true; page.totalItems is the size of the whole list. data.owner is the username you sent, echoed, not checked against the list's real owner.

The wishlist id and owner come from the wishlist route. An unknown wishlist id answers not_found, and a page past the last one is a valid empty page.

Gumroad Wishlist Items API FAQ

Where do I get the wishlist id and owner?

Call the wishlist route first and read data.wishlist.id. The owner is the storefront subdomain from the wishlist URL, such as clifhuman.

What is the difference between this and the wishlist route?

The wishlist route returns the list itself with its first 20 items. This route pages only the items, which is what you need for a long list.

What does each item carry?

An item id, the product reference, the chosen option and recurrence, quantity, rent, addedAt, purchasable and giftable. The product reference is the same shape search returns.

Is an empty page an error?

No. A page past the last one returns found with an empty items array. Use page.hasMore to decide whether to request another page.

How many credits does a wishlist-items page 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. Each paginated page is a separate billed request.

Other Gumroad endpoints