RESTful API for Board Game Award Data
The Game Awards API provides access to comprehensive board game award data spanning decades. Backed by Neon serverless PostgreSQL for user accounts, API keys, and usage analytics; all award dataset lookups are in-memory for speed.
All responses are in JSON format by default. XML support coming soon.
API keys are required for production use. Include your API key in all requests:
Main search endpoint supporting multiple query types.
| Parameter | Required | Description | Example |
|---|---|---|---|
| i | Optional* | Award ID | 10865 |
| t | Optional* | Award title search | Spiel des Jahres Winner |
| s | Optional* | Search across all fields | Catan |
| bgg_id | Optional* | BoardGameGeek game ID | 13 |
| year | No | Filter by year | 2023 |
| category | No | Filter by category | Game of the Year |
| award_set | No | Filter by award set | Spiel des Jahres |
| type | No | Filter by type | winner, nominee |
*At least one of i, t, s, or bgg_id is required.
Get list of all available award sets.
Get list of all available award categories.
Get all awards for a specific year.
Health check endpoint.
| HTTP Code | Error | Description |
|---|---|---|
| 400 | Bad Request | Missing required parameters |
| 401 | Unauthorized | Invalid or missing API key |
| 404 | Not Found | Award not found |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Server error |