The Hotness
Games|People|Company
Legacy of Dragonholt
Warhammer Fantasy Roleplay (4th Edition)
She Bleeds
Dungeons & Dragons Starter Set
Waterdeep: Dragon Heist
Princes of the Apocalypse
The Solo Adventurer's Toolbox
Fiasco
Rangers of Shadow Deep: A Tabletop Adventure Game
Adventure Afoot in the Reikland!
Project Powerpunk Demo Adventure
Pathfinder Roleplaying Game: Beginner Box
The Quiet Year
Fate Accelerated
Player's Handbook (D&D 5e)
The Orc in the Well
The Skeletons
Xanathar's Guide to Everything
Sentinel Comics: The Roleplaying Game – Starter Kit
Ironsworn
Knights & Legends
Masks of Nyarlathotep (5th edition)
Fantasy World Creator
Forgotten Realms Campaign Guide
RuneQuest (2nd Edition)
Primetime Adventures (Second Edition)
Sherpa
Realm of Chaos: The Lost and the Damned
The Great Pendragon Campaign
Knight Hawks
A Spy in Isengard
Dungeons & Dragons Starter Set
Tortured Souls! (Issue 1 - Oct/Nov 1983)
The Creature Vault
Dungeon World Roleplaying Game
Numenera
A Game of Thrones d20-Based Open Gaming RPG
The Sundered Land
The One Ring Roleplaying Game
Hoard of the Dragon Queen
Blades in the Dark
Tech Support
World Wide Wrestling: The Roleplaying Game
Storm King's Thunder
URC3-02: The Mystery of Mystmoor
The Alchemist of Istanbul
Mordenkainen's Tome of Foes
The Witcher
Art and Arcana: A Visual History
The ABCs of D&D
GeekGold Bonus for All Supporters at year's end: 1000!
7,354 Supporters
$15 min for supporter badge & GeekGold bonus
23 Days Left

Support:

Search: Titles Only:
Article Edit | History | Editors

BGG XML API redirected from XML API

Introduction

You can access some information from the geek via the BoardGameGeek XML API. Each base URI is described and the various parameters are listed. The parameters and their values are URL-encoded in the standard manner. There are some examples at the end. The resultant output XML is not described here, but XML is "self-describing" right? The output should be quite clear from simple inspection.

For all of the parameters mentioned below, the first parameter you list follows a ? (question mark), and each subsequent parameter follows an & (ampersand).

Related wikis: Data Mining, and BGG XML API2

Usage Notes

Note: BGG throttles the requests now, which is to say that if you send requests too frequently, the server will give you 500 or 503 return codes, reporting that it is too busy. Currently, a 5-second wait between requests seems to suffice.

Commands

Search for games by name and by AKAs

/xmlapi/search

Retrieve information about a particular game or games

/xmlapi/boardgame/<gameid>
/xmlapi/boardgame/<gameid>,<gameid2>[...]

Retrieve games in a user's collection

/xmlapi/collection/<username>
Retrieve games in a user's collection. Important definition: A user's collection includes any games the user has added to her collection on BGG. This includes games she owns, games she used to own, games she's rated, games upon which she's commented, games she's played, and games on her wishlist, just to name a few. In this section, references to the collection mean this broader sense of BGG collection, not the user's personal stash of games.

The XMLAPI will place requests for geeklists and user collections into a queue to be processed by backend servers. When this happens, the request will result in an HTTP response of 202 to indicate the request has been queued and is pending processing. These collection requests will result in an HTTP response of 200 along with the XML data once the server has the data available (See Export collections has been updated (XMLAPI developers read this) for details).

Retrieve the messages from a forum/game thread

/xmlapi/thread/<threadid>

  • Example: http://www.boardgamegeek.com/xmlapi/thread/381021 [Note: Your browser may interpret this as a request to subscribe to an RSS feed.]
  • start: Start article (default = 0)
  • count: Number of articles (default and max = 100)
  • username: Username to filter for

Retrieve entries from a geeklist

/xmlapi/geeklist/<listid>

Note: the old "start" and "count" parameters are obsolete and no longer supported. They were required in the original api if you wanted to retreive all items on a geeklist longer than 150 items as that's the most that could be returned on a single api call. Currently however the geeklist xml api returns the entire geeklist (all items) in a single call.

Games Data XML Snapshot

BGG XML Snapshot

Known XML API Users

XML API Bugs & Enhancement Requests

XML API Enhancements

[What Links Here]
Front Page | Welcome | Contact | Privacy Policy | Terms of Service | Advertise | Support BGG | Feeds RSS
Geekdo, BoardGameGeek, the Geekdo logo, and the BoardGameGeek logo are trademarks of BoardGameGeek, LLC.