# Miniature Market — 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 for miniature and tabletop gaming products, browse items by category, and access detailed product information including customer reviews and current deals from Miniature Market. Find exactly what you need with comprehensive product listings and real-time pricing data to make informed purchasing decisions.

**Category:** E-commerce | **Website:** [miniaturemarket.com/](https://miniaturemarket.com/) | **Docs:** [parse.bot/marketplace/88b6c982-a2cb-4c3e-9e83-3e5eb776bd56/miniaturemarket-com-api](https://parse.bot/marketplace/88b6c982-a2cb-4c3e-9e83-3e5eb776bd56/miniaturemarket-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-miniaturemarket-com-api-88b6c982/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_products

List products within a named category by its URL slug. Returns paginated summary results. Categories include board-games, trading-card-games, role-playing-games, miniatures-games, collectible-miniatures, accessories, family-friendly-games, and deals.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug (e.g. board-games, deals, trading-card-games, role-playing-games, miniatures-games, collectible-miniatures, accessories, family-friendly-games) |
| `order` | string | No | Sort order for results |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-miniaturemarket-com-api-88b6c982/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","order":"<string>","page":"<integer>"}'
```

### get_deals

Retrieve current deals and last-chance items. Returns paginated product listings from the deals/clearance category. Equivalent to get_category_products with category='deals' but with a simpler interface.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-miniaturemarket-com-api-88b6c982/get_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_product_details

Retrieve full details for a single product including brand, category, description text, price, and aggregate customer rating. Accepts either a product SKU or a full product page URL. The rating object comes from REVIEWS.io and may be null when no reviews exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku_or_url` | string | Yes | Product SKU (e.g. 'mfg73002', 'ffgcn3015') or full product URL |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-miniaturemarket-com-api-88b6c982/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku_or_url":"<string>"}'
```

### get_product_reviews

Retrieve customer reviews for a product by its SKU. Data is sourced from REVIEWS.io. Returns paginated reviews (15 per page) with rating, author, title, comment, and date. Also includes aggregate stats (total count, average rating).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for reviews (15 reviews per page, 1-based) |
| `sku` | string | Yes | Product SKU (e.g. 'MFG73002', 'FFGCN3015') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-miniaturemarket-com-api-88b6c982/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sku":"<string>"}'
```

### search_products

Full-text search across Miniature Market's product catalog. Matches product names by keyword. Returns paginated summary results ordered by the chosen sort. Each result carries a URL suitable for drilling into full details via get_product_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `order` | string | No | Sort order for results |
| `page` | integer | No | Page number for results (1-based) |
| `query` | string | Yes | Search keyword (e.g. 'catan', 'pokemon', 'dungeons dragons') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-miniaturemarket-com-api-88b6c982/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order":"<string>","page":"<integer>","query":"<string>"}'
```