# Gumroad Scraper - Products, Creators & Sales (`scrapesage/gumroad-scraper`) Actor Scrape Gumroad digital products by keyword, niche or URL: prices, ratings, sales counts, product types, tiers & full descriptions. Get deduplicated creator/seller leads with bio, socials & emails, plus a new-product & price-drop monitor. Export JSON, CSV, Excel. - **URL**: https://apify.com/scrapesage/gumroad-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 product scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Gumroad Scraper — Digital Products, Creators & Sales Data (+ Creator Leads) Extract **complete Gumroad data** — the digital products *and* the people selling them. Search Gumroad Discover by keyword or niche (or paste any product/creator URL) and get **real prices, sales counts, full 1–5★ rating histograms, product types, tiers, and full descriptions** — then turn every seller into a **ready-to-contact creator lead** with bio, socials, website and (optionally) contact emails. No login, no API key, no browser — fast keyless JSON extraction with 99%+ reliability. ### Why this Gumroad scraper? Most Gumroad scrapers only parse a single search page and stop at name + price. This actor pulls from Gumroad's Discover search **and** each product's detail endpoint **and** the creator's profile, shipping the **richest dataset in the category** plus a lead-gen layer nobody else offers: | Data | Typical scrapers | This actor | |---|---|---| | Product name, price, currency, PWYW | ✅ | ✅ | | Average rating | ✅ | ✅ | | **Sales count** (social proof / demand signal) | ❌ | ✅ | | **Full rating histogram** (1–5★ breakdown) | ❌ | ✅ | | Product type (course / ebook / membership / bundle…) | partial | ✅ | | Variants / tiers + membership pricing | ❌ | ✅ | | Full HTML description, summary, attributes, covers | ❌ | ✅ | | Created / updated dates | ❌ | ✅ | | **Creator/seller lead records** (deduplicated) | ❌ | ✅ | | Creator bio, Twitter/X, product count, lead score | ❌ | ✅ | | Creator **contact email** (from their website) | ❌ | ✅ opt-in | | **Monitor mode** — only new / price drops / new sales | ❌ | ✅ | ### Use cases - **Product validation & opportunity research** — find proven, best-selling digital products in any niche (`sales count`, `ratingCount`, `ratingAverage`) before you build your own. Sort by *best selling*, *most reviewed*, or *highest rated*. - **Pricing & competitor intelligence** — benchmark prices, tiers, and membership pricing across a category; track how competitors price and discount over time. - **Affiliate & curation discovery** — surface high-rating, high-sales products to promote, bundle, or feature in a newsletter or marketplace. - **Creator lead generation** — Gumroad creators are active buyers of tools, courses, design, marketing and payments. Score them by audience and catalog size and reach them via Twitter/X, website, or email (`enrichCreatorEmails`). - **Trend & niche monitoring** — schedule recurring runs with **monitor mode** to watch a tag, search, or creator and only get *new* products, *price drops*, and *new sales*. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **Gumroad Scraper**, enter search queries and/or tags (or paste Gumroad URLs), and click **Start**. 3. Watch products and creator leads stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "searchQueries": ["notion template"], "tags": ["productivity"], "sort": "best_selling", "minPrice": 0, "maxPrice": 200, "minRating": 4, "maxResults": 200, "includeProductDetails": true, "includeCreatorLeads": true, "enrichCreatorEmails": true, "monitorMode": false } ```` - **searchQueries** — keywords searched on Gumroad Discover; each is combined with every tag. - **tags** — Gumroad tags / niches to browse (`notion`, `fitness`, `3d`, `stable-diffusion`, `design`…); works on their own or to narrow a query. - **startUrls** — direct product pages (`/l/…`), creator profiles (`creator.gumroad.com`), or Discover/search pages — auto-routed and scraped in addition to searches. - **sort** — `recommended`, `staff_picked`, `best_selling`, `most_reviewed`, `highest_rated`, `newest`, `trending`, `price_low_to_high`, `price_high_to_low`. - **productType / fileTypes / minPrice / maxPrice / minRating / freeOnly** — filters. Type/price/rating are applied to the search card *before* any detail fetch, so they don't add cost. - **includeProductDetails** *(default true)* — fetch each product's detail JSON: sales count, full rating histogram, HTML description, tiers, attributes, covers, dates. - **includeCreatorLeads** *(default true)* — emit one deduplicated lead record per unique seller, with a 0–100 lead score. - **enrichCreatorEmails** *(default false)* — crawl a creator's own website (home + contact/about, max 3 pages) for emails, phone, and extra socials. Gumroad never exposes emails — this is the only way to get them. - **monitorMode / monitorKey** — only output new or changed records across scheduled runs. - **maxResults / maxConcurrency / proxyConfiguration** — run controls. ### Output One record per product (`type: "product"`), plus optional deduplicated creator lead records (`type: "creator"`): ```json { "type": "product", "productId": "54OPwba45gyO5TacGR6N2g==", "permalink": "openpeeps", "name": "Open Peeps", "url": "https://pablostanley.gumroad.com/l/openpeeps", "productType": "digital", "price": 0, "currency": "USD", "isPayWhatYouWant": true, "suggestedPrice": 14.99, "isFree": true, "ratingCount": 9052, "ratingAverage": 4.9, "ratingPercentages": [1, 0, 1, 3, 95], "salesCount": 41230, "summary": "Source library for Sketch, Figma, Studio, and XD.", "attributes": [{ "name": "License", "value": "CC0" }], "options": [{ "name": "Multicolor", "priceDifference": 0 }], "coverImageUrls": ["https://public-files.gumroad.com/..."], "createdAt": "2020-01-24T22:51:19Z", "updatedAt": "2026-05-20T16:40:11Z", "sellerId": "8530363257615", "sellerName": "Pablo Stanley", "sellerProfileUrl": "https://pablostanley.gumroad.com/", "sellerIsVerified": false, "searchQuery": "illustration", "scrapedAt": "2026-06-18T12:00:00.000Z" } ``` ```json { "type": "creator", "creatorId": "8530363257615", "name": "Pablo Stanley", "profileUrl": "https://pablostanley.gumroad.com/", "subdomain": "pablostanley.gumroad.com", "isVerified": false, "bio": "Hi, I'm Pabs. I make pixel characters, doodle packs, illustration brushes…", "twitterHandle": "pablostanley", "twitterUrl": "https://twitter.com/pablostanley", "productCount": 13, "topTags": ["illustration", "design", "figma"], "productsScrapedInRun": 3, "totalRatingsScraped": 11240, "website": "https://pablostanley.com/", "email": "hello@pablostanley.com", "socialLinks": { "twitter": "https://twitter.com/pablostanley", "instagram": "https://instagram.com/pablostanley" }, "leadScore": 71, "scrapedAt": "2026-06-18T12:00:00.000Z" } ``` ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it hourly/daily/weekly with **monitor mode** to watch a niche, tag, or creator and capture only new products, price drops, and new sales. The Schedule decides *when* to run; monitor mode decides *what's new* — they work together, no conflict. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/gumroad-scraper').call({ searchQueries: ['stable diffusion'], sort: 'best_selling', maxResults: 200, includeProductDetails: true, includeCreatorLeads: true, enrichCreatorEmails: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} products & creator leads`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new creator leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored niche has new best-sellers. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find the best-selling Notion templates on Gumroad and list their creators' contacts" and let it run this scraper for you. ### More scrapers from scrapesage Build a complete **creator-economy & e-commerce intelligence stack**: - **[Patreon Scraper](https://apify.com/scrapesage/patreon-scraper)** — creators, membership tiers, and earnings estimates. - **[Substack Scraper](https://apify.com/scrapesage/substack-scraper)** — newsletters, posts, and creator leads. - **[Product Hunt Scraper](https://apify.com/scrapesage/product-hunt-scraper)** — launches, makers, and leads. - **[Linktree Scraper](https://apify.com/scrapesage/linktree-scraper)** — creator bio links, emails, and leads. - **[Behance Scraper](https://apify.com/scrapesage/behance-scraper)** — designers and creative projects with for-hire signals. - **[YouTube Scraper](https://apify.com/scrapesage/youtube-scraper)** — channels, videos, and creator leads. - **[Shopify Store Scraper](https://apify.com/scrapesage/shopify-store-scraper)** — products, variants, prices, and merchant leads. - **[Amazon Scraper](https://apify.com/scrapesage/amazon-scraper)** — products, prices, reviews, and sellers. ### Tips - **Browse a whole niche**: leave `searchQueries` empty and pass one or more `tags` (e.g. `notion`, `lightroom-presets`, `stable-diffusion`) to walk a category. Category names like `design`, `3d`, or `business` work as tags too. - **Demand signals**: sort by `best_selling` or `most_reviewed` and read `salesCount` + `ratingCount` together — high reviews with high ratings is the strongest "winning product" signal. - **Cost control**: price/rating/type filters are applied before any detail fetch, so narrowing them keeps runs cheap. Turn off `includeProductDetails` for fast, low-cost discovery. - **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` and a distinct `monitorKey` per saved search to only get what changed. ### FAQ **How do I scrape Gumroad products for a specific niche?** Put keywords in `searchQueries` and/or category niches in `tags` (`notion`, `fitness`, `ai-art`). Combine with `sort` and the price/rating filters to focus on the products you care about. **Does it work without the Gumroad API?** Yes. This actor reads the same public Discover search and product/creator pages a visitor sees — no API key, login, or browser required. **Can I get a product's sales count and rating breakdown?** Yes — with `includeProductDetails` on (default), each product includes `salesCount` and the full `ratingPercentages` 1–5★ histogram alongside `ratingCount` and `ratingAverage`. **Where do the creator emails come from?** Never from Gumroad (it doesn't publish them). With `enrichCreatorEmails` on, the actor visits a creator's own linked website and extracts publicly listed contact emails — the same thing a human visitor would see. **How do I monitor new products automatically?** Turn on `monitorMode`, set a `monitorKey`, and create a [Schedule](https://docs.apify.com/platform/schedules). Each run outputs only new or changed records. Add a [webhook](https://docs.apify.com/platform/integrations/webhooks) to push them into your CRM or Slack. **Is scraping Gumroad legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA for personal data) and Gumroad's terms. **A field is null — why?** Some products genuinely don't set every field (no variants, no attributes, free products with no suggested price). Fields are `null` only when the data doesn't exist, not because the scraper skipped them. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `searchQueries` (type: `array`): Keywords to search Gumroad Discover, e.g. notion template, stable diffusion, trading course. Each query is combined with every tag below (or run on its own). ## `tags` (type: `array`): Gumroad tags or category niches to browse — works on their own or to narrow a search query. Examples: notion, fitness, 3d, stable-diffusion, design, productivity, ebook, lightroom-presets. ## `startUrls` (type: `array`): Direct Gumroad URLs (used in addition to searches): product pages (https://creator.gumroad.com/l/permalink), creator profiles (https://creator.gumroad.com/), or Discover/search pages (https://gumroad.com/discover?query=...). Auto-routed. ## `sort` (type: `string`): Ordering of search/discover results. ## `productType` (type: `array`): Only keep products of these types (leave empty for all). Common values: digital, course, ebook, membership, bundle, physical, audiobook, podcast, commission, call. ## `fileTypes` (type: `array`): Only include products that ship these file types (server-side filter). Examples: pdf, mp4, zip, mp3, epub, docx, png. ## `minPrice` (type: `integer`): Only include products priced at or above this amount (USD). ## `maxPrice` (type: `integer`): Only include products priced at or below this amount (USD). ## `minRating` (type: `integer`): Only include products with an average rating at or above this value (0–5). ## `freeOnly` (type: `boolean`): Only include free or pay-what-you-want products. ## `maxResults` (type: `integer`): Maximum number of products to scrape across all queries and tags. ## `includeProductDetails` (type: `boolean`): Fetch each product's detail JSON for the richest data: sales count, full rating histogram (1–5 stars), full HTML description, variants/tiers, membership pricing, attributes, cover images, refund policy and created/updated dates. One extra fast JSON call per product. Turn off for cheap discovery (cards still include price, rating, seller and type). ## `includeCreatorLeads` (type: `boolean`): In addition to products, push one deduplicated creator record per unique seller (type = "creator") with bio, Twitter/X, product count, run-level sales/ratings, a 0–100 lead score, and optional website + email enrichment. ## `enrichCreatorEmails` (type: `boolean`): For creators that link an external website (in their bio or via a custom domain), crawl up to 3 pages (home + contact/about) for contact emails, phone numbers and extra social links. Gumroad never exposes emails directly — this is the only way to get them. ## `monitorMode` (type: `boolean`): Remember products and creators between runs (in a named key-value store) and emit ONLY new or changed records — new products, price drops/rises, new sales, new ratings. Pairs perfectly with Apify Schedules: the Schedule decides WHEN to run, monitor mode decides WHAT is new. It does not conflict with scheduling. ## `monitorKey` (type: `string`): Name for this monitor's memory. Use a distinct key per saved search/niche so they don't share state (e.g. notion-templates, ai-art). ## `maxConcurrency` (type: `integer`): Maximum parallel requests. ## `proxyConfiguration` (type: `object`): Proxies to use. The default Apify Proxy works well — Gumroad's public endpoints are clean, and rotating IPs avoids per-IP rate limits. Residential proxies are an optional fallback. ## Actor input object example ```json { "searchQueries": [ "notion template" ], "sort": "recommended", "freeOnly": false, "maxResults": 100, "includeProductDetails": true, "includeCreatorLeads": true, "enrichCreatorEmails": false, "monitorMode": false, "monitorKey": "default", "maxConcurrency": 8, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): All scraped product records and optional creator lead records as JSON items in the default dataset. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "notion template" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/gumroad-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["notion template"], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("scrapesage/gumroad-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "notion template" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call scrapesage/gumroad-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/gumroad-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Gumroad Scraper - Products, Creators & Sales", "description": "Scrape Gumroad digital products by keyword, niche or URL: prices, ratings, sales counts, product types, tiers & full descriptions. Get deduplicated creator/seller leads with bio, socials & emails, plus a new-product & price-drop monitor. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "w5f1BCLF3eVCRjy1p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~gumroad-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-gumroad-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapesage~gumroad-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-gumroad-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapesage~gumroad-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-gumroad-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search Gumroad Discover, e.g. notion template, stable diffusion, trading course. Each query is combined with every tag below (or run on its own).", "items": { "type": "string" } }, "tags": { "title": "Tags / niches", "type": "array", "description": "Gumroad tags or category niches to browse — works on their own or to narrow a search query. Examples: notion, fitness, 3d, stable-diffusion, design, productivity, ebook, lightroom-presets.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct Gumroad URLs (used in addition to searches): product pages (https://creator.gumroad.com/l/permalink), creator profiles (https://creator.gumroad.com/), or Discover/search pages (https://gumroad.com/discover?query=...). Auto-routed.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sort": { "title": "Sort by", "enum": [ "recommended", "staff_picked", "best_selling", "most_reviewed", "highest_rated", "newest", "trending", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "Ordering of search/discover results.", "default": "recommended" }, "productType": { "title": "Product types", "type": "array", "description": "Only keep products of these types (leave empty for all). Common values: digital, course, ebook, membership, bundle, physical, audiobook, podcast, commission, call.", "items": { "type": "string" } }, "fileTypes": { "title": "File types", "type": "array", "description": "Only include products that ship these file types (server-side filter). Examples: pdf, mp4, zip, mp3, epub, docx, png.", "items": { "type": "string" } }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Only include products priced at or above this amount (USD)." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Only include products priced at or below this amount (USD)." }, "minRating": { "title": "Min rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only include products with an average rating at or above this value (0–5)." }, "freeOnly": { "title": "Free / pay-what-you-want only", "type": "boolean", "description": "Only include free or pay-what-you-want products.", "default": false }, "maxResults": { "title": "Max products", "minimum": 1, "type": "integer", "description": "Maximum number of products to scrape across all queries and tags.", "default": 100 }, "includeProductDetails": { "title": "Include full product details", "type": "boolean", "description": "Fetch each product's detail JSON for the richest data: sales count, full rating histogram (1–5 stars), full HTML description, variants/tiers, membership pricing, attributes, cover images, refund policy and created/updated dates. One extra fast JSON call per product. Turn off for cheap discovery (cards still include price, rating, seller and type).", "default": true }, "includeCreatorLeads": { "title": "Emit creator / seller leads", "type": "boolean", "description": "In addition to products, push one deduplicated creator record per unique seller (type = \"creator\") with bio, Twitter/X, product count, run-level sales/ratings, a 0–100 lead score, and optional website + email enrichment.", "default": true }, "enrichCreatorEmails": { "title": "Enrich creator emails from their website", "type": "boolean", "description": "For creators that link an external website (in their bio or via a custom domain), crawl up to 3 pages (home + contact/about) for contact emails, phone numbers and extra social links. Gumroad never exposes emails directly — this is the only way to get them.", "default": false }, "monitorMode": { "title": "Monitor mode (only new / changed)", "type": "boolean", "description": "Remember products and creators between runs (in a named key-value store) and emit ONLY new or changed records — new products, price drops/rises, new sales, new ratings. Pairs perfectly with Apify Schedules: the Schedule decides WHEN to run, monitor mode decides WHAT is new. It does not conflict with scheduling.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Name for this monitor's memory. Use a distinct key per saved search/niche so they don't share state (e.g. notion-templates, ai-art).", "default": "default" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum parallel requests.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies to use. The default Apify Proxy works well — Gumroad's public endpoints are clean, and rotating IPs avoids per-IP rate limits. Residential proxies are an optional fallback.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```