This README is designed to look professional on the Apify Store or GitHub. It highlights the "Inertia.js Unpacker" technology, which is your unique selling point for getting data that other scrapers miss.

---

Gumroad Deep Metadata Scraper 🚀

A high-performance, professional-grade web scraper designed to extract comprehensive data from Gumroad. Unlike basic scrapers that only capture search results, this tool uses Inertia.js State Unpacking to retrieve deep metadata, including licensing options, exact sales counts, full resolution covers, and product attributes.

🌟 Key Features

• Deep Extraction: Unpacks the hidden #app data state to get 1:1 data parity with the browser.
• Licensing & Variants: Capture all product options (e.g., Basic vs. Commercial licenses) with calculated total prices.
• Sales & Ratings: Access sales_count (when public) and detailed star-rating breakdowns.
• SEO Optimized: Extracts tags, categories, and full HTML descriptions for market research.
• High Speed: Built with got-scraping and asynchronous "chunk-based" parallelism for maximum throughput without IP bans.
• Flexible Input: Supports both keyword-based discovery and direct URL lists.

---

📥 Input Parameters

The actor accepts the following configuration via a user-friendly UI or JSON:

Field	Type	Description	Default
Search Query	String	Keyword to discover products (e.g., "SaaS Template")	software
Category	Enum	Filters search by Gumroad's official categories	all_products
Direct URLs	Array	List of specific product URLs to scrape directly	[]
Deep Scrape	Boolean	If enabled, visits individual pages for full metadata	true
Max Pages	Integer	Number of search result pages to process	3

---

To complete your professional documentation, here are two specific JSON input examples formatted for your README. These show how the scraper behaves in "Search Mode" versus "Direct Product Mode."

---

📂 Input Examples

1. Discovery Mode (Category & Keyword Search)

Use this configuration to find new trending products within a specific niche. This will crawl the discovery pages and perform a deep dive into each result found.

{
    "query": "minimalist dashboard",
    "category": "design",
    "scrapeDetails": true,
    "maxPages": 3,
    "productUrls": []
}

2. Target Mode (Direct Product URLs)

Use this when you have a specific list of competitors or products you want to monitor. This bypasses the search engine and goes straight to the source for 1:1 data extraction.

{
    "query": "",
    "category": "all_products",
    "scrapeDetails": true,
    "maxPages": 1,
    "productUrls": [
        "https://aipbi.gumroad.com/l/Cash_Million_Dollar_Playbook",
        "https://levelsio.gumroad.com/l/photo-ai"
    ]
}

---

📊 Output Examples

1. Discovery Output (Summary)

When scrapeDetails is set to false, you get a lightweight dataset optimized for speed:

{
    "id": "4CbXhPK-IvPPhMrUoYapHg==",
    "name": "Cash's Million Dollar Playbook",
    "seller": {
        "name": "AIPBI",
        "profile_url": "https://aipbi.gumroad.com"
    },
    "price": 47.00,
    "currency": "usd",
    "url": "https://gumroad.com/l/xeefz"
}

2. Deep Product Output (Full Metadata)

When scrapeDetails is true, the scraper unpacks the Inertia.js state to provide the "Full Boss" dataset:

{
    "id": "4CbXhPK-IvPPhMrUoYapHg==",
    "name": "Cash's Million Dollar Playbook",
    "description_html": "<p><strong>\"Cash's Million Dollar Playbook\"</strong> is a guide...</p>",
    "seller": {
        "name": "AIPBI",
        "twitter": "sales_guru",
        "profile_url": "https://aipbi.gumroad.com"
    },
    "price": 47.00,
    "currency": "usd",
    "sales_count": 1240,
    "ratings": {
        "average": 5,
        "count": 1,
        "percentages": [0, 0, 0, 0, 100]
    },
    "covers": [
        {
            "url": "https://public-files.gumroad.com/y8ozbd8w3k7myd1e2x37ito6ary0",
            "type": "image",
            "width": 670,
            "height": 373
        }
    ],
    "attributes": [
        { "name": "Size", "value": "103 KB" },
        { "name": "Length", "value": "18 pages" }
    ],
    "options": [
        { "name": "Standard License", "total_price": 47.00 },
        { "name": "Resell Rights", "total_price": 297.00 }
    ],
    "tags": ["sales", "playbook", "automotive"],
    "native_type": "digital",
    "url": "https://gumroad.com/l/xeefz"
}