Get Gumroad product
Get Gumroad product: price, ratings, tiers, covers, attributes, refund policy and reviews.
Headers
Get your API keyAPI key (`sfk_...`)
A product URL, e.g. https://clifhuman.gumroad.com/l/latonc or https://gumroad.com/l/latonc.
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.
Product permalink, e.g. `latonc`.
pattern: ^[A-Za-z0-9._~-]{1,200}$
Endpoint-specific response payload.
Whether the item exists. `not_found` covers an unknown or deleted item (Gumroad does not tell those apart).
one of: found, not_found
The product when found; otherwise null.
Product id, which the reviews endpoint needs.
The product's permalink. A list route can show a different short id or custom permalink for the same product; either form resolves when you also pass the creator.
Product name.
Native product type.
Canonical product URL.
Thumbnail URL.
When the product was created.
When the product was last changed.
The creator.
Creator's external id.
Storefront subdomain label, e.g. `clifhuman`.
Display name.
Storefront URL.
Avatar URL.
Whether Gumroad verified the creator.
The product's price in its own currency.
Price in the product's own currency, in Gumroad's smallest unit for it: cents for most currencies, whole yen for JPY, and 1/100 for KRW and TWD. 0 means free.
≥ 0
ISO 4217 code of the product's own currency, e.g. `usd`.
Price as Gumroad displays it, e.g. `$0+` or `€150`. A trailing `+` means pay-what-you-want or tiers.
Price before a sale, in the same unit as `amount`; null when not on sale or on the product record, which does not carry it.
≥ 0
Whether the buyer may pay another amount.
Suggested amount in the same unit as `amount`; null when the product does not set one.
≥ 0
Default pay-what-you-want amount in the same unit as `amount`; null when the product does not set one.
≥ 0
Subscription terms.
Whether the product bills repeatedly.
Whether the product has membership tiers.
Billing periods; null when the product is not a membership.
Default billing period, e.g. `monthly`.
Billing periods the creator offers.
Recurrence id.
`monthly`, `quarterly`, `biannually`, `yearly` or `every_two_years`.
Price for this period, in the same unit as the product's `price.amount`.
≥ 0
The free-trial object; null in every capture. The shape is unverified.
Product description as the creator wrote it, in HTML.
The same description as plain text.
One-line summary.
Cover images and videos.
`image` or `video` (pass through any other value).
Display URL of the media.
The original file URL; null when not published.
Thumbnail URL; null when not published.
Width in pixels.
≥ 0
Height in pixels.
≥ 0
Attributes such as `Format` or `Pages`.
Attribute name, e.g. `Format`.
Attribute value.
Rating summary with the share of ratings at each star count.
Average rating, 1 to 5; null when there are no ratings.
Number of ratings.
≥ 0
Percent of ratings at 1, 2, 3, 4 and 5 stars, in that order; null when Gumroad does not send it.
The first written reviews; use the reviews endpoint for all.
Review id.
Stars, 1 to 5.
≥ 1 · ≤ 5
Review text.
When the review was written.
Who wrote it.
Public display name.
Avatar URL.
The creator's reply; null when there is none.
The creator's reply text.
Whether Gumroad marks the review as new.
Sales count when the creator shows it; null otherwise.
≥ 0
Variants and membership tiers.
Option id.
Option name.
Option description.
Amount added to the base price, in the same unit as the product's `price.amount`.
Whether this option is pay-what-you-want.
Units left for this option.
≥ 0
Length of a call or commission option, in minutes.
≥ 0
Price per billing period for a membership option, keyed by `monthly`, `quarterly`, `yearly` and so on; null when the option has no recurring price.
Stock state.
Units left when the creator limits sales.
≥ 0
Whether the creator limits the quantity.
Whether the creator marked the product as limited.
Whether the product ships.
The creator's refund policy; null when none is set.
Policy title.
Policy text as HTML.
When the policy was last changed.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/gumroad/product?url=https://clifhuman.gumroad.com/l/latonc" \
-H "x-api-key: YOUR_API_KEY"Responses
Gumroad product.