API Documentation

Endpoints publics pour accéder aux kills, joueurs et matchs KC. CORS ouvert, caché, gratuit.

GET/api/v1/kills

Liste des kills KC publi\u00e9s avec clips vid\u00e9o, scores et descriptions AI.

Paramètres

limit(int)= 20— Max results (1-100)

offset(int)= 0— Pagination offset

champion(string)— Filtrer par killer_champion (ex: Aurora)

involvement(string)— team_killer ou team_victim

sort(string)= highlight_score— highlight_score, created_at, game_time_seconds

Exemple

/api/v1/kills?limit=5&champion=Aurora&involvement=team_killer

Réponse exemple

{
  "kills": [
    {
      "id": "uuid",
      "killer_champion": "Aurora",
      "victim_champion": "Bard",
      "clip_url_horizontal": "https://clips.kckills.com/...",
      "clip_url_vertical": "https://clips.kckills.com/...",
      "highlight_score": 8.5,
      "ai_description": "Aurora fait danser Bard...",
      "ai_tags": ["outplay", "solo_kill"],
      "multi_kill": null,
      "is_first_blood": false,
      ...
    }
  ],
  "count": 5,
  "offset": 0,
  "limit": 5
}

GET/api/v1/players

Roster KC avec stats agr\u00e9g\u00e9es (KDA, games, champions).

Exemple

/api/v1/players

Réponse exemple

{
  "players": [
    {
      "name": "Caliste",
      "role": "bottom",
      "games_played": 25,
      "total_kills": 127,
      "kda": 9.09,
      "top_champions": ["Ashe", "Jinx", ...]
    }
  ],
  "count": 5
}

GET/api/v1/matches

Historique des matchs KC avec scores et r\u00e9sultats.

Paramètres

limit(int)= 20— Max results (1-100)

year(int)— Filtrer par année (2024, 2025, 2026)

Exemple

/api/v1/matches?year=2026&limit=10

Réponse exemple

{
  "matches": [
    {
      "id": "115548668059523724",
      "date": "2026-03-28",
      "opponent": { "code": "VIT", "name": "Team Vitality" },
      "kc_won": true,
      "kc_score": 2,
      "opp_score": 1,
      "total_kc_kills": 45,
      ...
    }
  ],
  "count": 10
}

Tous les endpoints sont en lecture seule, CORS ouvert (*), et cachés (60s kills, 1h players/matches).

Rate limit: pas de limite explicite. Soyez raisonnables.

{ "kills": [ { "id": "uuid", "killer_champion": "Aurora", "victim_champion": "Bard", "clip_url_horizontal": "https://clips.kckills.com/...", "clip_url_vertical": "https://clips.kckills.com/...", "highlight_score": 8.5, "ai_description": "Aurora fait danser Bard...", "ai_tags": ["outplay", "solo_kill"], "multi_kill": null, "is_first_blood": false, ... } ], "count": 5, "offset": 0, "limit": 5 }

{ "players": [ { "name": "Caliste", "role": "bottom", "games_played": 25, "total_kills": 127, "kda": 9.09, "top_champions": ["Ashe", "Jinx", ...] } ], "count": 5 }

{ "matches": [ { "id": "115548668059523724", "date": "2026-03-28", "opponent": { "code": "VIT", "name": "Team Vitality" }, "kc_won": true, "kc_score": 2, "opp_score": 1, "total_kc_kills": 45, ... } ], "count": 10 }