Prefer to chat? Query the API with natural language using our AI Skill →

Give your AI tool live Cito endpoint context before you write integration code.

Open AI Skill

Public docs assistant

Tell Cito API what you are building.

Get endpoint recommendations, exact requests, code snippets, and a free-key CTA without digging through every page.

Docs/Call of Duty API/Analytics

Back to Call of Duty API

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