Gumroad

List Gumroad product reviews

List a Gumroad product's written reviews with the reviewer's display name and the creator's reply.

GET/v1/gumroad/product/reviews
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
productIdstringrequiredquery

Product id as returned in `product.id` by the product endpoint, e.g. `bwnHm1v-yDVdtDf4fXYfvg==`.

pattern: ^[A-Za-z0-9_+=-]{1,400}$

pageintegeroptionalquery

Page number, 1 to 1,000. Default: 1.

≥ 1 · ≤ 1000

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters; start again without it.

min 1 chars · max 1024 chars

Response fields
25

Endpoint-specific response payload.

datalookupStatus
string

Whether the item exists. `not_found` covers an unknown or deleted item (Gumroad does not tell those apart).

one of: found, not_found

dataproductId
string

The product asked for.

Written reviews, 10 per page. Empty on a product with no written reviews and on a page past the last one.

datareviews[]id
string

Review id.

datareviews[]rating
integer

Stars, 1 to 5.

≥ 1 · ≤ 5

datareviews[]body
string

Review text.

datareviews[]postedAt
stringnullable

When the review was written.

Who wrote it.

datareviews[]authorname
stringnullable

Public display name.

datareviews[]authoravatarUrl
stringnullable

Avatar URL.

The creator's reply; null when there is none.

datareviews[]creatorReplybody
stringnullable

The creator's reply text.

datareviews[]isNew
booleannullable

Whether Gumroad marks the review as new.

Pagination state for the current page.

datapagenumber
integernullable

Page number of this answer.

datapagetotalPages
integernullable

Total pages in the list; null when not published.

datapagetotalItems
integernullable

Rows in the whole list; null when not published.

≥ 0

datapagehasMore
boolean

Whether more rows are available. When `nextCursor` is null, `moreVia` names the route that pages the rest.

datapagenextCursor
stringnullable

Cursor for the next page on this route; null on the last page.

datapagemoreVia
stringnullable

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.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/gumroad/product/reviews?productId=bwnHm1v-yDVdtDf4fXYfvg==" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumroad reviews.