Social Fetch
Start for freeStart free
Gumroad hub

Gumroad Reviews API

Written reviews for a Gumroad product, with reviewer names and the creator's reply.

GET /v1/gumroad/product/reviews

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/gumroad/product/reviews takes a productId, which the product route returns as data.product.id. Add page or a cursor to walk the list. The response is { data, meta } with data.lookupStatus, data.productId, data.reviews and data.page.

Each review has id, rating, body, postedAt, author and creatorReply. author carries the public display name and avatar, and creatorReply is the creator's body or null. data.page has number, totalPages, hasMore and nextCursor, so a list is walked with the cursor until hasMore is false.

A product can have a rating summary without written reviews, so an empty reviews array on found is a valid answer, as is a page past the last one. Reviews are 10 per page, and the product record carries only the first page.

Gumroad Reviews API FAQ

Where do I get the product id?

Call the product route first and read data.product.id, or read product.id from a search, related-products or wishlist item. The id looks like bwnHm1v-yDVdtDf4fXYfvg==.

What fields does each review have?

id, rating (1 to 5), body, postedAt, author with name and avatarUrl, creatorReply with body or null, and isNew when Gumroad publishes it.

Why is the reviews list empty?

Some products collect star ratings without written reviews. An empty list on found is valid, and so is an empty page past the last one. Check page.hasMore and page.totalPages before stopping.

Does the creator's reply come back with the review?

Yes. creatorReply is the creator's body when one exists and null otherwise. It is the same on every page.

How many credits does a reviews 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