HighScore API

Add Leaderboards to Your Game in Minutes

A production-ready REST API with enterprise-grade security, rate limiting, and comprehensive documentation. Perfect for indie games, game jams, and multiplayer games.

📖 API Documentation ⭐ GitHub ☕ Buy Me a Coffee

6

API Endpoints

10+

Security Features

$0

Setup Cost

100%

Open Source

🎮

Multi-Game Support

One API handles unlimited games. Each game gets a unique API key for secure access.

🔒

Enterprise Security

Rate limiting, security headers, input validation, and encrypted API keys built-in.

⚡

Fast & Scalable

Built with FastAPI for high performance. Optimized database queries for instant results.

📊

Player Statistics

Track best scores, averages, rankings, and play history automatically.

🕐

Time-Based Leaderboards

Get daily, weekly, monthly, yearly, or all-time leaderboards with one API call.

🐳

Docker Ready

Deploy anywhere with Docker. Includes docker-compose for instant setup.

Quick Start Example

# 1. Create a game and get API key
curl -X POST /api/v1/games \
  -H "Content-Type: application/json" \
  -d '{"name":"My Game","description":"Cool game"}'

# 2. Submit a score
curl -X POST /api/v1/scores \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_name":"Player1","score":1000}'

# 3. Get leaderboard
curl /api/v1/leaderboard?limit=10 \
  -H "X-API-Key: YOUR_API_KEY"