Analytics

Advanced player and team analytics including trends, comparisons, and insights

Player Performance Trends

GET/cod/analytics/players/:id/trends

Track a player's performance over time. Perfect for visualizing improvement or slumps.

Query Parameters

Parameter	Type	Description
`stat`	string	Stat to track (kd, damage, kills, etc.)
`period`	string	Time period (match, tournament, season)

Example Request

GET /api/v1/cod/analytics/players/simp/trends?stat=kd&period=tournament

Response

{
  "success": true,
  "player": "Simp",
  "stat": "kd",
  "period": "tournament",
  "data": [
    { "label": "CDL Major 1", "value": 1.24, "date": "2025-01-26" },
    { "label": "CDL Kickoff", "value": 1.18, "date": "2025-01-12" },
    { "label": "CDL Major 4 2024", "value": 1.31, "date": "2024-06-15" }
  ],
  "average": 1.24,
  "trend": "stable"
}

Player Clutch Factor

GET/cod/analytics/players/:id/clutch-factor

Analyze a player's performance in high-pressure situations including 1vX clutches, first bloods, and round-deciding plays.

Response

{
  "success": true,
  "player": "Simp",
  "clutchFactor": {
    "overall": 8.7,
    "rank": 3,
    "breakdown": {
      "1v1": { "attempts": 45, "wins": 32, "winPct": 0.71 },
      "1v2": { "attempts": 18, "wins": 8, "winPct": 0.44 },
      "1v3": { "attempts": 5, "wins": 1, "winPct": 0.20 }
    },
    "firstBloods": {
      "total": 156,
      "perRound": 0.23,
      "rank": 5
    },
    "tradedDeaths": {
      "rate": 0.68,
      "rank": 8
    }
  }
}

Head-to-Head Comparison

GET/cod/analytics/head-to-head

Compare two players' stats against each other in matches where they've faced off.

Query Parameters

Parameter	Type	Description
`player1`*	string	First player ID/IGN
`player2`*	string	Second player ID/IGN

Example Request

GET /api/v1/cod/analytics/head-to-head?player1=simp&player2=shotzzy

Response

{
  "success": true,
  "player1": { "ign": "Simp", "team": "Atlanta FaZe" },
  "player2": { "ign": "Shotzzy", "team": "OpTic Texas" },
  "matchesPlayed": 24,
  "headToHead": {
    "player1Wins": 13,
    "player2Wins": 11
  },
  "stats": {
    "kd": { "player1": 1.22, "player2": 1.18 },
    "damagePer10": { "player1": 3912, "player2": 3847 },
    "killsPer10": { "player1": 25.1, "player2": 24.5 }
  }
}

Compare Multiple Players

GET/cod/analytics/compare

Compare stats across multiple players (up to 5). Great for building comparison tables.

Query Parameters

Parameter	Type	Description
`players`*	string	Comma-separated player IDs

Example Request

GET /api/v1/cod/analytics/compare?players=simp,abezy,cellium

Response

{
  "success": true,
  "players": [
    {
      "ign": "Simp",
      "team": "Atlanta FaZe",
      "stats": { "kd": 1.22, "damage": 3912, "kills": 25.1 }
    },
    {
      "ign": "aBeZy",
      "team": "Atlanta FaZe",
      "stats": { "kd": 1.15, "damage": 3650, "kills": 24.8 }
    },
    {
      "ign": "Cellium",
      "team": "Atlanta FaZe",
      "stats": { "kd": 1.28, "damage": 4250, "kills": 23.2 }
    }
  ]
}

Team Style Analysis

GET/cod/analytics/teams/:slug/style

Analyze a team's playstyle including aggression metrics, rotation tendencies, and strategic patterns.

Response

{
  "success": true,
  "team": "Atlanta FaZe",
  "playstyle": {
    "aggression": 7.8,
    "rotationSpeed": 8.2,
    "mapControl": 7.5,
    "slayingPower": 8.9,
    "objectivePlay": 7.1
  },
  "tendencies": {
    "preferredMaps": ["Rewind", "Protocol"],
    "strongestMode": "Hardpoint",
    "weakestMode": "Control"
  }
}

Team Head-to-Head

GET/cod/analytics/teams/head-to-head

Compare two teams' historical record against each other.

Query Parameters

Parameter	Type	Description
`team1`*	string	First team slug
`team2`*	string	Second team slug

Example Request

GET /api/v1/cod/analytics/teams/head-to-head?team1=optic-texas&team2=atlanta-faze

Response

{
  "success": true,
  "team1": { "slug": "optic-texas", "name": "OpTic Texas" },
  "team2": { "slug": "atlanta-faze", "name": "Atlanta FaZe" },
  "allTime": {
    "team1Wins": 18,
    "team2Wins": 22,
    "mapRecord": { "team1": 65, "team2": 72 }
  },
  "currentSeason": {
    "team1Wins": 2,
    "team2Wins": 3,
    "lastMatch": {
      "date": "2025-01-26",
      "winner": "atlanta-faze",
      "score": "3-2"
    }
  }
}

Team Map Comparison

GET/cod/analytics/teams/map-comparison

Compare map performance between multiple teams.

Query Parameters

Parameter	Type	Description
`teams`*	string	Comma-separated team slugs

Analytics Leaderboard

GET/cod/analytics/leaderboard/:stat

Get top performers for advanced analytics stats like clutch factor, first blood rate, and trade efficiency.

Example Request

GET /api/v1/cod/analytics/leaderboard/clutch_factor

Response

{
  "success": true,
  "stat": "clutch_factor",
  "data": [
    { "rank": 1, "player": "Simp", "team": "Atlanta FaZe", "value": 8.7 },
    { "rank": 2, "player": "Cellium", "team": "Atlanta FaZe", "value": 8.5 },
    { "rank": 3, "player": "Shotzzy", "team": "OpTic Texas", "value": 8.3 }
  ]
}

Statistics