Skip to main content

BGG-API

A Python API for boardgamegeek.com

docs status ci workflow status codecov Black code style Contributions welcome

Installation

uv add bgg-api

Or with pip:

pip install bgg-api

Usage

Create an application and get the access token here.

from boardgamegeek import BGGClient

bgg = BGGClient("<access_token_here>")

game = bgg.game("Monopoly")

print(game.year)  # 1935
print(game.rating_average)  # 4.36166

Development

# Install dependencies
uv sync --extra dev
# Install pre-commit hooks
uv run prek install

# Run tests
uv run pytest .
# Run tests with tox
uv run tox

Publishing

# Bump version (patch, minor, major)
bump2version patch
# Push to github
git push --tags origin master

Metadata

Release files for bgg-api 1.1.19

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bgg-api 1.1.19
File Size Uploaded
bgg_api-1.1.19.tar.gz 43.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bgg-api 1.1.19
File Interpreter ABI Platform
bgg_api-1.1.19-py3-none-any.whl Python 3 none any Details

Total release size: 88.3 kB

Release files / bgg_api-1.1.19.tar.gz

Download URL bgg_api-1.1.19.tar.gz
Size 43.2 kB
Tags Source
SHA-256 checksum
How to use checksums
606c3d47d8ca9ea9dd4678ccc12c674d950da43dd708bc0d311af539204c9715
BLAKE2b-256 checksum
How to use checksums
8847e72b070bf3efedcce846d933a1ad2f55a25e725de96b2587daf50257de5b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2026.

Transparency log

Release files / bgg_api-1.1.19-py3-none-any.whl

Download URL bgg_api-1.1.19-py3-none-any.whl
Size 45.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cc46f3f7b24705daed94129e6605444f45fc2e1ae972e94b17fdedf9e57e8990
BLAKE2b-256 checksum
How to use checksums
d69010cec824f7a73b07fbc6c9da2a91db0a288503a8c890ce0e6593b3ed7853
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.1.19 This release

2 release files

1.1.18

2 release files

1.1.17

2 release files

1.1.16

2 release files

1.1.15

2 release files

1.1.14

2 release files

1.1.12

2 release files

1.1.9

2 release files

1.1.7

2 release files

1.1.6

2 release files

1.1.5

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page