{
  "openapi": "3.0.1",
  "info": {
    "title": "Gumroad Scraper — Products, Sellers, Reviews & Creator Emails",
    "description": "Gumroad scraper — products by keyword, tag, category, whole seller storefronts or product URLs. Price/rating/type filters, sales counts, rating histograms, written reviews, creator leads with contact emails, monitor mode for new & changed products. Pure HTTP, JSON or CSV out.",
    "version": "0.0",
    "x-build-id": "JaAWTBf2UN2h2TfDa"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~gumroad-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-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/memo23~gumroad-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-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/memo23~gumroad-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-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's discover catalog (e.g. <code>notion template</code>, <code>lightroom presets</code>, <code>ai course</code>).",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "title": "Tags",
            "type": "array",
            "description": "Browse by Gumroad tag instead of / in addition to free-text search (e.g. <code>notion</code>, <code>design</code>, <code>photography</code>).",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Browse by category path as it appears in Gumroad discover URLs — e.g. <code>design</code>, <code>3d/vrchat</code>, <code>software-development</code>, <code>business-and-money</code>, <code>drawing-and-painting</code>.",
            "items": {
              "type": "string"
            }
          },
          "sellerUrls": {
            "title": "Seller storefront URLs",
            "type": "array",
            "description": "Creator storefront URLs — every product of that creator is scraped (all profile sections, de-duplicated). Works with subdomains (<code>https://seller.gumroad.com</code>) and custom-domain Gumroad stores.",
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "Product URLs",
            "type": "array",
            "description": "Direct Gumroad product URLs (e.g. <code>https://seller.gumroad.com/l/permalink</code> or <code>https://gumroad.com/l/permalink</code>). Fetched directly with full detail, bypassing search and filters.",
            "items": {
              "type": "string"
            }
          },
          "sort": {
            "title": "Sort order",
            "enum": [
              "featured",
              "most_reviewed",
              "highest_rated",
              "newest",
              "hot_and_new",
              "staff_picks",
              "price_asc",
              "price_desc"
            ],
            "type": "string",
            "description": "How search / tag / category results are ordered.",
            "default": "featured"
          },
          "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 (0–5)",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Only include products with an average rating at or above this value. Products with no ratings are excluded when set."
          },
          "nativeTypes": {
            "title": "Product types",
            "type": "array",
            "description": "Only include these product types. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "digital",
                "course",
                "ebook",
                "membership",
                "bundle",
                "podcast",
                "audiobook",
                "newsletter",
                "physical",
                "commission",
                "call",
                "coffee",
                "ticket"
              ],
              "enumTitles": [
                "Digital product",
                "Course / tutorial",
                "E-book",
                "Membership",
                "Bundle",
                "Podcast",
                "Audiobook",
                "Newsletter",
                "Physical good",
                "Commission",
                "Call",
                "Coffee (tip)",
                "Ticket"
              ]
            }
          },
          "fileTypes": {
            "title": "File types",
            "type": "array",
            "description": "Only include products that ship these file types (e.g. <code>pdf</code>, <code>mp4</code>, <code>zip</code>, <code>mp3</code>, <code>epub</code>, <code>psd</code>, <code>blend</code>). Applied server-side by Gumroad.",
            "items": {
              "type": "string"
            }
          },
          "freeOnly": {
            "title": "Free / pay-what-you-want only",
            "type": "boolean",
            "description": "Only include free or pay-what-you-want products.",
            "default": false
          },
          "payWhatYouWantOnly": {
            "title": "Pay-what-you-want only",
            "type": "boolean",
            "description": "Only include products where the buyer sets the price.",
            "default": false
          },
          "sellerVerifiedOnly": {
            "title": "Verified sellers only",
            "type": "boolean",
            "description": "Only include products from verified Gumroad sellers.",
            "default": false
          },
          "scrapeDetails": {
            "title": "Scrape full product details",
            "type": "boolean",
            "description": "When ON, each product's page is fetched to add sales count, full HTML description, rating histogram, variants/tiers, membership billing cycles, covers, attributes and refund policy. Slower and costs more (one extra request per product). When OFF (default), the rich search-card data is returned — much cheaper.",
            "default": false
          },
          "scrapeReviews": {
            "title": "Scrape written reviews",
            "type": "boolean",
            "description": "When ON, written reviews (text, star rating, reviewer name, seller reply) are attached to each product row under <code>reviews</code>. One extra request per ~20 reviews.",
            "default": false
          },
          "maxReviewsPerProduct": {
            "title": "Max reviews per product",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Cap on written reviews fetched per product (only used when 'Scrape written reviews' is on).",
            "default": 20
          },
          "includeSellerRecord": {
            "title": "Emit creator records",
            "type": "boolean",
            "description": "When ON, one <code>type: \"creator\"</code> record is emitted per unique seller encountered — name, bio, bio links, external website, Twitter/X handle, subdomain, verified state, product counts. One extra request per unique creator.",
            "default": false
          },
          "enrichEmails": {
            "title": "Find creator contact emails",
            "type": "boolean",
            "description": "For creators that link an external website (bio link or custom store domain), crawl it for contact emails and payment-stack signals. Adds <code>contactEmail</code>, <code>contactEmails</code> and <code>emailEnrichment</code> to creator records. Implies 'Emit creator records'. Best-effort — creators without an external site yield no email.",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor mode (only new & changed)",
            "type": "boolean",
            "description": "Remember products between runs (in a named key-value store) and only emit records that are NEW or CHANGED since the last run — price moves, new ratings, sales-count changes. Pairs well with a schedule.",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor memory 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. <code>notion-templates</code>, <code>vrchat-avatars</code>).",
            "default": "default"
          },
          "maxItems": {
            "title": "Max products",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of products to return across all inputs (creator records don't count toward this).",
            "default": 1000
          },
          "maxConcurrency": {
            "title": "Request concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many detail / review / creator pages to fetch in parallel.",
            "default": 6
          },
          "proxy": {
            "title": "Proxy configuration (optional)",
            "type": "object",
            "description": "Optional. Set only if you hit rate limits."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}