🎲 Game Awards API Documentation

RESTful API for Board Game Award Data

📋 Overview

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.

Base URL

https://awardsapi.com/api/

Data Format

All responses are in JSON format by default. XML support coming soon.

Rate Limiting

🔐 Authentication

API keys are required for production use. Include your API key in all requests:

?apikey=YOUR_API_KEY

Get your free API key here

🛠 Endpoints

Search and Lookup

GET /api/

Main search endpoint supporting multiple query types.

Parameters

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
game_id Optional* Internal game ID game_qsi3zo
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 game_id is required.

Use game_id values returned in the boardgames array from search or title queries.

Additional Endpoints

GET /api/awards

Get list of all available award sets.

GET /api/categories

Get list of all available award categories.

GET /api/years/{year}

Get all awards for a specific year.

GET /health

Health check endpoint.

💡 Examples

Get award by ID

GET /api/?i=10865&apikey=demo

Search for Spiel des Jahres 2023

GET /api/?s=Spiel des Jahres&year=2023&apikey=demo

Get all awards for a game ID

GET /api/?game_id=game_qsi3zo&apikey=demo

Search for Origins Awards

GET /api/?s=Origins&apikey=demo

Get all award sets

GET /api/awards

❌ Error Handling

Error Response Format

{ "Response": "False", "Error": "Error description" }

Common Error Codes

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