# Whop — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/whop/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/whop/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/whop/get-discover-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/whop/get-popular-businesses \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/whop/get-public-forum-posts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/whop/get-verified-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","limit":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.