> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/gumroad/wishlist>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/gumroad/wishlist.mdx>

---

# Gumroad Wishlist API

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

`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.

## Request

- **Endpoint:** `GET /v1/gumroad/wishlist`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by public wishlist URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/wishlist/get)
- **Platform page:** [/platforms/gumroad](https://www.socialfetch.dev/platforms/gumroad)

## 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.