Match Statistics API

curl -X GET "https://api.sweathost.com/v1/cs2/matches/MAP_UUID_123/stats" \
  -H "Authorization: Bearer YOUR_API_KEY"

import { createClient } from '@sweathost/sdk';

const client = createClient({ apiKey: process.env.SWEATHOST_API_KEY! });

const stats = await client.matches.getStats('map-uuid-123');

console.log(stats.match.map);           // e.g. "de_dust2"
console.log(stats.overview.totalKills); // number
console.log(stats.topPerformers.topKiller.name);

interface MatchStats {
  match: {
    id: string;
    matchId?: string | null;
    seriesId?: string;
    serverId?: string;
    serverName?: string;
    map: string;
    gameMode: string;
    team1Name?: string | null;
    team2Name?: string | null;
    team1Score: number;
    team2Score: number;
    status: string;
    startedAt: string;
    finishedAt?: string | null;
    duration?: number | null;
  };
  overview: {
    totalKills: number;
    totalDeaths: number;
    totalAssists: number;
    totalRounds: number;
    totalDamage: number;
    totalHeadshots: number;
    averageKD: number;
  };
  players: Cs2PlayerWithStats[];
  weaponStats: {
    byWeapon: Array<{ weapon: string; kills: number; headshots: number; damage: number; hsRate: number }>;
    byCategory?: Array<{ category: string; kills: number; headshots: number }>;
    topWeapons: Array<{ weapon: string; kills: number; headshots: number; damage: number; hsRate: number }>;
  };
  utilityStats: {
    byType: Array<{
      type: string;
      thrown: number;
      enemiesFlashed?: number;
      damageDealt?: number;
      successfulSmokes?: number;
      effectiveness?: number;
    }>;
    total: number;
  };
  teamStats: {
    team1: { name: string; score: number; totalKills: number; totalDeaths: number; totalAssists: number; totalDamage: number; averageKD: number; averageADR: number };
    team2: { name: string; score: number; totalKills: number; totalDeaths: number; totalAssists: number; totalDamage: number; averageKD: number; averageADR: number };
  };
  topPerformers: {
    topKiller: Cs2PlayerWithStats;
    topADR: Cs2PlayerWithStats;
    topKD: Cs2PlayerWithStats;
    topHS: Cs2PlayerWithStats;
    mostMVPs: Cs2PlayerWithStats;
  };
  recentKills?: unknown[];
  demos?: Array<{ id: string; fileName: string; fileSize: string; downloadUrl?: string | null; recordedAt: string; expiresAt?: string | null }>;
}

const stats = await client.matches.getStats('map-uuid-123');

console.log(`${stats.match.team1Name} ${stats.match.team1Score} - ${stats.match.team2Score} ${stats.match.team2Name}`);
console.log(`Map: ${stats.match.map} | Rounds: ${stats.overview.totalRounds}`);
console.log(`Kills: ${stats.overview.totalKills} | Headshots: ${stats.overview.totalHeadshots}`);

const top = stats.topPerformers;
console.log(`Top killer: ${top.topKiller.name} (${top.topKiller.kills}K)`);
console.log(`Top ADR: ${top.topADR.name} (${top.topADR.adr ?? 0})`);
console.log(`Top HS%: ${top.topHS.name} (${top.topHS.hsPercent ?? 0}%)`);

const stats = await client.matches.getStats('map-uuid-123');

// By category (Rifle, Sniper, SMG, Pistol, Heavy, Other)
stats.weaponStats.byCategory?.forEach(cat => {
  console.log(`${cat.category}: ${cat.kills} kills, ${cat.headshots} HS`);
});

// Top 5 weapons
stats.weaponStats.topWeapons.forEach((w, i) => {
  console.log(`${i + 1}. ${w.weapon}: ${w.kills} kills, ${w.hsRate.toFixed(1)}% HS`);
});

// Utility
console.log(`Total utility thrown: ${stats.utilityStats.total}`);
stats.utilityStats.byType.forEach(u => {
  const pct = stats.utilityStats.total ? (u.thrown / stats.utilityStats.total * 100).toFixed(1) : '0';
  console.log(`  ${u.type}: ${u.thrown} (${pct}%)`);
});

const stats = await client.matches.getStats('map-uuid-123');
const t1 = stats.teamStats.team1;
const t2 = stats.teamStats.team2;

console.log(`${t1.name}: ${t1.totalKills}K / ${t1.totalDeaths}D, ${t1.totalDamage} dmg, avg KD ${t1.averageKD.toFixed(2)}`);
console.log(`${t2.name}: ${t2.totalKills}K / ${t2.totalDeaths}D, ${t2.totalDamage} dmg, avg KD ${t2.averageKD.toFixed(2)}`);

const stats = await client.matches.getStats('map-uuid-123');

for (const p of stats.players) {
  console.log(`\n${p.name} (${p.kills}/${p.deaths}/${p.assists})`);
  const weapons = (p.weaponStats ?? []).slice().sort((a, b) => b.kills - a.kills).slice(0, 5);
  weapons.forEach(w => console.log(`  ${w.weaponName}: ${w.kills}K, ${w.headshots} HS`));
}