# Whop API — whop.com marketplace: product search, the ranked catalogue (450K products), full product pages with every plan and price, store and product reviews, store profiles, members, users, leaderboards, App Store, bounties and Content Rewards clipping campaigns

> Search whop.com products by keyword (the marketplace's own search index). Every hit the site reports in `total` is reachable: up to 150 per page ("trading": 247 hits = pages 1-5 of 50). Each row is the product card: price, currency and plan type of the default plan, store-wide and product-only rating and count, members, affiliate terms, category, seller company and link.
> ReefAPI engine `whop` · 22 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/whop/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/whop/v1/search — 1 credit
Search whop.com products by keyword (the marketplace's own search index). Every hit the site reports in `total` is reachable: up to 150 per page ("trading": 247 hits = pages 1-5 of 50). Each row is the product card: price, currency and plan type of the default plan, store-wide and product-only rating and count, members, affiliate terms, category, seller company and link.

**Parameters:**
- `query` (string, required) — Search words, matched by whop's own marketplace search.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-150 (default 50).

**Returns:** results[]{id, title, route, url, headline, short_description, price, currency, price_formatted, plan_type, billing_period_days, plans_count, has_free_plan, has_paid_plan, rating, ratings_count, product_rating, product_ratings_count, members, active_users, affiliate{…}, type, business_type, industry_type, marketplace_status, verified, category{…}, logo_url, images[], company{id, route, title, url, verified}, default_plan{…}, created_at, discoverable_at} + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "query": "trading"
}
```

### POST https://api.reefapi.com/whop/v1/search_companies — 1 credit
Search whop.com stores (companies) by keyword: id, route, link, pitch, business and industry type, members, rating and rating count, owner. Up to 150 per page; every hit in `total` is reachable ("trading": 223).

**Parameters:**
- `query` (string, required) — Search words.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-150 (default 50).

**Returns:** results[]{id, title, route, url, verified, creator_pitch, business_type, industry_type, members, rating, ratings_count, created_at, logo_url, owner{id, username, name, url}} + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "query": "trading"
}
```

### POST https://api.reefapi.com/whop/v1/products — 1 credit
The whole public catalogue (397,632 products on 2026-11-16) ranked by whop's own orders — trending, newest arrivals, newest created, highest rated (539 qualifying products), highest affiliate percentage, highest bounties — with category, price range and affiliate filters. Every page is reachable (page 3000 of 100 rows measured). Price filters need a `category` (without one the source times out).

**Parameters:**
- `sort` (string, optional, default "trending") — trending (default), newest_arrivals, created_at, average_review_rating, global_affiliate_percentage or highest_bounties. [one of: trending, newest_arrivals, created_at, average_review_rating, global_affiliate_percentage, highest_bounties]
- `category` (string, optional) — Level-1 category route from `categories` (trading, sports-picks, social-media, business, personal-development, ai, ecommerce, fitness, reselling …).
- `min_price` (number, optional) — Lowest default-plan price (USD). Needs `category`.
- `max_price` (number, optional) — Highest default-plan price (USD). Needs `category`.
- `affiliate` (string, optional) — enabled = only products open to whop's global affiliate program (364,079); disabled = only the others. [one of: enabled, disabled]
- `member_affiliate` (string, optional) — enabled = only products whose members can earn as affiliates (16,592). [one of: enabled, disabled]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** results[] (product cards as in `search`, + rank) + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "sort": "trending"
}
```

### POST https://api.reefapi.com/whop/v1/product — 1 credit
One whop.com product in full: every visible plan (initial and renewal price, currency, billing period, trial days, stock, payment methods, checkout link), the price the page prints, store-wide rating + count (what the page prints) and product-only rating + count + 5-star histogram, members, description, FAQ, highlights, included apps, social links, the seller company (rating histogram, members) and owner, the most recent review and related products from the same store.

**Parameters:**
- `product` (string, required) — Product id (prod_…), a whop.com product link (https://whop.com/<store>/<product>/), a checkout link with ?pass=prod_…, or a product route.

**Returns:** card fields of `search` + description, creator_pitch, labels, product_rating_histogram, plans[]{id, plan_type, price, currency, price_formatted, initial_price, renewal_price, initial_price_usd, renewal_price_usd, billing_period_days, trial_period_days, stock, in_stock, checkout_link, …}, plans_total, subcategory, faq[], highlights[], included_apps[], social_links[], company{…, rating_histogram}, owner{…}, most_recent_review{…}, related_products[], checkout_link, redirect_purchase_url, banner_url, gallery[], first_approved_at, updated_at

**Example request body:**
```json
{
  "product": "prod_UzIpfrCaGvdqD"
}
```

### POST https://api.reefapi.com/whop/v1/product_reviews — 1 credit
Reviews of one product only (not the whole store), newest first: stars, text, date, how long after joining it was written, verified purchase, upvotes, replies, author (username, name, avatar, profile link), attachments. `stars` filter (the source has no min-stars or pinned filter on a single product; `company_reviews` has both). Up to 100 per page.

**Parameters:**
- `product` (string, required) — Product id (prod_…), a whop.com product link (https://whop.com/<store>/<product>/), a checkout link with ?pass=prod_…, or a product route.
- `stars` (integer, optional) — Only reviews with exactly this many stars (1-5).
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** product{id, title, url, ratings_count, rating, rating_histogram}, results[]{id, stars, title, text, created_at, published_at, joined_at, written_days_after_joining, verified_purchase, upvotes, replies, featured, author{…}, product{…}, company{…}, attachments[]} + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "product": "prod_UzIpfrCaGvdqD"
}
```

### POST https://api.reefapi.com/whop/v1/company — 1 credit
One whop.com store (company) in full: pitch, business description, business / industry type, members, rating + count + 5-star histogram, total views, owner (bio, city, country), team, every visible product with its price and ratings, apps / experiences, FAQ, social links, pinned reviews, affiliate settings.

**Parameters:**
- `company` (string, required) — Company / store id (biz_…), store route (elite-options) or a whop.com store link.

**Returns:** id, title, route, url, verified, creator_pitch, business_description, business_type, industry_type, target_audience, members, rating, ratings_count, rating_histogram, total_views, owner{…}, team[], products[], apps[], faq[], social_links[], pinned_reviews[], global_affiliates_enabled, affiliate_application_required, created_at, updated_at

**Example request body:**
```json
{
  "company": "elite-options"
}
```

### POST https://api.reefapi.com/whop/v1/company_reviews — 1 credit
Every review across one store's products (the 1,458 the page counts for Elite Options), newest first, with star filters and the pinned set. Up to 100 per page.

**Parameters:**
- `company` (string, required) — Company / store id (biz_…), store route (elite-options) or a whop.com store link.
- `stars` (integer, optional) — Only reviews with exactly this many stars (1-5).
- `min_stars` (integer, optional) — Only reviews with at least this many stars (1-5).
- `pinned` (boolean, optional) — true = only the reviews the store pinned.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** company{id, title, url, rating, ratings_count, rating_histogram}, results[] (reviews) + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "company": "elite-options"
}
```

### POST https://api.reefapi.com/whop/v1/company_members — 1 credit
The public member list of one store: username, name, city, country, joined date, last seen, followers, roles, avatar. Up to 50 per page. Stores can hide the list; then `member_list_public` is false and `members` still carries the count.

**Parameters:**
- `company` (string, required) — Company / store id (biz_…), store route (elite-options) or a whop.com store link.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-50 (default 50).

**Returns:** company{id, title, url, members}, member_list_public, results[]{member_id, user{id, username, name, url, city, country, created_at, last_seen_at, followers, verified_at, roles[], avatar_url}} + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "company": "elite-options"
}
```

### POST https://api.reefapi.com/whop/v1/companies — 1 credit
whop's company lists: `popular` (100), `verified` (74) and `affiliate` — the affiliate marketplace (11,299 stores with affiliate earnings, clicks and conversions) with its own search, industry and business-type filters and five orders.

**Parameters:**
- `list` (string, optional, default "popular") — popular (default), verified or affiliate. [one of: popular, verified, affiliate]
- `sort` (string, optional, default "earnings") — Affiliate list only: earnings (default), conversions, clicks, score, created_at. [one of: earnings, conversions, clicks, score, created_at]
- `query` (string, optional) — Affiliate list only: search words.
- `industry_type` (string, optional) — Affiliate list only: whop's industry type (options_trading, stock_trading, crypto_trading, sports_betting_picks, reseller_drop_and_deal_alerts …).
- `business_type` (string, optional) — Affiliate list only: whop's business type (education, software, platform, agency, community …).
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** results[]{company card + affiliate_total_earned_usd, affiliate_total_clicks, affiliate_total_conversions (affiliate list), rank} + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "list": "affiliate"
}
```

### POST https://api.reefapi.com/whop/v1/user — 1 credit
A whop.com user profile: name, bio, city, country, followers, following, roles, verification, lifetime earnings as whop publishes them, social links, the stores they own (50, with members and rating) and the stores they joined (50), reviews written, joined / last seen.

**Parameters:**
- `user` (string, required) — User id (user_…), username (jack or @jack) or a whop.com profile link (https://whop.com/@jack/).

**Returns:** id, username, name, url, bio, city, country, country_name, followers, following, roles[], verified_at, lifetime_earnings_usd, social_links[], owned_whops_total, owned_whops[], joined_whops_total, joined_whops[], reviews_written, avatar_url, banner_url, created_at, last_seen_at

**Example request body:**
```json
{
  "user": "jack"
}
```

### POST https://api.reefapi.com/whop/v1/user_followers — 1 credit
Who follows a user (`list=followers`) or whom the user follows (`list=following`), with username, name, followers and verification. Up to 100 per page.

**Parameters:**
- `user` (string, required) — User id (user_…), username (jack or @jack) or a whop.com profile link (https://whop.com/@jack/).
- `list` (string, optional, default "followers") — followers (default) or following. [one of: followers, following]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** user{id, username}, list, results[]{id, username, name, url, followers, verified_at, avatar_url} + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "user": "jack"
}
```

### POST https://api.reefapi.com/whop/v1/user_whops — 1 credit
Every store a user owns (`list=owned`, biggest first, with total earnings) or has joined (`list=joined`), page by page beyond the 50 `user` returns.

**Parameters:**
- `user` (string, required) — User id (user_…), username (jack or @jack) or a whop.com profile link (https://whop.com/@jack/).
- `list` (string, optional, default "owned") — owned (default) or joined. [one of: owned, joined]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** user{id, username}, list, results[] (company cards) + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "user": "jack"
}
```

### POST https://api.reefapi.com/whop/v1/user_reviews — 1 credit
The reviews a user has written, with the product and store each one is about.

**Parameters:**
- `user` (string, required) — User id (user_…), username (jack or @jack) or a whop.com profile link (https://whop.com/@jack/).
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** user{id, username}, results[] (reviews) + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "user": "jack"
}
```

### POST https://api.reefapi.com/whop/v1/categories — 1 credit
whop's marketplace categories with their live product counts: level 1 (40, e.g. Trading 25,314, Social Media 20,766, Sports Betting 18,547) or level 2 (92 sub-categories with their parent). The level-1 `route` is the `category` value of `products`.

**Parameters:**
- `level` (integer, optional, default 1) — 1 (default, top categories) or 2 (sub-categories).

**Returns:** level, total, results[]{id, name, route, level, tagline, description, live_products, live_pages, on_homepage, parent{…}} sorted by live_products

**Example request body:**
```json
{
  "level": 1
}
```

### POST https://api.reefapi.com/whop/v1/leaderboard — 1 credit
whop's leaderboards: top products by GMV, rating, new users, affiliate earnings, time spent, and top users by money earned (24 h / 7 days) and Whop-partner earnings / GTV. The source serves the top 50 of each (its `total_count` is larger); two types answer empty today (money_earned_last_30_days, average_time_spent).

**Parameters:**
- `type` (string, optional, default "new_users") — Which leaderboard (default new_users). usd_gmv ranks products by revenue but whop sends its score as 0 to logged-out callers. [one of: usd_gmv, top_rated, new_users, money_earned_last_24_hours, money_earned_last_7_days, money_earned_last_30_days, affiliate_earnings, average_time_spent, total_time_spent, whop_partners_earnings_last_30_days, whop_partners_gtv_last_30_days]
- `limit` (integer, optional, default 50) — Rows, 1-50 (the source's ceiling).

**Returns:** type, total_count, results[]{rank, previous_rank, score, previous_score, is_fake_rank, product{card} | user{id, username, name, url, followers}}

**Example request body:**
```json
{
  "type": "affiliate_earnings"
}
```

### POST https://api.reefapi.com/whop/v1/apps — 1 credit
The whop App Store: apps ranked by installs (7 / 30 days), daily active users, time spent or date, with view, app type, category and keyword filters: installs, DAU / WAU / MAU, time spent, creator, store product and rating.

**Parameters:**
- `sort` (string, optional, default "total_installs_last_7_days") — App order (default total_installs_last_7_days). [one of: total_installs_last_7_days, total_installs_last_30_days, daily_active_users, time_spent_last_24_hours, discoverable_at, created_at]
- `direction` (string, optional, default "desc") — desc (default) or asc. [one of: desc, asc]
- `view` (string, optional, default "hub") — App Store view (default hub = 146 apps; discover = 31). [one of: hub, discover, dash, dashboard, analytics, skills, openapi]
- `type` (string, optional, default "b2c_app") — App type (default b2c_app). [one of: b2c_app, b2b_app, company_app, component, website]
- `category` (string, optional) — App category route (ai …).
- `query` (string, optional) — Search words.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** results[]{id, name, url, description, app_type, total_installs, installs_last_7d, installs_last_30d, daily_active_users, weekly_active_users, monthly_active_users, time_spent_last_24h_seconds, creator{…}, company{…}, store_product{…}, rank} + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "sort": "daily_active_users"
}
```

### POST https://api.reefapi.com/whop/v1/app — 1 credit
One whop App Store app in full: description, App Store text, installs, DAU / WAU / MAU, time spent, creator, capabilities and its store product (rating, histogram, members, default plan).

**Parameters:**
- `app` (string, required) — App id (app_…) or a whop.com/apps/app_…/ link.

**Returns:** id, name, url, description, app_store_description, total_installs, installs_last_7d, installs_last_30d, daily_active_users, weekly_active_users, monthly_active_users, time_spent_last_24h_seconds, capabilities, creator{…}, store_product{…, rating_histogram, default_plan}

**Example request body:**
```json
{
  "app": "app_fqYWzj3RZXe1O0"
}
```

### POST https://api.reefapi.com/whop/v1/bounties — 1 credit
Public whop bounties (1,838 on 2026-11-16): reward per unit, budget, total paid, spots left, submission counts, platforms, allowed countries, the store and user behind each.

**Parameters:**
- `sort` (string, optional, default "total_paid") — total_paid (default) or created_at (newest). [one of: total_paid, created_at]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** results[]{id, title, description, bounty_type, status, reward_per_unit, reward_unit, currency, budget, total_paid, spots_remaining, accepted_submissions, submissions, platforms[], allowed_country_codes, views, company{…}, user{…}, products[], created_at} + total, page, per_page, total_pages, has_more

**Example request body:**
```json
{
  "sort": "created_at"
}
```

### POST https://api.reefapi.com/whop/v1/campaigns — 1 credit
Content Rewards (whop's clipping marketplace) campaigns: pay per 1K views, budget, budget spent, paid out, creators, approved clips, platforms, per-platform payout, categories and the organisation behind each. Filters: keyword, platform, payout type, category, organisation; ten sorts. Paged with `cursor` (the response's `next_cursor`); up to 100 per page (the source adds its pinned rows, so a page can hold a few more).

**Parameters:**
- `sort` (string, optional, default "trending") — trending (default), featured, newest, budget, payout, cpm, available, paidout, creators, relevance. [one of: trending, featured, newest, budget, payout, cpm, available, paidout, paid_out, creators, relevance]
- `query` (string, optional) — Search words.
- `platform` (string, optional) — Only campaigns paying on this platform. [one of: tiktok, instagram, youtube, x, facebook]
- `payout_type` (string, optional) — cpm, pool, retainer or per_post. [one of: cpm, pool, retainer, per_post, perpost]
- `category` (string, optional) — Campaign category id from `campaign_categories` (337 ids: entertainment, music, gaming, sports, technology, finance, business, lifestyle, health-wellness, education, personal-brand … and their children such as streamer, podcast, roblox).
- `organization_id` (string, optional) — Only this organisation's campaigns (UUID).
- `cursor` (string, optional) — `next_cursor` from the previous page; empty for the first page.
- `limit` (integer, optional, default 50) — Rows per page, 1-100 (default 50).

**Returns:** results[]{id, name, url, description, status, payout_type, primary_payout_cents, cpm_min_rate_cents, cpm_max_rate_cents, budget_cents, budget_spent_cents, budget_progress_pct, paid_out_cents, creators, platforms[], payouts[], categories[], organization{…}, banner_url, created_at, launch_date, listed_at} + next_cursor, has_more, count

**Example request body:**
```json
{
  "sort": "budget"
}
```

### POST https://api.reefapi.com/whop/v1/campaign — 2 credits
One Content Rewards campaign in full: everything in `campaigns` plus daily views and approved clips (31 days), the top clips (post link, video, title), the top earners (whop username, earned), total views, fee schedule, status reason and the campaign configuration (content types, creator types, payout model per platform).

**Parameters:**
- `campaign` (string, required) — Campaign UUID or a contentrewards.com/c/campaigns/<uuid> link.

**Returns:** campaign card + total_views, daily_views[]{date, views, approved_submissions}, top_clips[], top_earners[]{rank, whop_username, whop_url, earned_cents}, fee_schedule, status_reason, configuration{…}

**Example request body:**
```json
{
  "campaign": "33c3d5a9-84a9-40c8-b6e4-9904e4816339"
}
```

### POST https://api.reefapi.com/whop/v1/campaign_categories — 0 credits
Every Content Rewards campaign category (337: 19 top level and their children, with label and parent) as contentrewards.com's own category filter lists them, read on 2026-11-16. Use an `id` as `category` in `campaigns`. Served from that snapshot, not fetched per call.

**Parameters:**
- `parent` (string, optional) — Only the direct children of this category id.

**Returns:** source, as_of, total, results[]{id, label, parent, level}

**Example request body:**
```json
{
  "parent": "entertainment"
}
```

### POST https://api.reefapi.com/whop/v1/stats — 1 credit
whop's marketplace totals as the site publishes them: active sellers, active users, memberships sold, companies, total processed (USD) and products.

**Parameters:** none

**Returns:** active_sellers, active_users, memberships_sold, total_companies, total_processed_usd, total_products

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=whop
- Human docs page: https://reefapi.com/docs/whop
- Overview page: https://reefapi.com/whop-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
