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

> Access data from boardgamegeek.com.

**Category:** Entertainment | **Website:** [boardgamegeek.com/](https://boardgamegeek.com/) | **Docs:** [parse.bot/marketplace/09e70512-5e43-4d87-8ad4-86d9c855217c/boardgamegeek-com-api](https://parse.bot/marketplace/09e70512-5e43-4d87-8ad4-86d9c855217c/boardgamegeek-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-boardgamegeek-com-api-09e70512/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_game_details

Retrieve comprehensive details for a single board game by its BoardGameGeek numeric identifier. Returns year, player-count range, recommended age, playing time, designers, publishers, categories, mechanics, full description, average and Bayesian ratings, overall rank, subdomain ranks, and complexity weight.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Numeric BoardGameGeek game identifier (e.g. '13' for Catan, '174430' for Gloomhaven). Obtainable from search_games results. |

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

### search_games

Full-text search over BoardGameGeek's database of tabletop games. Results include the BGG identifier, title, year published, and game type (base game or expansion). Results are ordered by relevance. The search covers primary and alternate game names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (up to 100). |
| `query` | string | Yes | Search term to match against game titles. |
| `type` | string | No | Filter results by game type. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boardgamegeek-com-api-09e70512/search_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>","type":"<string>"}'
```