Gumroad

Get Gumroad creator

Get a Gumroad creator's public profile: name, bio, avatar, socials, reputation, tabs and sections.

GET/v1/gumroad/creator
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
creatorstringrequiredquery

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.

Response fields
129

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

The creator when found. A landing-layout creator still answers `found`, with OG data in `landing`.

datacreatorid
stringnullable

Creator's external id.

datacreatorusername
stringnullable

Storefront subdomain label.

datacreatorname
stringnullable

Display name.

datacreatorurl
stringnullable

Storefront URL.

datacreatoravatarUrl
stringnullable

Avatar URL.

datacreatorbio
stringnullable

Plain-text bio.

datacreatorisVerified
booleannullable

Whether Gumroad verified the creator.

Social accounts the creator shows.

datacreatorsocialstwitter
stringnullable

Twitter/X handle.

datacreatorsocialsyoutubeChannelId
stringnullable

YouTube channel id; null in every capture.

The creator's reputation; null when not published.

datacreatorreputationaverage
numbernullable

Average rating across the shop.

datacreatorreputationcount
integernullable

Ratings across the shop.

≥ 0

datacreatorreputationproductsCount
integernullable

Products in the shop.

≥ 0

The creator's own page structure.

datacreatortabs[]name
stringnullable

Tab name.

Ids of the sections on the tab.

datacreatortabs[]sections[]
stringoptional

Sections on the profile.

datacreatorsections[]id
string

Section id.

datacreatorsections[]header
stringnullable

Section header the creator wrote.

datacreatorsections[]type
string

What the section shows.

one of: products, posts, text, subscribe, featuredProduct, unknown

datacreatorsections[]rawType
stringnullable

Gumroad's own component name; useful when `type` is `unknown`.

datacreatorsections[]total
integernullable

Products the section holds.

≥ 0

The first products of a products section; null otherwise.

datacreatorsections[]products[]id
stringnullable

Product id; null only on a landing-layout creator, whose products have no id.

datacreatorsections[]products[]permalink
stringnullable

The product's permalink on this route. A product can carry a short id on one route and the seller's custom permalink on another; either form resolves when you also pass the creator. Null when the route does not send one.

datacreatorsections[]products[]name
string

Product name.

datacreatorsections[]products[]type
stringnullable

`digital`, `ebook`, `course`, `membership`, `bundle`, `physical`, `call` or `commission`; unknown values pass through.

datacreatorsections[]products[]url
stringnullable

Product URL, without tracking parameters.

datacreatorsections[]products[]thumbnailUrl
stringnullable

Thumbnail URL.

datacreatorsections[]products[]coverUrl
stringnullable

Cover image URL; null when the row has none.

datacreatorsections[]products[]summary
stringnullable

Short description as Gumroad's lists show it, cut at about 100 to 164 characters. On the product record `summary` is the seller's own summary field instead.

The creator; null only when Gumroad omits it.

datacreatorsections[]products[]creatorid
stringnullable

Creator's external id.

datacreatorsections[]products[]creatorusername
stringnullable

Storefront subdomain label, e.g. `clifhuman`.

datacreatorsections[]products[]creatorname
stringnullable

Display name.

datacreatorsections[]products[]creatorurl
stringnullable

Storefront URL.

datacreatorsections[]products[]creatoravatarUrl
stringnullable

Avatar URL.

datacreatorsections[]products[]creatorisVerified
booleannullable

Whether Gumroad verified the creator.

Rating summary; null on a landing-layout creator, which has none.

datacreatorsections[]products[]ratingsaverage
numbernullable

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

datacreatorsections[]products[]ratingscount
integer

Number of ratings.

≥ 0

The product's price in its own currency.

datacreatorsections[]products[]priceamount
integernullable

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

datacreatorsections[]products[]pricecurrency
stringnullable

ISO 4217 code of the product's own currency, e.g. `usd`.

datacreatorsections[]products[]priceformatted
stringnullable

Price as Gumroad displays it, e.g. `$0+` or `€150`. A trailing `+` means pay-what-you-want or tiers.

datacreatorsections[]products[]priceoriginalAmount
integernullable

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

datacreatorsections[]products[]pricepayWhatYouWant
booleannullable

Whether the buyer may pay another amount.

datacreatorsections[]products[]pricesuggestedAmount
integernullable

Suggested amount in the same unit as `amount`; null when the product does not set one.

≥ 0

datacreatorsections[]products[]pricedefaultAmount
integernullable

Default pay-what-you-want amount in the same unit as `amount`; null when the product does not set one.

≥ 0

datacreatorsections[]products[]saleLabel
stringnullable

Sale label, e.g. `Black Friday`; null when not on sale.

Stock state.

datacreatorsections[]products[]stockremaining
integernullable

Units left when the creator limits sales.

≥ 0

datacreatorsections[]products[]stockquantityEnabled
booleannullable

Whether the creator limits the quantity.

datacreatorsections[]products[]stockisLimited
booleannullable

Whether the creator marked the product as limited.

Subscription fields a search record carries.

datacreatorsections[]products[]subscriptionrecurrence
stringnullable

Billing period, e.g. `monthly`.

datacreatorsections[]products[]subscriptiondurationInMonths
integernullable

Membership duration in months.

≥ 0

Facets of a products section; null otherwise.

Top tags with counts.

datacreatorsections[]facetstags[]name
string

Facet name.

datacreatorsections[]facetstags[]count
integer

Matching products.

≥ 0

Top file types with counts.

datacreatorsections[]facetsfileTypes[]name
string

Facet name.

datacreatorsections[]facetsfileTypes[]count
integer

Matching products.

≥ 0

Category attribute facets; empty for categories that have none.

datacreatorsections[]facetsattributes[]name
string

Attribute key.

datacreatorsections[]facetsattributes[]label
stringnullable

Attribute label.

Values and their counts.

datacreatorsections[]facetsattributes[]filters[]key
string

Filter key, e.g. `product_type:script`.

datacreatorsections[]facetsattributes[]filters[]label
stringnullable

Filter label.

datacreatorsections[]facetsattributes[]filters[]count
integer

Matching products.

≥ 0

Posts of a posts section; null otherwise.

datacreatorsections[]posts[]id
stringnullable

Post id.

datacreatorsections[]posts[]name
stringnullable

Post title.

datacreatorsections[]posts[]slug
stringnullable

Post slug.

datacreatorsections[]posts[]publishedAt
stringnullable

When the post was published.

datacreatorsections[]posts[]truncatedDescription
stringnullable

Gumroad's cut excerpt of the post, ending in an ellipsis; null when not published.

datacreatorsections[]text
stringnullable

Plain text of a rich-text section; null otherwise.

datacreatorsections[]buttonLabel
stringnullable

Button label of a subscribe section; null otherwise.

The full product record a featured-product section carries; null otherwise.

datacreatorsections[]featuredProductid
stringnullable

Product id; null only on a landing-layout creator, whose products have no id.

datacreatorsections[]featuredProductpermalink
stringnullable

The product's permalink on this route. A product can carry a short id on one route and the seller's custom permalink on another; either form resolves when you also pass the creator. Null when the route does not send one.

datacreatorsections[]featuredProductname
string

Product name.

datacreatorsections[]featuredProducttype
stringnullable

`digital`, `ebook`, `course`, `membership`, `bundle`, `physical`, `call` or `commission`; unknown values pass through.

datacreatorsections[]featuredProducturl
stringnullable

Product URL, without tracking parameters.

datacreatorsections[]featuredProductthumbnailUrl
stringnullable

Thumbnail URL.

datacreatorsections[]featuredProductcoverUrl
stringnullable

Cover image URL; null when the row has none.

datacreatorsections[]featuredProductsummary
stringnullable

Short description as Gumroad's lists show it, cut at about 100 to 164 characters. On the product record `summary` is the seller's own summary field instead.

The creator; null only when Gumroad omits it.

datacreatorsections[]featuredProductcreatorid
stringnullable

Creator's external id.

datacreatorsections[]featuredProductcreatorusername
stringnullable

Storefront subdomain label, e.g. `clifhuman`.

datacreatorsections[]featuredProductcreatorname
stringnullable

Display name.

datacreatorsections[]featuredProductcreatorurl
stringnullable

Storefront URL.

datacreatorsections[]featuredProductcreatoravatarUrl
stringnullable

Avatar URL.

datacreatorsections[]featuredProductcreatorisVerified
booleannullable

Whether Gumroad verified the creator.

Rating summary; null on a landing-layout creator, which has none.

datacreatorsections[]featuredProductratingsaverage
numbernullable

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

datacreatorsections[]featuredProductratingscount
integer

Number of ratings.

≥ 0

The product's price in its own currency.

datacreatorsections[]featuredProductpriceamount
integernullable

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

datacreatorsections[]featuredProductpricecurrency
stringnullable

ISO 4217 code of the product's own currency, e.g. `usd`.

datacreatorsections[]featuredProductpriceformatted
stringnullable

Price as Gumroad displays it, e.g. `$0+` or `€150`. A trailing `+` means pay-what-you-want or tiers.

datacreatorsections[]featuredProductpriceoriginalAmount
integernullable

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

datacreatorsections[]featuredProductpricepayWhatYouWant
booleannullable

Whether the buyer may pay another amount.

datacreatorsections[]featuredProductpricesuggestedAmount
integernullable

Suggested amount in the same unit as `amount`; null when the product does not set one.

≥ 0

datacreatorsections[]featuredProductpricedefaultAmount
integernullable

Default pay-what-you-want amount in the same unit as `amount`; null when the product does not set one.

≥ 0

datacreatorsections[]featuredProductsaleLabel
stringnullable

Sale label, e.g. `Black Friday`; null when not on sale.

Stock state.

datacreatorsections[]featuredProductstockremaining
integernullable

Units left when the creator limits sales.

≥ 0

datacreatorsections[]featuredProductstockquantityEnabled
booleannullable

Whether the creator limits the quantity.

datacreatorsections[]featuredProductstockisLimited
booleannullable

Whether the creator marked the product as limited.

Subscription fields a search record carries.

datacreatorsections[]featuredProductsubscriptionrecurrence
stringnullable

Billing period, e.g. `monthly`.

datacreatorsections[]featuredProductsubscriptiondurationInMonths
integernullable

Membership duration in months.

≥ 0

datacreatorlayout
string

`profile`: the normal storefront. `landing`: the creator replaced it with a custom layout; only the OG tags and creator id are available.

one of: profile, landing

Landing details; null on a normal profile.

datacreatorlandingname
stringnullable

Storefront name from the OG tags.

datacreatorlandingdescription
stringnullable

Storefront description from the OG tags.

datacreatorlandingimageUrl
stringnullable

Storefront image from the OG tags.

datacreatorlandingcreatorId
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/creator?creator=clifhuman" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumroad creator.