# Whop — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover verified companies and popular businesses across the Whop marketplace by category, while browsing public forum discussions and exploring the business classification taxonomy. Find relevant business categories and access curated discover sections to identify opportunities within specific market segments.

**Category:** Marketplaces | **Website:** [whop.com/](https://whop.com/) | **Docs:** [parse.bot/marketplace/cab0d470-827c-45da-bcf8-7ed2717d2527/whop-com-api](https://parse.bot/marketplace/cab0d470-827c-45da-bcf8-7ed2717d2527/whop-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-whop-com-api-cab0d470/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Fetch the complete business classification hierarchy showing all business types, industry groups, and industry types available on Whop. Use the returned values as filter inputs for get_popular_businesses. Returns a stable taxonomy that changes infrequently.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-whop-com-api-cab0d470/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_discover_categories

Fetch randomized discover categories that have active businesses. Returns a random selection of category entries each call, useful for exploring what types of businesses are available on Whop. Results vary between calls.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Number of categories to fetch |
| `min_bot_count` | integer | No | Minimum number of businesses required in a category for it to be included |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-whop-com-api-cab0d470/get_discover_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","min_bot_count":"<integer>"}'
```

### get_popular_businesses

Fetch popular businesses filtered by business type, industry group, and/or industry type. Use the get_categories endpoint to discover valid filter values. Returns paginated results ordered by popularity with cursor-based navigation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Pagination cursor from a previous response's end_cursor field |
| `business_type` | string | No | Business type filter. Valid values discoverable via get_categories endpoint. |
| `industry_group` | string | No | Industry group filter. Valid values discoverable via get_categories endpoint. |
| `industry_type` | string | No | Industry type filter. Valid values discoverable via get_categories endpoint. |
| `limit` | integer | No | Number of businesses to fetch per page (max 50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-whop-com-api-cab0d470/get_popular_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","business_type":"<string>","industry_group":"<string>","industry_type":"<string>","limit":"<integer>"}'
```

### get_public_forum_posts

Fetch public forum posts from across the Whop platform with cursor-based pagination. Returns post content, attachments, reactions, and recent comments. The feed is fast-moving so cursors may expire quickly; use before_cursor to page backward through older posts reliably.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after_cursor` | string | No | Cursor for fetching newer posts (from a previous response's after_cursor field) |
| `before_cursor` | string | No | Cursor for fetching older posts (from a previous response's before_cursor field) |
| `limit` | integer | No | Number of posts to fetch per page (max 50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-whop-com-api-cab0d470/get_public_forum_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after_cursor":"<string>","before_cursor":"<string>","limit":"<integer>"}'
```

### get_verified_companies

Fetch verified companies from the Whop marketplace with cursor-based pagination. Returns company details including title, member count, reviews, creator pitch, owner info, and logo. Only includes businesses that have been verified by Whop.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Pagination cursor from a previous response's end_cursor field |
| `limit` | integer | No | Number of companies to fetch per page (max 50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-whop-com-api-cab0d470/get_verified_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","limit":"<integer>"}'
```