Match Players

GET

cs2

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>'

import requests

url = "https://ticktock.bet/cs2/v1/matches/{match_id}/players"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://ticktock.bet/cs2/v1/matches/{match_id}/players', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ticktock.bet/cs2/v1/matches/{match_id}/players",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ticktock.bet/cs2/v1/matches/{match_id}/players"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://ticktock.bet/cs2/v1/matches/{match_id}/players")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ticktock.bet/cs2/v1/matches/{match_id}/players")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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",
    "hltv_event_id": 7438,
    "team_a_hltv_id": 7187,
    "team_b_hltv_id": 5995,
    "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"
  }
}

{
  "detail": "Missing X-API-Key or $x$access-token header"
}

{
  "detail": "Required scope 'cs2:matches:detail' is not granted to this API key. Contact your account manager to extend the key's scopes."
}

{
  "detail": "Match not found"
}

{
  "detail": [
    {
      "type": "enum",
      "loc": [
        "query",
        "time_filter"
      ],
      "msg": "Input should be one of: 3m, 6m, 1y, all",
      "input": "2w"
    }
  ]
}

{
  "detail": "Rate limit exceeded (600 req/min)"
}

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

Param	Description
`map_number`	Filter 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

Get Match TimelineRound-by-round events with VOD anchors — the dispute-resolution surface

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>'

import requests

url = "https://ticktock.bet/cs2/v1/matches/{match_id}/players"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://ticktock.bet/cs2/v1/matches/{match_id}/players', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ticktock.bet/cs2/v1/matches/{match_id}/players",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ticktock.bet/cs2/v1/matches/{match_id}/players"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://ticktock.bet/cs2/v1/matches/{match_id}/players")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ticktock.bet/cs2/v1/matches/{match_id}/players")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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",
    "hltv_event_id": 7438,
    "team_a_hltv_id": 7187,
    "team_b_hltv_id": 5995,
    "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"
  }
}

{
  "detail": "Missing X-API-Key or $x$access-token header"
}

{
  "detail": "Required scope 'cs2:matches:detail' is not granted to this API key. Contact your account manager to extend the key's scopes."
}

{
  "detail": "Match not found"
}

{
  "detail": [
    {
      "type": "enum",
      "loc": [
        "query",
        "time_filter"
      ],
      "msg": "Input should be one of: 3m, 6m, 1y, all",
      "input": "2w"
    }
  ]
}

{
  "detail": "Rate limit exceeded (600 req/min)"
}

Overview

Search

Matches

Markets

Settlements

Tournaments

Teams

Players

Maps

Stream (WebSocket)

What it returns

Required scope

Query

Example

Use cases

Authorizations

Path Parameters

Query Parameters

Response

​What it returns

​Required scope

​Query

​Example

​Use cases

Authorizations

Path Parameters

Query Parameters

Response

What it returns

Required scope

Query

Example

Use cases