Skip to content
TTCGAPIs
Board Games API

Board Game Data API

180,000+ catalog records · ranks · ratings · mechanics · designers. A REST + JSON board game database API keyed by BGG ID, included in every monthly plan from Hobby (Hobby, Business and Unlimited). Without a plan, each request costs 1 credit: 100 free credits on signup, then credit packs from £10.

BGG API Alternative

How this compares with the BoardGameGeek XML API

BoardGameGeek publishes an official XML API under its own terms, and community JSON wrappers vary in scope and upkeep. We serve the catalog as filterable JSON keyed by BGG ID, with a documented monthly allowance per plan. Check each provider's current terms before you choose.

 BGG XML2 APIGitHub JSON wrappersTCGAPIs Board Games
FormatXMLVaries by projectJSON (versioned, REST)
Usage limitsSet by BGG terms and guidelinesVaries by projectMonthly allowance per plan
Server-side filtersName search and lookup by IDVaries by projectMechanics, categories, players, weight, year, rating
Commercial SLASee BGG termsVaries by projectUnlimited plan
AccessSee BGG API termsVaries by projectAPI key (x-api-key)
8 Endpoints · credits or any monthly plan

Board Game Data API Endpoints

Authenticated via x-api-key. Every catalog field keyed by BGG ID for drop-in compatibility with existing BGG-keyed data.

GET/api/v2/boardgames
Credits or any monthly plan

Search and filter titles: ?q (name), ?mechanic, ?category, ?designer, ?publisher, ?family, ?minPlayers, ?maxPlayers, ?playtimeMax, ?ageMin, ?yearMin, ?yearMax, ?ratingMin, ?ratedMin, ?weightMin, ?weightMax, ?is_expansion, ?ranked, ?sort. Paginated with ?limit and ?offset.

GET/api/v2/boardgames/:id
Credits or any monthly plan

Full title record by BGG ID: names, year, description, designers, artists, publishers, families, mechanics, categories, player counts, playing time, minimum age, ratings, ranks and images.

GET/api/v2/boardgames/top/:rankType
Credits or any monthly plan

Top titles in a rank category: boardgame, strategygames, familygames, wargames, partygames, abstracts, thematic, childrensgames or cgs.

GET/api/v2/boardgames/mechanics
Credits or any monthly plan

Every game mechanic with its ID and title count, ready for a filter dropdown.

GET/api/v2/boardgames/categories
Credits or any monthly plan

Every category with its ID and title count.

GET/api/v2/boardgames/designers/top
Credits or any monthly plan

Most prolific designers by number of titles.

GET/api/v2/boardgames/publishers/top
Credits or any monthly plan

Most prolific publishers by number of titles.

GET/api/v2/boardgames/stats
Credits or any monthly plan

Catalog totals: titles, base games, expansions and ranked games.

Chainable Workflow

Search → Detail → Rankings

Every record is keyed by its BGG ID, so you never have to reconcile keyspaces.

1

Search Titles

/api/v2/boardgames?q=brass

Search by name, or filter by mechanic, category, player count, play time, year, rating and weight.

2

Title Detail

/api/v2/boardgames/:id

Use the BGG ID to fetch the full record: designers, mechanics, categories, ratings and ranks.

3

Rankings

/api/v2/boardgames/top/:rankType

Build leaderboards for the whole catalog or a category such as strategy, family or party games.

Every field group, beyond names and ratings

Search results use a compact projection; GET /api/v2/boardgames/:id returns the full stored record except MongoDB's internal ID. Every field below is optional when the source has no value. Additional source fields can appear. Zero, null and a missing field are not interchangeable.

Swipe the table horizontally to see all fields and their meanings.

Board-game response fields and endpoint availability
DataJSON pathsMeaning and availability
Identity and alternate namesidnametypeis_expansionnames[].typenames[].sort_indexnames[].value

Core identity in lists; names in detail

BGG ID, primary name, record type, expansion flag, and primary/alternate names with source sort order.

Description and publicationdescriptionyear_publishedyearpublished

Year in lists; description and legacy alias in detail

Source description may contain HTML or encoded text. year_published is canonical; yearpublished is a legacy alias when present.

Players, time and agemin_playersmax_playersmin_playtimemax_playtimeplaying_timemin_age

List and detail

Published player range, minimum/maximum and typical playing time in minutes, and publisher/source minimum age. Community recommendations are separate.

Imagesimage_urlthumbnail_url

List and detail

Source image and thumbnail URLs. Availability and third-party image rights vary.

People and taxonomyartists[].idartists[].valuedesigners[].iddesigners[].valuepublishers[].idpublishers[].valuefamilies[].idfamilies[].valuemechanics[].idmechanics[].valuecategories[].idcategories[].value

List and detail

Source identifiers and labels for artists, designers, publishers, families, mechanics and categories. Lists retain the ID/value tuples.

Ratings and rating spreadrating.users_ratedrating.averagerating.bayes_averagerating.stddevrating.median

List and detail

Community rating count, average, Bayesian average, standard deviation and source median. Zero values can be source placeholders, not meaningful measurements.

Ownership and interestrating.ownedrating.tradingrating.wantingrating.wishingrating.num_comments

List and detail

Source community collection, trade, want, wish and comment counts. These are not current marketplace inventory or sales.

Complexityrating.num_weightsrating.average_weight

List and detail

Number of complexity votes and average source complexity weight, on the source 1–5 scale.

Overall and category ranksrankranks[].typeranks[].idranks[].nameranks[].friendly_nameranks[].valueranks[].bayes_average

List and detail

Overall rank and category rank entries. Ranked-list responses instead include categoryRank, categoryBayes and overallRank.

Community player recommendationssuggested_players.<player-count>.<vote-label>

Detail only

Vote counts for Best, Recommended and Not Recommended, keyed by player count (including labels such as 4+). Not a replacement for the published player range.

Language dependencesuggested_language_dependence.<answer>

Detail only

Community votes describing how much in-game text affects playability in another language.

Full community pollspoll_results.<poll-name>.titlepoll_results.<poll-name>.total_votespoll_results.<poll-name>.results[].numplayerspoll_results.<poll-name>.results[].votes.<answer>

Detail only

Full player-count, suggested-age and language-dependence poll results. Poll names and answer keys can vary; numplayers may be null. Do not sum all response buckets to infer unique voters.

Freshness and source statuslast_updatedfetch_success

Timestamp in lists; optional status in detail

Stored source-fetch timestamp and optional ingest success flag. Preserve the timestamp as supplied; it may omit a timezone. Neither establishes a refresh SLA.

Legacy summary aliasesaveragebayesaverageusersrated<category>_rank

Detail only, when present

Older top-level rating and category-rank aliases, such as familygames_rank, strategygames_rank and thematic_rank. Prefer rating and ranks for new integrations; do not assume aliases always exist.

Ranked pages return categoryRank, categoryBayes and overallRank. Taxonomy and people discovery return id, value and gameCount. Stats return totalGames, baseGames, expansions, rankedGames, distinctMechanics, distinctCategories and yearCoverage.from/to. Search total is capped at 10,000; /stats provides an estimated whole-catalog count.

OpenAPI response schemas · Download field reference JSON

Two catalog records, inspected

Catan and Gloomhaven snapshots inspected on 9 November 2026. These excerpts show selected fields; arrays are shortened and descriptions omitted. Ratings and counts belong to each stored snapshot, not a live guarantee.

Catan · BGG 13
{
  "exampleNote": "Selected fields from stored record; not the full response. Ranks array shortened.",
  "data": {
    "id": 13,
    "name": "Catan",
    "type": "boardgame",
    "year_published": 1995,
    "min_players": 3,
    "max_players": 4,
    "playing_time": 120,
    "min_age": 10,
    "rating": {
      "users_rated": 144902,
      "average": 7.09014,
      "bayes_average": 6.90146,
      "stddev": 1.5066,
      "median": 0,
      "owned": 245805,
      "trading": 2412,
      "wanting": 526,
      "wishing": 8426,
      "num_comments": 24241,
      "num_weights": 8642,
      "average_weight": 2.28
    },
    "ranks": [
      {
        "type": "subtype",
        "id": 1,
        "name": "boardgame",
        "friendly_name": "Board Game Rank",
        "value": 625,
        "bayes_average": 6.90146
      },
      {
        "type": "family",
        "id": 5497,
        "name": "strategygames",
        "friendly_name": "Strategy Game Rank",
        "value": 594,
        "bayes_average": 6.77027
      }
    ],
    "suggested_players": {
      "1": {
        "Best": 1,
        "Recommended": 4,
        "Not Recommended": 1564
      },
      "2": {
        "Best": 17,
        "Recommended": 269,
        "Not Recommended": 1392
      },
      "3": {
        "Best": 734,
        "Recommended": 1175,
        "Not Recommended": 114
      },
      "4": {
        "Best": 1566,
        "Recommended": 473,
        "Not Recommended": 48
      },
      "4+": {
        "Best": 63,
        "Recommended": 210,
        "Not Recommended": 998
      }
    },
    "suggested_language_dependence": {
      "No necessary in-game text": 21,
      "Some necessary text - easily memorized or small crib sheet": 303,
      "Moderate in-game text - needs crib sheet or paste ups": 33,
      "Extensive use of text - massive conversion needed to be playable": 1,
      "Unplayable in another language": 0
    },
    "last_updated": "2026-10-18T06:00:04.758314"
  }
}
Gloomhaven · BGG 174430
{
  "exampleNote": "Selected fields from stored record; not the full response. Ranks array shortened.",
  "data": {
    "id": 174430,
    "name": "Gloomhaven",
    "type": "boardgame",
    "year_published": 2017,
    "min_players": 1,
    "max_players": 4,
    "playing_time": 120,
    "min_age": 14,
    "rating": {
      "users_rated": 67835,
      "average": 8.53111,
      "bayes_average": 8.28935,
      "stddev": 1.73967,
      "median": 0,
      "owned": 105521,
      "trading": 1331,
      "wanting": 1161,
      "wishing": 22586,
      "num_comments": 11833,
      "num_weights": 2777,
      "average_weight": 3.9208
    },
    "ranks": [
      {
        "type": "subtype",
        "id": 1,
        "name": "boardgame",
        "friendly_name": "Board Game Rank",
        "value": 4,
        "bayes_average": 8.28935
      },
      {
        "type": "family",
        "id": 5496,
        "name": "thematic",
        "friendly_name": "Thematic Rank",
        "value": 2,
        "bayes_average": 8.26351
      }
    ],
    "suggested_players": {
      "1": {
        "Best": 156,
        "Recommended": 715,
        "Not Recommended": 397
      },
      "2": {
        "Best": 415,
        "Recommended": 902,
        "Not Recommended": 96
      },
      "3": {
        "Best": 818,
        "Recommended": 545,
        "Not Recommended": 41
      },
      "4": {
        "Best": 503,
        "Recommended": 667,
        "Not Recommended": 177
      },
      "4+": {
        "Best": 6,
        "Recommended": 55,
        "Not Recommended": 939
      }
    },
    "suggested_language_dependence": {
      "No necessary in-game text": 1,
      "Some necessary text - easily memorized or small crib sheet": 0,
      "Moderate in-game text - needs crib sheet or paste ups": 2,
      "Extensive use of text - massive conversion needed to be playable": 48,
      "Unplayable in another language": 21
    },
    "last_updated": "2026-10-11T06:38:14.002147"
  }
}

What you can build

The catalog dimensions you expect from BGG, served as filterable JSON.

Collection apps

Build "what do I own?" trackers without scraping BGG. Search by name, fetch by BGG ID, and surface ratings, mechanics and player counts for every title in a user's collection.

BGG dashboard alternatives

Render top-N leaderboards, mechanic explorers and designer pages — in your own UI, with each list fetched in a single filtered JSON call.

Game recommenders

Suggest games by player count, play time, complexity weight, mechanics and rating, all filterable server-side in one request.

Store catalogs

Enrich shop product pages with BGG rank, ratings, player counts, descriptions and images, keyed by BGG ID so it bridges to any existing inventory system.

Source, freshness and reuse

This catalog uses BoardGameGeek identifiers and source-derived catalog fields, including ratings and image URLs. It includes base games and expansions; record totals change as the catalog changes. Search totals are capped at 10,000; use /api/v2/boardgames/stats for estimated corpus totals and each record's last_updated value for age. We do not publish a guaranteed refresh interval.

Image URLs can point to the original source host. API access does not establish permission to republish or cache third-party images. Check the source terms and rights for your intended commercial use before publishing them. This endpoint supplies catalog data, not board-game prices.

Frequently Asked Questions

Is this a BoardGameGeek API alternative?

Yes. We index 180,000+ catalog records with the same catalog dimensions you get from BoardGameGeek — ranks, mechanics, categories, designers, publishers, year published, player counts, playing time, and community ratings — but expose them as JSON over REST instead of XML, with a documented monthly allowance per plan. Each title is keyed by its BGG ID, so existing BGG-keyed data ports across without any remapping.

Do you return JSON or XML?

JSON only. Search and ranked lists return compact projections. Fetch /api/v2/boardgames/:id for the full stored record, including alternate names, description, community polls and optional legacy fields. All responses use application/json.

Does the API include board game pricing?

No. The board game API is a catalog: titles, ranks, ratings, mechanics, categories, people and images. It does not include marketplace prices.

What are the rate limits?

Start with 100 free credits: each board game request costs 1 credit, and credit packs from £10 add more. On a monthly plan, Hobby includes 20,000 calls a month, Business 50,000, and Unlimited has no monthly call cap. List responses are paginated, with up to 100 records per request.

How does this differ from /catalog-api on the TCG side?

The /catalog-api endpoints cover trading card games (Magic, Pokemon, Yu-Gi-Oh, etc.) — singles, expansions, sets, with TCGPlayer/Cardmarket cross-references. The /boardgames-api endpoints cover board games and expansions — titles, mechanics, designers, BGG ranks, ratings — keyed by BGG ID. Two separate corpora, same auth and same response envelope shape.

What plan do I need?

Credits or a monthly plan. Every board game endpoint works with credits (free or bought) at 1 credit per request. After your free credits are used, buy a credit pack (from £10, no subscription) or choose a monthly plan. Every board game endpoint is included in Hobby, Business and Unlimited, where each call counts toward your monthly allowance.

Board game data as filterable JSON

180,000+ catalog records. JSON over REST. Included in every monthly plan from Hobby, or 1 credit per request without a plan (100 free credits, then credit packs from £10). One x-api-key for the whole platform.