🔧 API Documentation 🔧

Access Fortnite stats programmatically with our REST API

API Key Generation

You must be logged in with Epic Games to generate an API key.

Login with Epic Games
ℹī¸ Note: API keys are limited to one per Epic Games account for security and rate limiting purposes.

Authentication

Include your API key in the request headers:

Endpoints

GET /api/stats/username
Get all-time stats for a specific player. Supports Epic Games, PlayStation, and Xbox usernames.
Query Parameters:
  • platform - Platform type (epic, psn, xbl)
GET /api/seasonal/username
Get seasonal stats for a specific player. Optionally specify a season number.
Query Parameters:
  • platform - Platform type (epic, psn, xbl)
  • season - Season number (optional)
GET /api/search
Search for players by username and platform. Returns account ID and Epic display name.
Query Parameters:
  • username - Player username (required)
  • platform - Platform type: epic, psn, xbl (required)
GET /api/leaderboard
Get the global leaderboard of top players by wins.
Query Parameters:
  • stat - Stat type: wins, kills, kd, winrate, score (default: wins)
  • gamemode - Game mode: all, solo, duo, trio, squad (default: all)
  • limit - Number of results (default: 100, max: 100)

Rate Limits

API requests are limited to 100 requests per hour per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.