Skip to main content
GET
/
cs2
/
v1
/
matches
/
{match_id}
/
players
Per-player per-map stats for one match
curl --request GET \
  --url https://ticktock.bet/cs2/v1/matches/{match_id}/players \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "id": "52ef0d9c-7c1f-4c4e-9b3a-4a5e2f8b1c10",
    "team_a": "Sashi",
    "team_b": "OG",
    "team_a_logo": "https://images.ticktock.bet/teams/sashi.png",
    "team_b_logo": "https://images.ticktock.bet/teams/og.png",
    "event": "ESL Pro League S20",
    "bo_type": "bo3",
    "status": "live",
    "scheduled_at": "2026-05-10T17:00:00+00:00",
    "score_a": 1,
    "score_b": 0,
    "map_name": "de_mirage"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ticktock.bet/llms.txt

Use this file to discover all available pages before exploring further.

​
What it returns

Per-player rows grouped by map for one match. Each row carries:
  • Box score — kills, deaths, assists, headshots, headshot_pct
  • ScoreBot derived — survived_rounds, opening_kills, opening_deaths, double_kills, triple_kills, quad_kills, ace_kills
  • HLTV authoritative (post-match only) — adr, kast, rating
For live matches and matches whose post-match HLTV scoreboard hasn’t been scraped yet, adr / kast / rating are null. The ScoreBot-derived fields are available throughout the match — derived from the per-round event blob the tracker writes to each round. When the HLTV scoreboard is available, our box-score fields (kills, deaths, headshots, …) are reconciled against HLTV — HLTV wins for those, ScoreBot wins for the per-round derived ones.

​
Required scope

  • Minimum: cs2:matches:detail

​
Query

ParamDescription
map_numberFilter to a single map (1, 2, 3, …). Omit to get every map in the series.

​
Example

curl -H "X-API-Key: $TT_KEY" \
  "https://ticktock.bet/cs2/v1/matches/52ef…/players?map_number=2"

{
  "data": {
    "match_id": "52ef…",
    "team_a": "Sashi",
    "team_b": "OG",
    "maps": [
      {
        "map_id": "…",
        "map_number": 2,
        "map_name": "Mirage",
        "rounds_played": 22,
        "players": [
          {
            "player_name": "s1mple",
            "team_name": "OG",
            "side": "CT",
            "kills": 24,
            "deaths": 16,
            "assists": 4,
            "headshots": 12,
            "headshot_pct": 0.5,
            "survived_rounds": 8,
            "opening_kills": 5,
            "opening_deaths": 2,
            "adr": 92.4,
            "kast": 0.78,
            "rating": 1.31,
            "double_kills": 6,
            "triple_kills": 2,
            "quad_kills": 1,
            "ace_kills": 0
          }
        ]
      }
    ]
  }
}

​
Use cases

  • Player props grading — opening kill, multi-kill, headshot props.
  • Post-match performance dashboards — show ADR/KAST/Rating side-by-side.
  • Form aggregation — feed multiple matches into your own player-form model.

Authorizations

​
X-API-Key
string
header
required

Tenant API key issued during onboarding

Path Parameters

​
match_id
string<uuid>
required

Query Parameters

​
map_number
integer | null

Filter to a specific map (1, 2, 3…). Omit for all maps.

Response

Successful Response

The response is of type Response Get Match Players Cs2 V1 Matches Match Id Players Get · object.

Last modified on May 10, 2026