Gumroad hub

Gumroad Creator API

A Gumroad creator's profile, socials, reputation and page sections.

GET /v1/gumroad/creator

1 credit Failed requests are free

About this endpoint

GET /v1/gumroad/creator takes creator, the storefront subdomain, or a storefront URL such as https://clifhuman.gumroad.com/ or https://gumroad.com/clifhuman. It answers { data, meta } with data.lookupStatus and data.creator.

On found, data.creator has id, username, name, url, avatarUrl, bio, isVerified, socials, reputation, tabs, sections, layout and landing. socials carries the Twitter/X handle and YouTube channel id. reputation gives the shop's average rating, rating count and product count. tabs is the creator's own page structure, and each tab lists the ids of its sections; sections gives each section's id, header, type and raw type.

Some creators replace the storefront with a landing layout. layout is then landing, the profile fields are empty, and landing carries the open-graph name, description, image and creator id. That answer is still found.

Gumroad Creator API FAQ

How do I name the creator?

Use the storefront subdomain, such as clifhuman for clifhuman.gumroad.com. A full storefront URL or a gumroad.com/creator URL is also accepted and reduced to the username.

What are tabs and sections?

Tabs are the creator's own page structure; each tab lists the ids of its sections. Sections have an id, a header, a type such as products, posts, text or featuredProduct, and a raw type for values the contract does not name.

What does reputation contain?

reputation has average, the shop's average rating, count, the number of ratings, and productsCount, the number of products. It is null when Gumroad does not publish one.

Why does layout say landing?

A landing creator replaced the standard storefront with a custom page. The profile fields are then empty and the open-graph data is in landing. It is a typed branch, not an error.

What about an unknown creator?

The route answers HTTP 200 with data.lookupStatus not_found and data.creator null. Branch on lookupStatus, not on the HTTP status.

How many credits does a creator lookup 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.