Leaderboard-as-a-Service

Game Leaderboard API
for any engine

LightLeaderboard is a managed REST API for game leaderboards. If your engine can make an HTTP request, it can have a live global leaderboard — no backend code, no database to manage.

Create free account Browse the API docs
Works with
Godot 4 Unity Unreal Phaser PixiJS Any HTTP

Two endpoints. Everything you need.

Submit a score and get the leaderboard. That's the whole API for most games.

Submit a score + get rank
curl REST
# Submit a score
curl -X POST https://leaderboard.goproso.com/api/v1/games/my_game/scores \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "score": 42000,
    "playerRefId": "player_001",
    "playerName": "Alice",
    "submissionId": "abc-123"
  }'

# Response — rank returned immediately
{ "id": 1847, "rank": 3, "isPersonalBest": true, "totalPlayers": 1024 }
Fetch top 10
fetch JS
// Any JavaScript/TypeScript runtime
const res = await fetch(
  `https://leaderboard.goproso.com/api/v1/games/my_game/leaderboard?limit=10`,
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const { entries } = await res.json();
// entries → [{ rank, playerName, score, metadata }, ...]

Full API surface

POST /games/:gameId/scores Submit a score — returns rank immediately
GET /games/:gameId/leaderboard Paginated top scores with time-period filter
GET /games/:gameId/players/:refId/rank Single player's current rank and score
GET /games/:gameId/players/:refId/leaderboard Rows surrounding the player (centric view)
GET /games/:gameId/players/:refId Player profile and all-time stats
PUT /games/:gameId/players/:refId Update player name or metadata
GET /games/:gameId/players/:refId/scores Full score history for a player
Full API reference →

Why indie developers choose LightLeaderboard

⚡
Rank on submit

Every submit response includes the player's current global rank. No second request, no polling.

📅
Time periods built-in

Query by daily, weekly, monthly, or all_time. Run seasonal events without any backend work.

📦
Metadata per score

Attach arbitrary JSON (level, character, difficulty) to each score. Filter and display it in the dashboard.

🔐
HMAC signing

Sign requests with HMAC-SHA256 to prevent score manipulation. The Godot and npm SDKs handle this automatically.

🛠️
SDKs for popular engines

Official Godot 4 plugin and npm SDK for JS/TS. Plain REST for everything else.

🆓
Free forever tier

No credit card, no time limit. The free tier is sized for indie games in early access and beyond.

Stop building leaderboard backends. Start shipping games.

Create a free account in 30 seconds. Your first leaderboard is live in under 10 minutes.

Create free account Read the API docs →