Skip to content

Use the API

The API is free and read-only. There is no key and no sign-up. Every answer is JSON.

curl https://api.thebgdb.org/v1/search?q=azul

OpenAPI description

The full, machine-readable description of every route, parameter and answer is published with each release at api.thebgdb.org/v1/openapi.json. Load it into any OpenAPI tool to browse the API or generate a client. It also covers accounts, photos and lists.

The same description is readable as a page: the API reference.

The main requests

RequestReturns
GET /v1/search?q=catanGames whose name contains every word of q. Ignores case and accents; does not correct typos. q needs at least two characters.
GET /v1/games/{id}One game, by the id every game object carries: description, players, playing time, credits and photos.
GET /v1/games?limit=50The catalog, a page at a time. Pass the nextCursor you received as cursor to get the next page.
GET /v1/healthWhether the API is up.

Connect an AI assistant (MCP)

Assistants that speak the Model Context Protocol can use the catalog directly. Add this server address to your assistant:

https://mcp.thebgdb.org/mcp

It needs no sign-in. To let an assistant see and edit your lists, use https://mcp.thebgdb.org/member instead: it asks you to sign in and approve first. An API token from your account page also works on the first address.

Limits

Without a token: 300 requests a minute per address. With an API token from your account page: 1,200 a minute, or 6,000 on the paid plan. Over the limit, the API answers 429; wait a minute and carry on. Answers are cached for up to five minutes, so a change can take that long to show.