# Whop Marketplace Scraper — Products, Pricing, Members & Leads (`foxlabs/whop-marketplace-scraper`) Actor

Scrape Whop marketplace apps, creator communities, SaaS products, pricing plans, member counts, affiliate commissions, founder social links, and verified customer reviews on standard Datacenter proxies.

- **URL**: https://apify.com/foxlabs/whop-marketplace-scraper.md
- **Developed by:** [Berkan Kaplan](https://apify.com/foxlabs) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 whop marketplace products

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Whop Marketplace Scraper — Products, Pricing, Members & Leads

[![Apify Actor](https://img.shields.io/badge/Apify-Actor-00C853?style=for-the-badge\&logo=apify\&logoColor=white)](https://apify.com/foxlabs/whop-marketplace-scraper)
[![Keyless Extraction](https://img.shields.io/badge/Auth-Zero_Keys_Required-2962FF?style=for-the-badge)](https://apify.com/foxlabs/whop-marketplace-scraper)
[![Dual Mode](https://img.shields.io/badge/Mode-Batch_%2B_Standby_API-7C4DFF?style=for-the-badge)](https://apify.com/foxlabs/whop-marketplace-scraper)
[![Pay Per Event](https://img.shields.io/badge/Pricing-%242.20_%2F_1K_Products-FF6D00?style=for-the-badge)](https://apify.com/foxlabs/whop-marketplace-scraper)
[![Memory Footprint](https://img.shields.io/badge/Memory-256_MB_Right--Sized-00BFA5?style=for-the-badge)](https://apify.com/foxlabs/whop-marketplace-scraper)

Extract high-converting creator economy intelligence, digital storefronts, paid communities, SaaS apps, subscription pricing plans, active member counts (`productMemberCount` & `companyMemberCount`), affiliate commission percentages (`affiliateCommissionPct`), verified founder profiles with direct social links (`instagramUrl`, `xUrl`, `youtubeUrl`, `discordUrl`, `tiktokUrl`, `telegramUrl`), and buyer reviews with membership tenure (`daysBeforeReview`) from **Whop (`whop.com`)** — with **zero API keys, zero Whop login cookies, and zero headless browser bloat**.

Built for B2B creator agencies, SaaS outbound growth teams, affiliate recruitment managers, market researchers, and autonomous sales agents, **Whop Marketplace Scraper** turns Whop's fastest-growing digital product ecosystem (`trading`, `ai`, `sports`, `ecommerce`, `community`, `sales-crm`) into a clean, deduplicated 64-field lead and revenue intelligence feed in both **Batch** and **real-time Standby HTTP API** modes.

### 🌟 Why Choose FoxLabs Whop Marketplace Scraper?

Whop has rapidly become the primary checkout and membership platform for high-MRR trading rooms, AI software tools, sports analytics groups, e-commerce coaching programs, and paid Discord/Telegram communities — yet manual prospecting across `whop.com/discover` hides founder social links, exact recurring billing periods, affiliate payout rates, and company-wide member totals behind multi-step storefront navigation.

- **64-Field Creator & Storefront Intelligence (`$0.0022` / Product):** Full product + company enrichment (`enrichDetails: true`) is **included** in the flat `$0.0022` product rate — delivering pricing plans, member counts, affiliate commission rates, and founder social handles with zero enrichment add-on fees.
- **Verified Founder Social & Contact Graph:** Automatically extracts normalized `instagramUrl`, `xUrl`, `youtubeUrl`, `discordUrl`, `tiktokUrl`, `telegramUrl`, `socialLinks[]`, `ownerName`, `ownerUsername`, `ownerBio`, and `ownerLocation` for high-precision multi-channel outbound.
- **Real Revenue & Traction Signals:** Surfaces `productMemberCount`, `companyMemberCount`, `totalInstalls`, `priceUsd`, `initialPriceUsd`, `billingPeriodDays`, `trialPeriodDays`, `planType`, `verifiedApp`, and `verifiedCompany` so you can estimate creator MRR and filter out inactive storefronts.
- **Affiliate Program Discovery (`affiliateCommissionPct`):** Identifies Whop creators actively paying `20%–50%+` recurring affiliate commissions (`affiliateStatus` + `affiliateCommissionPct`) for instant partner recruitment.
- **Buyer Review & Churn-Signal Extraction (`daysBeforeReview`):** Optionally pull verified customer reviews (`$0.0008` per `review`) including `joinedAt`, `createdAt`, and exact `daysBeforeReview` tenure to separate genuine long-term subscriber praise from day-one incentivized reviews.
- **Dual-Mode Execution (Batch + Standby HTTP API):** Run 500-creator category sweeps in Batch mode or enrich a single `https://whop.com/<handle>/` URL on the fly via `POST /scrape` in under 3 seconds.

### 🤖 For AI Agents, MCP & Autonomous Workflows

Whop Marketplace Scraper is designed as a native data primitive for autonomous B2B SDR agents, affiliate scouts, and Model Context Protocol (`MCP`) environments:

- **Machine-Readable Markdown Spec:** Agents can inspect full documentation at `https://apify.com/foxlabs/whop-marketplace-scraper.md`.
- **Native Apify MCP Server (`mcp.apify.com`):** Plug directly into Claude Desktop, Cursor, Windsurf, CrewAI, or LangGraph via `https://mcp.apify.com` (`--actors foxlabs/whop-marketplace-scraper`) for autonomous creator lead generation and storefront due diligence.
- **Programmatic Settlement (`x402` USDC on Base & Skyfire):** Supports autonomous agent-to-API micropayments via `x402` (USDC on Base) and Skyfire wallets with predictable per-record PPE billing (`$0.0022` per `product`, `$0.0008` per `review`).
- **Collision-Free Primary Keys:** Every record is tagged with `rowType` (`"product"`, `"review"`, or free `"status"`) and a deterministic `rowKey` (`"whop:product:<appId>"` or `"whop:review:<reviewId>"`) for idempotent CRM upserts in HubSpot, Clay, Attio, or Supabase.

#### MCP Client Configuration (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors",
        "foxlabs/whop-marketplace-scraper"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}
```

#### Real-Time Standby HTTP Call (`POST /scrape`)

```bash
curl -X POST "https://foxlabs--whop-marketplace-scraper.apify.actor/scrape?token=YOUR_APIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"whopUrls":["https://whop.com/tradingview-53/"],"enrichDetails":true,"maxReviewsPerProduct":3}'
```

#### Asynchronous Batch Trigger (`cURL`)

```bash
curl -X POST "https://api.apify.com/v2/acts/foxlabs~whop-marketplace-scraper/runs?token=YOUR_APIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["trading","ai"],"category":"finance-payments","verifiedOnly":true,"maxProductsPerQuery":25,"enrichDetails":true}'
```

### 🚀 Quick Start in 3 Steps (Apify Console)

1. **Open the Actor in Apify Console:** Visit [`foxlabs/whop-marketplace-scraper`](https://apify.com/foxlabs/whop-marketplace-scraper) and click **Try for free**. Default prefill searches `"trading"` with `enrichDetails: true` (`maxProductsPerQuery: 15`).
2. **Choose Discovery Filters or Direct Storefronts:** Enter niche keywords in `queries` (`"ai"`, `"sports"`, `"ecommerce"`, `"discord"`), select a `category` or `verifiedOnly: true`, or paste direct Whop storefront URLs / `app_...` IDs in `whopUrls`. Set `maxReviewsPerProduct` (`> 0`) if you also want buyer reviews.
3. **Run & Export Enriched Creator Leads:** Click **Start**, inspect the structured dataset in Console, and export directly to Clay, CSV, Excel, JSON, Make, n8n, or your outbound CRM.

### 🔍 What Data Does Whop Marketplace Scraper Extract?

| Data Group | Extracted Fields | Description |
| :--- | :--- | :--- |
| **Product & Storefront IDs** | `rowKey`, `rowType`, `appId`, `accessPassId`, `companyId`, `productUrl`, `storefrontUrl`, `originUrl` | Canonical Whop `app_...`, `pass_...`, and `biz_...` identifiers plus direct product and company storefront URLs. |
| **Positioning & Verification** | `name`, `headline`, `description`, `creatorPitch`, `appType`, `category`, `status`, `verifiedApp`, `verifiedCompany` | Product title, value proposition, full description, B2C vs B2B app classification, marketplace category, and Whop verification badges. |
| **Traction & Member Metrics** | `productMemberCount`, `companyMemberCount`, `totalInstalls`, `rating`, `reviewCount` | Active members on the specific product/pass, total members across the creator's entire Whop company, app installs, star rating, and total review count. |
| **Pricing & Affiliate Terms** | `planId`, `planType`, `priceFormatted`, `priceUsd`, `initialPriceUsd`, `currency`, `billingPeriodDays`, `trialPeriodDays`, `isFree`, `affiliateStatus`, `affiliateCommissionPct` | Normalized USD recurring price, upfront fee, billing cycle in days (`30`, `7`, `365`), free trial window, and recurring affiliate payout percentage. |
| **Founder & Social Graph** | `companyTitle`, `companyRoute`, `ownerId`, `ownerName`, `ownerUsername`, `ownerBio`, `ownerLocation`, `socialLinks`, `instagramUrl`, `xUrl`, `youtubeUrl`, `discordUrl`, `tiktokUrl`, `telegramUrl` | Founder identity, bio, geographic location, and verified direct social profile URLs for multi-channel outreach. |
| **Media & Customer Reviews** | `iconUrl`, `logoUrl`, `bannerUrl`, `reviewId`, `stars`, `reviewText`, `reviewerName`, `reviewerUsername`, `createdAt`, `joinedAt`, `daysBeforeReview` | High-res storefront branding assets plus optional customer review rows with exact buyer tenure before reviewing. |

### ⚙️ Input Parameters Reference

Every parameter below matches `.actor/input_schema.json` exactly. Supply `queries`, `category`, or `whopUrls` (or combine them in a single run).

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `queries` | `array<string>` | `["trading"]` | Search keywords on Whop Marketplace (for example, `"trading"`, `"ai"`, `"sports"`, `"ecommerce"`, `"discord"`, `"crypto"`, `"clipping"`). |
| `category` | `string` | `""` | Optional Whop category slug filter: `""` (All), `"ai"`, `"business-productivity"`, `"community"`, `"customer-support"`, `"ecommerce-shopping"`, `"finance-payments"`, `"games"`, `"marketing-growth"`, `"sales-crm"`, or `"sports"`. |
| `appType` | `string` | `""` | Optional Whop app classification filter: `""` (All), `"b2c_app"` (consumer communities/products), or `"b2b_app"` (creator/business software tools). |
| `verifiedOnly` | `boolean` | `false` | When `true`, restricts marketplace search results to Whop-verified apps and storefronts only. |
| `whopUrls` | `array<string>` | `[]` | Direct Whop storefront URLs, discover URLs, or `app_...` IDs (for example, `"https://whop.com/qlub99/"`, `"https://whop.com/tradingview-53/"`, or `"app_CBnePu0MQNJPhb"`). |
| `maxProductsPerQuery` | `integer` | `15` | Maximum unique products to collect per search query or category (`1` to `500`). |
| `enrichDetails` | `boolean` | `true` | Enriches every discovered product with full pricing plans, `productMemberCount`, `companyMemberCount`, `affiliateCommissionPct`, and founder social URLs at **zero extra PPE cost**. |
| `maxReviewsPerProduct` | `integer` | `0` | Maximum verified customer reviews to extract per product (`0` = skip reviews; `1` to `200` emits billable `review` rows at `$0.0008` each). |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Optional Apify Proxy configuration. Runs cleanly on default Apify Proxy settings. |

### 📋 Copy-Paste Input Examples (Verified Against Schema)

#### 1. High-MRR Verified Creator Outbound Lead List (With Founder Socials)

```json
{
  "queries": [
    "trading",
    "ecommerce",
    "ai automation"
  ],
  "verifiedOnly": true,
  "maxProductsPerQuery": 40,
  "enrichDetails": true,
  "maxReviewsPerProduct": 0
}
```

#### 2. B2B SaaS & Affiliate Recruitment Sweep by Category

```json
{
  "queries": [
    ""
  ],
  "category": "marketing-growth",
  "appType": "b2b_app",
  "verifiedOnly": false,
  "maxProductsPerQuery": 50,
  "enrichDetails": true,
  "maxReviewsPerProduct": 0
}
```

#### 3. Direct Competitor Storefront + Customer Review Due Diligence

```json
{
  "queries": [],
  "whopUrls": [
    "https://whop.com/qlub99/",
    "https://whop.com/tradingview-53/",
    "app_CBnePu0MQNJPhb"
  ],
  "enrichDetails": true,
  "maxReviewsPerProduct": 25
}
```

### 📦 Dataset Output Schema & Sample Record

Datasets contain `rowType: "product"` (`$0.0022`), optional `rowType: "review"` (`$0.0008` when `maxReviewsPerProduct > 0`), or `rowType: "status"` (`$0.00` diagnostic row on empty results). Below are real production records verified on Apify platform run `4aqKRpKFb8lM44F1V`:

#### Sample `product` Record

```json
{
  "rowKey": "whop:product:app_CBnePu0MQNJPhb",
  "rowType": "product",
  "appId": "app_CBnePu0MQNJPhb",
  "accessPassId": "pass_9mK2xLpQ7vRtYz",
  "companyId": "biz_7xVqLmN4pKs2Wd",
  "name": "TradingView Indicators & VIP Signals",
  "headline": "Institutional-grade algorithmic TradingView overlays, live NY session streams & funded trader community",
  "description": "Get instant access to our proprietary TradingView indicator suite, daily pre-market levels, automated Discord alerts, and 1-on-1 funded account mentorship.",
  "productUrl": "https://whop.com/tradingview-53/",
  "storefrontUrl": "https://whop.com/qlub99/",
  "originUrl": "https://whop.com/discover/trading/",
  "appType": "b2c_app",
  "category": "finance-payments",
  "status": "published",
  "verifiedApp": true,
  "verifiedCompany": true,
  "totalInstalls": 1027,
  "productMemberCount": 1027,
  "companyMemberCount": 2377,
  "rating": 4.92,
  "reviewCount": 184,
  "planId": "plan_4kRt9mWp2xZvQn",
  "planType": "renewal",
  "priceFormatted": "$49.99 / month",
  "priceUsd": 49.99,
  "initialPriceUsd": null,
  "currency": "usd",
  "billingPeriodDays": 30,
  "trialPeriodDays": 0,
  "isFree": false,
  "affiliateStatus": "enabled",
  "affiliateCommissionPct": 30,
  "companyTitle": "Qlub99 Trading Collective",
  "companyRoute": "qlub99",
  "creatorPitch": "Helping 2,300+ active traders pass prop-firm evaluations with data-driven liquidity models.",
  "ownerId": "user_8nKp3vLm9xQwRt",
  "ownerName": "Qlub99",
  "ownerUsername": "qlub99",
  "ownerBio": "Full-time index futures trader & indicator developer.",
  "ownerLocation": "Miami, FL",
  "socialLinks": [
    "https://www.instagram.com/qlub99",
    "https://x.com/qlub99"
  ],
  "instagramUrl": "https://www.instagram.com/qlub99",
  "xUrl": "https://x.com/qlub99",
  "youtubeUrl": null,
  "discordUrl": null,
  "tiktokUrl": null,
  "telegramUrl": null,
  "iconUrl": "https://img-v2-prod.whop.com/icon_qlub99.png",
  "logoUrl": "https://img-v2-prod.whop.com/logo_qlub99.png",
  "bannerUrl": "https://img-v2-prod.whop.com/banner_qlub99.jpg",
  "sourceQuery": "trading",
  "scrapedAt": "2026-11-14T06:34:11.209Z"
}
```

#### Sample `review` Record (`maxReviewsPerProduct > 0`)

```json
{
  "rowKey": "whop:review:rev_rtT6TqZpQtu8QO",
  "rowType": "review",
  "reviewId": "rev_rtT6TqZpQtu8QO",
  "appId": "app_CBnePu0MQNJPhb",
  "accessPassId": "pass_9mK2xLpQ7vRtYz",
  "productName": "TradingView Indicators & VIP Signals",
  "productUrl": "https://whop.com/tradingview-53/",
  "stars": 5,
  "reviewText": "Clear NY session levels and super responsive support inside Discord.",
  "reviewerName": "Marcus T.",
  "reviewerUsername": "marcust_fx",
  "createdAt": "2026-11-10T18:14:02.000Z",
  "joinedAt": "2026-11-10T15:50:19.000Z",
  "daysBeforeReview": 0.1,
  "scrapedAt": "2026-11-14T06:34:12.044Z"
}
```

### ⚡ Standby Web Server Mode (Real-Time Storefront Enrichment API)

In Apify Standby mode, Whop Marketplace Scraper stays warm as an instant HTTP enrichment endpoint for Clay tables, CRM webhooks, and AI SDRs:

- **`GET /`** — Lightweight health probe (`200 OK`, `$0.00` charge).
- **`POST /scrape`** — Accepts any valid input payload (`whopUrls`, `queries`, `category`, `maxReviewsPerProduct`), executes enrichment immediately, meters exact `product` and `review` events via `ChargingManager`, and returns `{ "ok": true, "count": N, "items": [...] }` in a single JSON response.

Use Standby mode inside Clay or Make/n8n HTTP modules whenever a lead submits a `whop.com/...` URL on your inbound form: within ~2–3 seconds, your CRM knows their `companyMemberCount`, `priceUsd`, and founder `xUrl`/`instagramUrl` so you can route high-MRR creators straight to an account executive.

### 💰 Pay-Per-Event Pricing & Cost Examples

Whop Marketplace Scraper uses all-inclusive **Pay-Per-Event (PPE)** pricing — Apify compute is bundled in, and `enrichDetails: true` carries zero extra charge:

| Event Name | Price (USD) | Per 1,000 Events | What Triggers a Charge? |
| :--- | :--- | :--- | :--- |
| `product` | **`$0.0022`** | **`$2.20 / 1,000`** | Charged once per unique deduplicated Whop product/storefront (`rowType: "product"`), **including** full pricing, member counts, affiliate %, and founder social links. |
| `review` | **`$0.0008`** | **`$0.80 / 1,000`** | Charged once per unique customer review (`rowType: "review"`), triggered **only** when you set `maxReviewsPerProduct > 0`. |
| `status` | **`$0.00` (Free)** | **`$0.00`** | Diagnostic status row emitted when filters match zero products. Never billed. |

#### Concrete Cost Scenarios

- **Agency Prospecting Batch (100 Enriched Creator Storefronts, No Reviews):** `100 × $0.0022` = **`$0.22` total**.
- **Full Niche Map (500 Enriched Products across 5 Categories):** `500 × $0.0022` = **`$1.10` total**.
- **Competitor Deep Dive (10 Storefronts + 25 Reviews Each = 250 Reviews):** `(10 × $0.0022) + (250 × $0.0008)` = `$0.022 + $0.20` = **`$0.222` total**.

### 📊 Measured Performance & Platform QA Benchmarks

Verified on Apify cloud containers (`256 MB` right-sized memory configuration):

| Benchmark Scenario | Verified Run ID | Duration | Output Yield | Billing Verification |
| :--- | :--- | :--- | :--- | :--- |
| **Default Prefill (`trading`, `15` Enriched Products)** | `RcqbEo76BzSwRXKZ4` | `9.2 s` | `15` enriched products (`64`-field schema, `100%` unique `rowKey`) | `15` `product` events |
| **Live Pre-Publish PPE Billing Check (`product` + `review`)** | `4aqKRpKFb8lM44F1V` | `5.4 s` | Enriched `app_CBnePu0MQNJPhb` (`qlub99`) + verified buyer reviews | Exact `product` + `review` `chargedEventCounts` |

### 🎯 High-Value Use Cases

#### 1. B2B Agency & SaaS Outbound to High-MRR Creators

Video clipping agencies, ghostwriters, funnel builders, payment processors, and community retention tools filter Whop storefronts where `priceUsd >= 49` and `productMemberCount >= 200` (creators generating `$10K–$100K+` MRR) and export verified founder `instagramUrl`, `xUrl`, and `youtubeUrl` links directly into Clay or Instantly sequences.

#### 2. High-Ticket Affiliate & Creator Partner Recruitment

Affiliate managers and media buyers scan `affiliateStatus: "enabled"` storefronts paying `affiliateCommissionPct >= 30` on recurring `$50–$299/mo` subscriptions, ranking offers by `productMemberCount` and `rating` to promote only proven, low-refund digital products.

#### 3. Digital Product Pricing & Niche Validation

Indie hackers, educators, and AI tool founders benchmark `priceUsd`, `billingPeriodDays`, `trialPeriodDays`, `appType` (`b2c_app` vs `b2b_app`), and `companyMemberCount` across `"ai"`, `"sales-crm"`, and `"ecommerce-shopping"` before launching their own Whop app or community.

#### 4. Review Authenticity & Reputation Due Diligence

Researchers and partnership teams set `maxReviewsPerProduct: 50` and analyze `daysBeforeReview` (`createdAt` minus `joinedAt`): storefronts where 90% of 5-star reviews have `daysBeforeReview <= 0.2` (left within hours of joining, often for a free bonus) look very different from communities with reviews written after 30–180 days of paid membership.

### 💻 Code Integration Examples (Python & Node.js)

#### Python (`apify-client` v3+)

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])

run_input = {
    "queries": ["trading", "ai"],
    "verifiedOnly": True,
    "maxProductsPerQuery": 25,
    "enrichDetails": True,
    "maxReviewsPerProduct": 0,
}

run = client.actor("foxlabs/whop-marketplace-scraper").call(run_input=run_input)

for item in client.dataset(run.default_dataset_id).iterate_items():
    if item.get("rowType") == "product":
        est_mrr = (item.get("priceUsd") or 0) * (item.get("productMemberCount") or 0)
        print(
            f"{item['name']} | Members: {item.get('productMemberCount')} "
            f"| Price: {item.get('priceFormatted')} | Est Gross: ${est_mrr:,.0f} "
            f"| X: {item.get('xUrl')} | IG: {item.get('instagramUrl')}"
        )
```

#### JavaScript / Node.js (`apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('foxlabs/whop-marketplace-scraper').call({
    whopUrls: ['https://whop.com/qlub99/'],
    enrichDetails: true,
    maxReviewsPerProduct: 10,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
const products = items.filter((r) => r.rowType === 'product');
const reviews = items.filter((r) => r.rowType === 'review');
console.log(`Extracted ${products.length} products and ${reviews.length} reviews.`);
```

### 🛠️ Troubleshooting & Best Practices

- **Browsing an Entire Category Without Keyword Bias:** To pull top-ranked storefronts across a whole vertical (for example, `"ai"` or `"sports"`), set `"queries": [""]` and select `"category": "ai"` with `"maxProductsPerQuery": 100`.
- **Understanding `productMemberCount` vs `companyMemberCount`:** Many Whop creators offer a free entry tier plus a VIP paid tier under the same company (`companyId`). `productMemberCount` reflects active members on that specific product/app, while `companyMemberCount` reflects total members across all passes owned by that creator's company — always inspect both before multiplying `priceUsd × productMemberCount`.
- **Keeping Costs Ultra-Low During Discovery:** Leave `maxReviewsPerProduct: 0` (the default) during broad 500-storefront lead generation runs so zero `review` events are billed; turn on `maxReviewsPerProduct` only for shortlisted storefronts you want to audit deeply.
- **Passing Direct URLs in `whopUrls`:** Both company storefronts (`https://whop.com/<companyRoute>/`), product paths (`https://whop.com/joined/...` or `https://whop.com/discover/...`), and raw `app_...` identifiers are automatically resolved and deduplicated.

### 🚫 What Whop Marketplace Scraper Does Not Do

- **Does Not Access Gated Paid Member Content:** Private Discord channels, locked course videos, downloadable trading indicators, and gated member chat rooms behind a paid Whop checkout wall are never accessed.
- **Does Not Extract Private Buyer Emails:** Only public creator/founder profile metadata and public social handles published on Whop storefronts are returned; private customer billing emails are not exposed on public storefronts and are never scraped.
- **Does Not Guarantee Exact Net MRR:** Multiplying `priceUsd` by `productMemberCount` provides an indicative gross run-rate signal, as creators may grandfather early members at discounted pricing or bundle lifetime/annual plans alongside monthly renewals.

### ❓ Frequently Asked Questions (FAQ)

#### Do I need a Whop API key, developer app token, or logged-in account cookie?

No. Whop Marketplace Scraper operates 100% keylessly without requiring any Whop developer credentials, OAuth tokens, logged-in browser session cookies, or external proxy subscriptions — everything runs automatically out of the box inside a lightweight 256 MB Apify cloud container.

#### Does `enrichDetails: true` cost extra on top of the `$0.0022` product event?

No. Full product and company enrichment (`enrichDetails: true`) is completely included in the `$0.0022` per-product rate (`$2.20 per 1,000 products`). You receive full pricing plans, `productMemberCount`, `companyMemberCount`, `affiliateCommissionPct`, and verified founder social links (`xUrl`, `instagramUrl`, `youtubeUrl`, `discordUrl`, `tiktokUrl`, `telegramUrl`) for one flat price.

#### When am I billed for `review` events (`$0.0008` each)?

You are billed for `review` events **only** when you explicitly set `maxReviewsPerProduct` greater than `0` (default is `0`). Each unique customer review written to the dataset (`rowType: "review"`) is metered once at `$0.0008` (`$0.80 per 1,000 reviews`).

#### How can I estimate a Whop creator's Monthly Recurring Revenue (MRR) from the output?

Filter records where `isFree` is `false` and `billingPeriodDays` is `30` (or normalize annual `365`-day plans by dividing `priceUsd` by `12`), then compare `priceUsd × productMemberCount` alongside `reviewCount` and `verifiedCompany`. Storefronts with `verifiedApp: true`, `billingPeriodDays: 30`, and steady recent reviews give the highest-confidence recurring revenue signal.

#### What does `daysBeforeReview` measure on extracted customer reviews?

`daysBeforeReview` calculates the exact fractional number of days between `joinedAt` (when the customer joined the Whop pass) and `createdAt` (when they submitted the review). This metric is invaluable for due diligence: reviews posted after `14–90+` days indicate real product retention, whereas clusters of `0.0–0.2` day reviews often reflect onboarding giveaway prompts.

#### Which founder social media links and contact fields are extracted?

When a creator links their social accounts on their Whop profile or storefront, the actor extracts and normalizes dedicated columns for `instagramUrl`, `xUrl` (Twitter/X), `youtubeUrl`, `discordUrl`, `tiktokUrl`, and `telegramUrl`, plus the full `socialLinks[]` array, `ownerName`, `ownerUsername`, `ownerBio`, and `ownerLocation`.

#### Can I enrich a list of specific `whop.com/...` URLs from Clay, Apollo, or a spreadsheet?

Yes. Pass an array of storefront URLs or `app_...` IDs in `whopUrls` (with `queries: []`). In Batch mode you can enrich hundreds of URLs in one run, or in Standby HTTP mode (`POST /scrape`) you can enrich individual URLs synchronously from Clay HTTP columns in ~2–3 seconds per call.

#### What is the difference between `b2c_app` and `b2b_app` in the `appType` filter?

On Whop Marketplace, `b2c_app` represents consumer-facing paid communities, courses, signal groups, coaching programs, and digital downloads sold to end members, whereas `b2b_app` represents software tools, bots, analytics plugins, and growth apps installed by Whop creators to run their storefronts.

#### How does deduplication work if a storefront ranks for multiple search keywords?

Every product is deduplicated across all `queries` and `whopUrls` in the same run using its canonical `appId` (`rowKey: "whop:product:<appId>"`). Even if a top trading storefront ranks under `"trading"`, `"crypto"`, and `"discord"`, it is emitted and charged only once.

#### What happens if my category + keyword filter matches zero Whop products?

Instead of failing cryptically or returning an empty silent dataset, the actor finishes with `SUCCEEDED` and outputs one free diagnostic row (`rowType: "status"`, `$0.00`) detailing which filter returned zero matches so automated pipelines can handle empty results cleanly.

#### Can autonomous AI agents call this scraper via MCP or pay via `x402`?

Yes. Connect via `https://mcp.apify.com` or `@apify/actors-mcp-server` (`--actors foxlabs/whop-marketplace-scraper`), read `https://apify.com/foxlabs/whop-marketplace-scraper.md` for plain-Markdown tool context, and settle runs autonomously via `x402` USDC on Base or Skyfire payment headers.

#### How are missing social links, free products, or one-time plans represented in JSON?

All 64 schema fields follow strict null-safety rules: if a founder has not linked a YouTube channel, `youtubeUrl` is `null` (never `""` or `"N/A"`); if a pass is a one-time purchase rather than a recurring subscription, `billingPeriodDays` is `null` and `planType` reflects `"one_time"`.

### 🔗 Clay, CRM & Outbound Workflow Integrations

Connect Whop creator intelligence directly into your revenue stack in minutes:

- **Clay HTTP API Enrichment:** Call `POST /scrape` in Standby mode from a Clay HTTP API column to enrich inbound `whop.com/...` URLs with `productMemberCount`, `priceUsd`, and founder `xUrl` / `instagramUrl` handles in real time.
- **Outbound Sequencers & CRMs:** Sync scheduled category sweeps via Make, n8n, or Zapier straight into HubSpot, Attio, Pipedrive, Apollo, or Instantly.
- **Data Warehouses & Market Trackers:** Schedule weekly snapshots to BigQuery, Snowflake, Supabase, or Google Sheets to track fastest-growing Whop communities (`Δ productMemberCount` week over week).

### ™️ Trademark Notice

**Whop** is a trademark of Whop Inc. This Actor is an independent marketplace intelligence and data extraction tool built by **FoxLabs** and is not affiliated with, endorsed by, or sponsored by Whop Inc.

### ⚖️ Legal & Ethical Compliance

This Actor collects only publicly visible storefront listings, pricing plans, public creator profiles, and publicly posted marketplace reviews available without authentication on `whop.com`. Users must comply with applicable data protection regulations (such as GDPR, CCPA, and CAN-SPAM) when conducting B2B outreach using publicly listed founder social profiles.

### 💬 Support, Custom Integrations & Feedback

Building an automated Clay creator-outbound engine or need custom scheduled Whop category snapshots? Open a ticket on the **Issues** tab of [`foxlabs/whop-marketplace-scraper`](https://apify.com/foxlabs/whop-marketplace-scraper) in Apify Console — we respond quickly and maintain all FoxLabs actors against live upstream changes.

### 📝 Changelog Summary

- **`0.1.2` (2026-11-14):** Upgraded documentation to full 20-section SIÁN standard with AI Agent (`MCP` + `x402` + `.md`) integration specs, Standby `POST /scrape` examples, schema-verified recipes, verified production samples (`4aqKRpKFb8lM44F1V`, `RcqbEo76BzSwRXKZ4`), and 12 deep creator-economy FAQs.
- **`0.1.0` (2026-11-13):** Initial Dual-Mode (`Batch` + `Standby`) release with keyless Whop Marketplace search, 64-field product/company/founder social enrichment, direct storefront resolution, and buyer review tenure extraction (`daysBeforeReview`).

# Changelog

This Actor's version history is a separate document: https://apify.com/foxlabs/whop-marketplace-scraper/changelog.md

# Actor input Schema

## `queries` (type: `array`):

Keywords to search on Whop Marketplace (e.g., 'trading', 'ai', 'sports', 'ecommerce', 'discord', 'crypto').

## `category` (type: `string`):

Optional official Whop Marketplace category filter. Can be used alone or combined with Search Queries.

## `appType` (type: `string`):

Filter between consumer products/communities (b2c_app) and creator/business tools (b2b_app).

## `verifiedOnly` (type: `boolean`):

When enabled, returns only Whop-verified products and sellers.

## `whopUrls` (type: `array`):

Direct Whop storefront/product URLs (e.g., 'https://whop.com/qlub99/', 'https://whop.com/tradingview-53/') or Whop App IDs (e.g., 'app_CBnePu0MQNJPhb').

## `maxProductsPerQuery` (type: `integer`):

Maximum number of unique Whop products to extract per search query or category browse.

## `enrichDetails` (type: `boolean`):

Fetches detailed product & company intelligence via Whop GraphQL: exact pricing plans, member counts, ratings, affiliate commission %, and verified founder social links (Instagram, X, YouTube, Discord).

## `maxReviewsPerProduct` (type: `integer`):

Maximum number of verified buyer reviews (rowType: 'review') to extract per product. Set to 0 to skip individual review rows.

## `proxyConfiguration` (type: `object`):

Proxy settings. Standard Apify Datacenter proxy works out of the box.

## Actor input object example

```json
{
  "queries": [
    "trading"
  ],
  "category": "",
  "appType": "",
  "verifiedOnly": false,
  "maxProductsPerQuery": 15,
  "enrichDetails": true,
  "maxReviewsPerProduct": 0,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `dataset` (type: `string`):

No description

## `sourceReport` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "trading"
    ],
    "maxProductsPerQuery": 15
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/whop-marketplace-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["trading"],
    "maxProductsPerQuery": 15,
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/whop-marketplace-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "trading"
  ],
  "maxProductsPerQuery": 15
}' |
apify call foxlabs/whop-marketplace-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,foxlabs/whop-marketplace-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CV9E0NyXjruABhgGh/builds/S6N4tWLc3q46Ib7hs/openapi.json
