Get Team
Team profile + per-map stats from HLTV
GET
/
cs2
/
v1
/
teams
/
{hltv_id}
CS2 team profile + per-map stats
curl --request GET \
--url https://ticktock.bet/cs2/v1/teams/{hltv_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://ticktock.bet/cs2/v1/teams/{hltv_id}"
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/teams/{hltv_id}', 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/teams/{hltv_id}",
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/teams/{hltv_id}"
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/teams/{hltv_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://ticktock.bet/cs2/v1/teams/{hltv_id}")
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": {
"hltv_id": 11712,
"name": "Sashi",
"country_code": "DK",
"world_ranking": 42,
"region": "EMEA",
"time_filter": "3months",
"map_stats": [
{
"map_name": "all",
"maps_played": 87,
"wins": 51,
"losses": 33,
"win_rate": 0.586,
"rating": 1.06,
"ct_round_win_pct": 0.524,
"t_round_win_pct": 0.481
}
]
}
}{
"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
Team identity (name, country, ranking, region) plus the per-mapmap_stats block:
map_stats[] field | Meaning |
|---|---|
map_name | "all" for the aggregate, otherwise the HLTV map slug (e.g. de_inferno) |
maps_played, wins, draws, losses, win_rate | Volume + W/L |
total_kills, total_deaths, kd_ratio, rating | Aggregate skill metrics |
rounds_played, rounds_won, round_win_rate | Round-level |
ct_round_win_pct, t_round_win_pct | Side splits |
pistol_rounds, pistol_rounds_won, pistol_win_pct | Pistol-round W/L |
pick_pct, ban_pct | Map veto preference |
first_kill_win_pct, first_death_win_pct | First-kill conversion |
map_details.{first_kill_win_pct_ct, first_kill_win_pct_t, first_death_loss_pct_ct, first_death_loss_pct_t} | Per-side first-duel splits |
top_player_opening_kills[] | Per-roster opening-kill leaderboard (player_id, nickname, opening_kpr/dpr) |
players_opening | Same data raw |
players_flash | Per-player flash assists (when scraped) |
opening_kpr | Team-level opening KPR (sum of player successes / rounds) |
map_stats always includes the "all" aggregate plus one row per map the team has played in the requested window.
Required scope
- Minimum:
cs2:teams:read
Query
| Param | Default | Description |
|---|---|---|
time_filter | 3m | Window for map_stats. Accepts 3m, 6m, 1y, all. |
Example
curl -H "X-API-Key: $TT_KEY" \
"https://ticktock.bet/cs2/v1/teams/11712?time_filter=6m"
Authorizations
XAPIKeyHeaderXAccessTokenHeaderUOFAccessTokenHeader
Tenant API key issued during onboarding
Path Parameters
Query Parameters
Window for map_stats: 3m, 6m, 1y, all.
Response
Successful Response
The response is of type Response Get Team Cs2 V1 Teams Hltv Id Get · object.
Last modified on May 10, 2026
Previous
Team ExtrasCompute-on-demand team aggregations not stored in TeamMapStats — economy profile, OT, LAN/online, map streaks, race-to-N, headshot %, map pool
Next
⌘I
CS2 team profile + per-map stats
curl --request GET \
--url https://ticktock.bet/cs2/v1/teams/{hltv_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://ticktock.bet/cs2/v1/teams/{hltv_id}"
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/teams/{hltv_id}', 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/teams/{hltv_id}",
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/teams/{hltv_id}"
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/teams/{hltv_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://ticktock.bet/cs2/v1/teams/{hltv_id}")
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": {
"hltv_id": 11712,
"name": "Sashi",
"country_code": "DK",
"world_ranking": 42,
"region": "EMEA",
"time_filter": "3months",
"map_stats": [
{
"map_name": "all",
"maps_played": 87,
"wins": 51,
"losses": 33,
"win_rate": 0.586,
"rating": 1.06,
"ct_round_win_pct": 0.524,
"t_round_win_pct": 0.481
}
]
}
}{
"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)"
}