Gumroad

Get Gumroad product details

Get Gumroad product details: files, bundles, previews and creator reputation.

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

API key (`sfk_...`)

Parameters
3
urlstringquery

A product URL, e.g. https://clifhuman.gumroad.com/l/latonc or https://gumroad.com/l/latonc.

creatorstringquery

Gumroad creator username (the storefront subdomain), e.g. `clifhuman`. A profile URL such as https://clifhuman.gumroad.com/ or https://gumroad.com/clifhuman is also accepted.

permalinkstringquery

Product permalink, e.g. `latonc`.

pattern: ^[A-Za-z0-9._~-]{1,200}$

Response fields
67

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

Extra product details when found. A landing-layout creator still answers `found` with `layout: "landing"` and the OG tags in `landing`.

datadetailsproductId
stringnullable

Product id when the product record carries one.

datadetailslayout
string

`product`: the normal product layout. `landing`: the creator replaced the storefront with a custom layout, so the extra details are not available; `landing` carries the OG tags instead.

one of: product, landing

File summaries; null on a landing layout.

The product's own files; null when not published.

File formats, e.g. `PDF` and `ZIP`.

datadetailsfileSummariesproductformats[]
stringoptional
datadetailsfileSummariesproductcount
integer

Number of files.

≥ 0

datadetailsfileSummariesproducttotalSize
integernullable

Total size in bytes.

≥ 0

Files per variant or tier.

File formats, e.g. `PDF` and `ZIP`.

datadetailsfileSummariesoptions[]formats[]
stringoptional
datadetailsfileSummariesoptions[]count
integer

Number of files.

≥ 0

datadetailsfileSummariesoptions[]totalSize
integernullable

Total size in bytes.

≥ 0

datadetailsfileSummariesoptions[]optionId
string

The option these files belong to.

Public preview files; empty when none.

datadetailspreviewFiles[]id
stringnullable

File id.

datadetailspreviewFiles[]name
stringnullable

File name.

datadetailspreviewFiles[]extension
stringnullable

File extension.

datadetailspreviewFiles[]fileSize
integernullable

Size in bytes.

≥ 0

datadetailspreviewFiles[]url
stringnullable

Public CDN URL of the file.

datadetailspreviewFiles[]status
stringnullable

File status.

Products in the bundle; empty when it is not one.

datadetailsbundleItems[]id
stringnullable

Bundled product id.

datadetailsbundleItems[]name
stringnullable

Bundled product name.

datadetailsbundleItems[]price
stringnullable

Displayed price of the bundled product.

datadetailsbundleItems[]quantity
integernullable

Quantity in the bundle.

≥ 0

datadetailsbundleItems[]type
stringnullable

Native product type.

Rating summary.

datadetailsbundleItems[]ratingsaverage
numbernullable

Average rating, 1 to 5; null when there are no ratings.

datadetailsbundleItems[]ratingscount
integer

Number of ratings.

≥ 0

datadetailsbundleItems[]thumbnailUrl
stringnullable

Thumbnail URL.

datadetailsbundleItems[]url
stringnullable

Product URL.

datadetailsbundleItems[]variant
stringnullable

Variant name.

The product's pay-what-you-want amounts; null when the product is not pay-what-you-want.

datadetailspayWhatYouWantsuggestedAmount
integernullable

Suggested amount in the same unit as the product's `price.amount`; null when Gumroad sets none.

≥ 0

datadetailspayWhatYouWantdefaultAmount
integernullable

Default amount in the same unit as the product's `price.amount`; null when Gumroad sets none.

≥ 0

The creator's reputation; null when Gumroad omits it.

datadetailssellerReputationaverage
numbernullable

Average rating across the shop.

datadetailssellerReputationcount
integernullable

Ratings across the shop.

≥ 0

datadetailssellerReputationproductsCount
integernullable

Products in the shop.

≥ 0

datadetailssalesCount
integernullable

Sales count when the creator shows it; null otherwise.

≥ 0

datadetailslongUrl
stringnullable

Canonical product URL, without tracking.

datadetailsdurationInMonths
integernullable

Membership duration in months.

≥ 0

The product's installment plan; null when the product is paid in one go.

datadetailsinstallmentPlannumberOfInstallments
integernullable

Number of payments the buyer splits the total into.

≥ 0

datadetailsinstallmentPlanrecurrence
stringnullable

How often an installment is charged, e.g. `monthly`.

The user the creator collaborates with on this product; null when there is none.

datadetailscollaboratorid
stringnullable

Collaborator's external id.

datadetailscollaboratorname
stringnullable

Collaborator's display name.

datadetailscollaboratorurl
stringnullable

Collaborator's storefront URL.

datadetailscollaboratoravatarUrl
stringnullable

Collaborator's avatar URL.

datadetailscollaboratorisVerified
booleannullable

Whether Gumroad verified the collaborator.

Small extra flags.

datadetailsflagsisStreamOnly
booleannullable

Whether the product is stream-only.

datadetailsflagsisLicensed
booleannullable

Whether the product is licensed.

Landing details; null on a normal product layout.

datadetailslandingname
stringnullable

Storefront name from the OG tags.

datadetailslandingdescription
stringnullable

Storefront description from the OG tags.

datadetailslandingimageUrl
stringnullable

Storefront image from the OG tags.

datadetailslandingcreatorId
stringnullable

Creator id of the landing-layout storefront.

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/details?url=https://meshhouse.gumroad.com/l/tracktools" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumroad product details.