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.
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 API | GitHub JSON wrappers | TCGAPIs Board Games | |
|---|---|---|---|
| Format | XML | Varies by project | JSON (versioned, REST) |
| Usage limits | Set by BGG terms and guidelines | Varies by project | Monthly allowance per plan |
| Server-side filters | Name search and lookup by ID | Varies by project | Mechanics, categories, players, weight, year, rating |
| Commercial SLA | See BGG terms | Varies by project | Unlimited plan |
| Access | See BGG API terms | Varies by project | API key (x-api-key) |
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.
/api/v2/boardgamesSearch 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.
/api/v2/boardgames/:idFull title record by BGG ID: names, year, description, designers, artists, publishers, families, mechanics, categories, player counts, playing time, minimum age, ratings, ranks and images.
/api/v2/boardgames/top/:rankTypeTop titles in a rank category: boardgame, strategygames, familygames, wargames, partygames, abstracts, thematic, childrensgames or cgs.
/api/v2/boardgames/mechanicsEvery game mechanic with its ID and title count, ready for a filter dropdown.
/api/v2/boardgames/categoriesEvery category with its ID and title count.
/api/v2/boardgames/designers/topMost prolific designers by number of titles.
/api/v2/boardgames/publishers/topMost prolific publishers by number of titles.
/api/v2/boardgames/statsCatalog totals: titles, base games, expansions and ranked games.
Search → Detail → Rankings
Every record is keyed by its BGG ID, so you never have to reconcile keyspaces.
Search Titles
/api/v2/boardgames?q=brassSearch by name, or filter by mechanic, category, player count, play time, year, rating and weight.
Title Detail
/api/v2/boardgames/:idUse the BGG ID to fetch the full record: designers, mechanics, categories, ratings and ranks.
Rankings
/api/v2/boardgames/top/:rankTypeBuild 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.
| Data | JSON paths | Meaning and availability |
|---|---|---|
| Identity and alternate names | idnametypeis_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 publication | descriptionyear_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 age | min_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. |
| Images | image_urlthumbnail_url | List and detail Source image and thumbnail URLs. Availability and third-party image rights vary. |
| People and taxonomy | artists[].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 spread | rating.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 interest | rating.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. |
| Complexity | rating.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 ranks | rankranks[].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 recommendations | suggested_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 dependence | suggested_language_dependence.<answer> | Detail only Community votes describing how much in-game text affects playability in another language. |
| Full community polls | poll_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 status | last_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 aliases | averagebayesaverageusersrated<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.
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.