It's a wrapper around the offcial boardgamegeek V2 API,
with the scope to create a more confortable way to interact with them since they are exposed in XML format.
With this package you can create your own web app or integrate your backend for example.
- ☑️ Fully typed requests and responses
- ☑️ Easy to use
- ☑️ Typescript written
- ☑️ Promisified
- ☑️ thing, family, forum, thread, user, guild, play, collection endpoints
npm i boardgamegeekclientyarn add boardgamegeekclientIn Node.js (commonjs) environment
const { BggClient } = require("boardgamegeekclient");In ES environment
import { BggClient } from 'boardgamegeekclient';Initialize BggClient and get singleton instance
const client = BggClient.Create();Interact with boardgamegeek entities using the corresponding client object and fire a request with query or queryWithProgress method.
Get boardgame, boardgame expansion, boardgame accessory, videogame, rpgitem, rpgissue informations.
Thing client expose query and queryWithProgress.
const things: BggThingDto[] = await client.thing.query({ id: [174430, 35421],
videos: 1,
comments: 1,
marketplace: 1,
stats: 1,
type: "boardgame" });
// with progress handler as parameter
await client.thing.queryWithProgress({
id: [250621, 257668, 226255, 340790, 279307, 279306, 345121, 271447, 187104, 253618, 271512, 432, 68448, 173346, 346703, 302260, 239472, 172818, 231398, 202408, 267814, 267813, 191189, 267127, 281946, 264647, 2272, 230085, 31260, 247367, 256442, 161970, 6249, 181293],
videos: 1,
comments: 1,
marketplace: 1,
stats: 1,
type: "boardgame"
}, { limit: 10 }, _data => {
});
// with progress handler registered on the client itself
client.thing.progressHandler = (_data) => { };
await client.thing.queryWithProgress({
id: [250621, 257668, 226255, 340790, 279307, 279306, 345121, 271447, 187104, 253618, 271512, 432, 68448, 173346, 346703, 302260, 239472, 172818, 231398, 202408, 267814, 267813, 191189, 267127, 281946, 264647, 2272, 230085, 31260, 247367, 256442, 161970, 6249, 181293],
videos: 1,
comments: 1,
marketplace: 1,
stats: 1,
type: "boardgame"
}, { limit: 10 });Get rpg, rpgperiodical, boardgamefamily informations.
Family client expose query and queryWithProgress.
const families = await client.family.query({ id: [174430, 35421] });Get a list of forums
(in boardgame or family page (of the id), forums tab, left sidebars with all forums).
ForumList client expose query and queryWithProgress.
const forumlists: BggForumlistDto[] = await client.forumlist.query({ id: [8374,22184,59218,1029,2076], type: ['family']});Get a single forum.
const forum = await client.forum.query({ id: 19, page: 3 });Get a single thread.
const threads: BggThreadDto[] = await client.thread.query({ id: 2571698, minarticledate: '2021-01-03', count: 15 });Get public profile information about a user by username.
const users: BggUserDto[] = await client.user.query({ name: 'mattiabanned', hot: 1, top: 1 });Get a single guild.
const guilds: BggGuildDto[] = await client.guild.query({ id: 1000, members: 1, sort: 'date', page: 1 });Request plays logged by a particular user or for a particular item.
const plays: BggPlayDto[] = await client.play.query({ username: 'mattiabanned' });const collections: BggCollectionDto[] = await client.collection.query({ username: 'mattiabanned', excludesubtype: ["boardgameaccessory"] });