Documentation API

Accedez aux donnees ranked Warzone avec l'API REST de RankedDB. Creez des bots, overlays, dashboards ou tout ce que vous voulez. Demandez votre cle API sur Discord pour commencer.

Cle API requise

Demandez la sur Discord

Rate Limite

Limite par cle (defaut 100/min)

REST + JSON

Format de reponse standard

OpenAPI 3.0

JSON spec / Docs interactives

Base URL

https://rankeddb.com

Authentification

Toutes les requetes API necessitent une cle API passee via le header X-API-Key.

How to get a key

Les cles API sont delivrees manuellement par l'equipe RankedDB. Contactez-nous sur Discord pour en obtenir une.

Usage

curl -H "X-API-Key: rdb_live_your_key_here" \
  https://rankeddb.com/api/v1/public/players

401Missing or invalid API key

403API key has been revoked

Points d'acces

Demarrage rapide

const API_KEY = "rdb_live_your_key_here";

// Fetch top 10 EU players
const res = await fetch(
  "https://rankeddb.com/api/v1/public/players?limit=10&region=EU",
  { headers: { "X-API-Key": API_KEY } }
);
const { data, meta } = await res.json();
console.log(`Top ${data.length} of ${meta.total} players`);
data.forEach(p => console.log(`#${p.rank} ${p.handle} — ${p.sr} SR`));

Response Format

All responses return JSON. List endpoints wrap results in data with pagination meta. Detail endpoints return a single object in data.

List response

{
  "data": [ ... ],
  "meta": {
    "total": 1284,
    "limit": 50,
    "offset": 0
  }
}

Detail response

{
  "data": {
    "handle": "Player1",
    "sr": 12500,
    ...
  }
}

Limitation de debit

Chaque cle API a sa propre limite (defaut : 100 requetes par minute). En cas de depassement, vous recevrez une reponse 429.

Rate limit headers

X-RateLimit-LimitMax requests per window (100)

X-RateLimit-RemainingRemaining requests in current window

X-RateLimit-ResetUnix timestamp when the window resets

Retry-AfterSeconds to wait (on 429 responses)

Errors

400Bad RequestInvalid query parameters

404Not FoundPlayer or team not found

429Too Many RequestsRate limit exceeded — wait and retry

500Server ErrorInternal error — please try again later

{ "error": "Player not found" }

Rank Tiers

The rankTier field uses these values, from lowest to highest:

BronzeSilverGoldPlatinumDiamondCrimsonIridescentTop 250

Utiliser avec une IA

Copiez ce prompt et collez-le dans ChatGPT, Claude ou toute autre IA pour qu'elle puisse utiliser l'API RankedDB directement.

Tu as acces a l'API RankedDB pour recuperer des donnees ranked Call of Duty: Warzone.

## Authentification
Chaque requete doit inclure le header :
X-API-Key: VOTRE_CLE_API

Base URL : https://rankeddb.com

## Endpoints disponibles

### 1. Classement des joueurs
GET /api/v1/public/players
Params : limit (int, max 200), offset (int), platform ("PC"|"PlayStation"|"Xbox"), region ("EU"|"NA"|"APAC"), rankTier ("Bronze"|"Silver"|"Gold"|"Platinum"|"Diamond"|"Crimson"|"Iridescent"|"Top 250")
Retourne : tableau de joueurs tries par SR avec handle, rankTier, sr, platform, region, trend, trendValue, totalGames, totalWins, avatarUrl

### 2. Profil d'un joueur
GET /api/v1/public/players/{handle}
Retourne : profil complet avec sr, rankTier, platform, srHistory (tableau date+sr), recentMatches (tableau avec srChange, placement, mode), totalGames
Erreur 404 si le joueur n'existe pas.

### 3. Liste des equipes
GET /api/v1/public/teams
Params : limit, offset, region, recruiting (bool)
Retourne : tableau d'equipes avec id, name, tag, color, region, members

### 4. Details d'une equipe
GET /api/v1/public/teams/{id}
Retourne : equipe complete avec roster, staff, socials

### 5. Statistiques globales
GET /api/v1/public/stats
Retourne : totalPlayers, totalTeams, totalMatches, avgSR, platformDistribution, rankDistribution

## Rangs Warzone (du plus bas au plus haut)
Bronze (0-899 SR) < Silver (900-2099) < Gold (2100-3599) < Platinum (3600-5399) < Diamond (5400-7499) < Crimson (7500-9999) < Iridescent (10000+) < Top 250

## Notes
- Les handles sont insensibles a la casse dans la recherche
- Le champ "trend" indique la derniere evolution : "up" (gain SR), "down" (perte), "neutral"
- Platform "PC" correspond a Battle.net
- Rate limit : 100 requetes/minute
- Toutes les dates sont en format ISO 8601 ou YYYY-MM-DD

## Exemples
- Top 1 joueur : GET /api/v1/public/players?limit=1
- SR de D4MNTV : GET /api/v1/public/players/D4MNTV → champ "sr"
- Joueurs PlayStation EU : GET /api/v1/public/players?platform=PlayStation&region=EU
- Nombre total de joueurs : GET /api/v1/public/stats → champ "totalPlayers"

Remplacez VOTRE_CLE_API par votre cle reelle. L'IA pourra ensuite repondre a des questions comme "Quel est le SR de D4MNTV ?" ou "Montre-moi le top 5 EU".

CORS

Tous les endpoints publics incluent les headers CORS. Vous pouvez appeler l'API depuis n'importe quelle origine — apps web, bots Discord, apps mobiles, etc.