> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt). ## This page - **On-site (HTML):** - **Markdown (.mdx) URL:** --- # Gumroad API. The marketplace as JSON. Product records, extra details, reviews, creators, posts, wishlists and search from the Gumroad marketplace. Name the product, creator or query, get typed JSON. - Products and creators - Reviews and posts - 1 credit per request Social Fetch exposes sixteen routes under `/v1/gumroad`. Product routes cover one product record, the extra details beside it, written reviews, products bought together, and open slots on a call product. A product that is not a call answers the call-slots route with found and an empty slots list. Discovery routes cover keyword search with sorts and filters, autocomplete suggestions, the category tree and tag names. Creator and community routes cover a creator profile, their products and posts, a single post with its comments, and a public wishlist with its items. A product is named by URL, by creator and permalink, or by its bare permalink. A short permalink and the seller's custom one both work. A creator is named by username or storefront URL. A post is named by URL or by creator and slug. A wishlist is named by its public URL. Every response uses the `{ data, meta }` envelope with `data.lookupStatus` on lookup routes, so an unknown product, creator, post or wishlist comes back as a typed `not_found` instead of an error. List routes page with an opaque `cursor` or a page number, and search reports `page.truncated` when the marketplace's depth limit stopped the walk. ## What you can get - One product record with price, ratings, tiers, subscription terms, covers, attributes and the first reviews. - Extra product details: file summaries, bundle items, preview files, pay-what-you-want amounts and creator reputation. - Written reviews with the reviewer display name and the creator's reply, 10 per page. - Marketplace search by text, sort, category, tags, file types, price, rating and category attributes, with facets. - Creator profiles, their products across sections, and every post title and date their profile lists. - Public wishlists with their items, plus the category tree, tag counts and autocomplete suggestions. ## Gumroad endpoints | Endpoint | Request | Credits | Docs | | --- | --- | --- | --- | | Product | GET /v1/gumroad/product | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/product/get) | | Product details | GET /v1/gumroad/product/details | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/product/details/get) | | Reviews | GET /v1/gumroad/product/reviews | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/product/reviews/get) | | Related products | GET /v1/gumroad/product/related | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/product/related/get) | | Call slots | GET /v1/gumroad/product/call-slots | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/product/call-slots/get) | | Search | GET /v1/gumroad/search | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/search/get) | | Suggestions | GET /v1/gumroad/search/suggestions | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/search/suggestions/get) | | Categories | GET /v1/gumroad/categories | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/categories/get) | | Tags | GET /v1/gumroad/tags | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/tags/get) | | Creator | GET /v1/gumroad/creator | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/creator/get) | | Creator products | GET /v1/gumroad/creator/products | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/creator/products/get) | | Creator posts | GET /v1/gumroad/creator/posts | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/creator/posts/get) | | Post | GET /v1/gumroad/post | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/post/get) | | Post comments | GET /v1/gumroad/post/comments | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/post/comments/get) | | Wishlist | GET /v1/gumroad/wishlist | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/wishlist/get) | | Wishlist items | GET /v1/gumroad/wishlist/items | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/gumroad/wishlist/items/get) | ## How to start 1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every Gumroad route on a few products and creators. 2. **Name the product, creator or query.** Use `GET /v1/gumroad/product?permalink=latonc` for one product, `GET /v1/gumroad/search?query=notion&limit=10` for a search, or `GET /v1/gumroad/creator?creator=clifhuman` for a profile. Send `x-api-key` on every request. 3. **Branch, then page.** Check `data.lookupStatus` before storing a row, keep requesting with `page.nextCursor` while `page.hasMore` is true, and bill from `meta.creditsCharged`. On `post` and `wishlist` the embedded first page cannot page itself: `page.hasMore` is true when more rows exist, `page.nextCursor` is null, and `page.moreVia` names the comments or wishlist-items route that carries the rest. ## Pricing Each Gumroad route charges one credit per completed request, shown on every endpoint page. Each page of a list is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth. ## Compared with the official API Gumroad's official API is built for a seller managing their own account, so it needs an OAuth app and the seller's permission. Social Fetch covers the public marketplace data in one JSON shape: product records and extra details, reviews, search with facets, creator profiles and posts, wishlists and categories, with typed `not_found` responses and cursors. Nothing is written back to a store. ## FAQ ### Is there a Gumroad API for products and creators? Yes. Social Fetch has sixteen Gumroad routes under /v1/gumroad: product, product details, reviews, related products, call slots, search, search suggestions, categories, tags, creator, creator products, creator posts, post, post comments, wishlist and wishlist items. Authenticate with your Social Fetch API key in x-api-key. ### How do I name a product? Use a product URL, a creator and permalink pair, or the bare permalink. latonc, clifhuman plus latonc, and https://clifhuman.gumroad.com/l/latonc all work. A short permalink and the seller's custom permalink both resolve to the same product. A permalink copied from a list route can be a short id or the custom one; pass the creator username with either form. ### What does a product response include? On found, data.product carries id, permalink, name, type, the canonical URL, created and updated times, the creator, price (with currency and pay-what-you-want amounts; originalAmount is null here because the record has no pre-sale price), subscription terms, description and descriptionHtml, media, attributes, ratings with a five-star distribution, stock, refund policy and the first written reviews. ### Why are some creators and products missing extra details? Some creators use a landing layout that does not expose the same extra details. Their profile and product details still answer found, with layout set to landing and the available open-graph fields under landing. The product record route is unaffected. ### Can I get reviews and the creator's reply? Yes. The reviews route returns 10 written reviews per page with the reviewer's display name, rating, body, posted time, the creator's reply when there is one, and paging. A product can have ratings without written reviews, so an empty reviews list is valid. ### How deep can a search go? Search returns 1 to 100 products per page and stops at 10,000 results. When that limit stops the walk, page.truncated is true and page.hasMore is false. Narrow the query or add tags, price, rating, file type or category filters to go further. ### What if a product, creator, post or wishlist does not exist? The route answers HTTP 200 with data.lookupStatus set to not_found and the entity field set to null. HTTP 200 only means the request finished, so branch on lookupStatus. Search, tags, suggestions, categories and related products always answer found. ### How much does the Gumroad API cost? Every Gumroad route charges one credit per completed request, and each page of a list is billed separately. Check meta.creditsCharged on every response. New accounts start with 100 free credits. ### Can I use the Gumroad routes from agents or MCP? Yes. Every Gumroad route is a typed MCP tool and is reachable through Ask (POST /v1/ask) in plain English. Use the typed routes for production jobs. ## Related - [Gumroad Product API](https://www.socialfetch.dev/platforms/gumroad/product): One product record with price, ratings, tiers and reviews (`GET /v1/gumroad/product`). - [Gumroad Search API](https://www.socialfetch.dev/platforms/gumroad/search): Search the marketplace by text, sort, tags, price and category (`GET /v1/gumroad/search`). - [Gumroad Creator API](https://www.socialfetch.dev/platforms/gumroad/creator): A creator's profile, socials, reputation and sections (`GET /v1/gumroad/creator`). - [Gumroad Reviews API](https://www.socialfetch.dev/platforms/gumroad/product-reviews): Written reviews with reviewer names and creator replies (`GET /v1/gumroad/product/reviews`). - [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language marketplace question to the matching Gumroad operation. - [Hosted MCP](https://www.socialfetch.dev/mcp): Call Gumroad tools from Cursor or Claude with the same credit metering as REST.