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

> Browse and monitor gaming marketplace listings and prices on FunPay.com. Search for games and categories, view current listings and pricing, explore the full game directory alphabetically, and look up seller profiles to research reputation and active offers.

**Category:** Marketplaces | **Website:** [funpay.com/](https://funpay.com/) | **Docs:** [parse.bot/marketplace/ec0524cd-d41a-4636-a6a8-7c22002b3d92/funpay-com-api](https://parse.bot/marketplace/ec0524cd-d41a-4636-a6a8-7c22002b3d92/funpay-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-funpay-com-api-ec0524cd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_game_categories

Search for games available on FunPay and retrieve their categories. Returns matching games with sub-categories (e.g. Gold, Accounts, Items). A non-empty query is required to get results; an empty query returns an empty games array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search query to filter games. At least 1 character is required to return results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-funpay-com-api-ec0524cd/get_game_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_game_list_by_letter

Returns all games listed on FunPay grouped alphabetically. Takes no parameters and returns the complete game directory as a map from group header to array of games.

**Estimated cost:** Metered

_No parameters required._

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

### get_game_page

Returns the landing page for a specific game, including all available sub-categories (lot IDs) with listing counts. Tries the chips URL first, then falls back to lots. Returns an upstream error for invalid game IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | The game ID from FunPay URL (e.g. '91' for Lost Ark, '2' for World of Warcraft). Obtainable from get_game_categories or get_game_list_by_letter results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-funpay-com-api-ec0524cd/get_game_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>"}'
```

### get_lots_by_category

Returns all listings/offers for a specific game category by lot ID. Only 'lots' type category IDs are supported (e.g. 332 for Lost Ark Accounts). 'chips' type IDs (e.g. currency categories) will return an upstream error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_id` | string | Yes | The lot/category ID from FunPay. Must be a 'lots' type ID (obtainable from get_game_categories results where type is 'lots', or from get_game_page categories). |
| `query` | string | No | Optional keyword to filter listings by description text. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-funpay-com-api-ec0524cd/get_lots_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_id":"<string>","query":"<string>"}'
```

### get_seller_profile

Returns a seller's public profile and their current listings. Requires a numeric user ID. New or inactive accounts may return empty ratings and listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `user_id` | string | Yes | Numeric user ID from FunPay (e.g. '8083104'). Must contain only digits; usernames are not accepted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-funpay-com-api-ec0524cd/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"<string>"}'
```