Skip to content
TTCGAPIs
guides4 min read

BoardGameGeek API Alternative: A REST JSON Board Game API

Use a JSON board-game catalog with BGG identifiers, search and filters. Compare formats, access requirements and documented fields before integrating.

T

TCGAPIs Team

Updated

Choose the interface that fits your application

BoardGameGeek publishes an official XML API2 reference. Check its current registration, authentication and usage terms before integrating. This article does not claim measured performance or availability differences between providers.

TCGAPIs offers a separate REST JSON catalog keyed by BGG identifiers. It covers 180,000+ board-game and expansion records, with available descriptive data, ratings, mechanics, categories, designers and publishers. It does not provide board-game prices.

The 100 free credits of a new account work on TCGAPIs board-game endpoints, at 1 credit per request. After your free credits are used, buy a credit pack (from £10, no subscription) or choose a monthly plan, starting with Hobby. See the board-game API reference and plans.

Search and inspect the returned records

Send your key in x-api-key from your server. The list response is an envelope with a data array plus pagination fields; it is not a bare array.

const headers = { 'x-api-key': process.env.TCGAPIS_KEY };
async function get(path) {
  const response = await fetch('https://api.tcgapis.com/api/v2/boardgames' + path, { headers });
  const body = await response.json();
  if (!response.ok || !body.success) throw new Error(body.error || 'Board-game request failed');
  return body;
}
const results = await get('?q=brass&limit=5&offset=0');
results.data.forEach(game => console.log(game.id, game.name));
console.log(results.count, results.total, results.offset, results.limit);
 
const id = results.data[0]?.id;
if (!id) throw new Error('No matching game');
const detail = await get('/' + id);
console.log(detail.data);        // Stored record for the chosen BGG ID
console.log(detail.data.rating); // Ratings block when supplied

The first search result demonstrates lookup, not a verified edition choice. Inspect the result before storing the mapping. Fields can be absent; do not substitute zero for an unknown rating or player count.

Use supported filters

The list endpoint accepts documented filters such as player counts, play time, rating, mechanic, category, designer and publisher. Select field names from the reference instead of translating XML property names by guesswork.

Ratings live in the record's rating block. The rating filter uses rating.average; sort=rating orders by rating.bayes_average. Do not assume an XML value called average appears as a top-level JSON field.

Use limit and offset with the response's count and total to traverse results. The maximum page size is 100. Search requests and detail requests count towards your plan's general API allowance.

Work with BGG identifiers

Keep the BGG identifier as an external source key in your application. TCGPlayer product IDs belong to a different namespace and should not be substituted for it. If your existing data has names only, review candidate matches rather than automatically assigning the first result.

The same application can use TCGAPIs' trading-card endpoints, but those endpoints have separate schemas, and price and listing requests cost more credits than catalog requests (listing requests also take more calls on Hobby and Business). A board-game catalog record is not a trading-card price record.

Access and scope

Every monthly plan can call every endpoint, and a board-game request takes 1 call on each of them.

  • Hobby: 20,000 general calls per month. Trading-card prices and history take 1 call per request, SKU prices and listings 5.
  • Business: 50,000 general calls per month. Trading-card prices and history take 1 call per request, SKU prices and listings 5.
  • Unlimited: no general call cap, and every request takes 1 call.

These plan descriptions do not add board-game pricing. The data-coverage page describes source and dataset boundaries.

Validate your integration

Check HTTP status, the success flag, pagination, missing fields and the selected record's identity. Handle authentication and quota errors explicitly. Keep your API key out of browser code. Measure response times with your own workload; no benchmark or fixed refresh guarantee is asserted here.

Get Your API Key

Explore catalog records across 60+ trading card games, with price, listing and sales-history data where available.

Start Building
BoardGameGeek APIBGG APIboard game APIJSON APIdeveloper guide