Skip to main content
GET
/
cs2
/
v1
/
players
/
{hltv_id}
CS2 player profile + per-map stats
curl --request GET \
  --url https://ticktock.bet/cs2/v1/players/{hltv_id} \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "hltv_id": 7998,
    "nickname": "s1mple",
    "current_team_name": "FaZe",
    "time_filter": "3months",
    "map_filter": "all",
    "map_stats": [
      {
        "map_name": "all",
        "rating": 1.31,
        "kd_ratio": 1.42,
        "headshot_pct": 0.498,
        "adr": 89.1,
        "kast": 0.762,
        "impact": 1.21
      }
    ]
  }
}

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

Player identity (name, age, country, current team) plus the deep map_stats block.

​
Top-level per-row fields

FieldMeaning
map_name, time_filterRow keys
rating, kd_ratio, headshot_pct, adr, kpr, dprStandard HLTV stats
maps_played, total_kills, total_deaths, rounds_playedVolume
kast, impactAdvanced
ct_kpr, t_kprPer-side KPR
opening_kpr, opening_dpr, opening_kill_ratioOpening duel volume
win_pct_after_opening_killTeam win % when this player gets the opening kill
weapon_kills.{ct,t}.{rifle,sniper,smg,pistol,grenade,other}Per-side weapon-category counts
detailed_weaponsPer-specific-weapon breakdown (ak-47, awp, m4a4, …) when scraped

​
Nested JSONB blocks

FieldShape
role_stats{firepower, opening, sniping, clutching, entrying, trading, utility}.{score, metrics}
individual_stats{overall, round_stats, opening_stats, weapon_stats}.{ct, t}
clutch_stats{ct, t}.{1v1, 1v2, 1v3, 1v4, 1v5}.{w, l}
multikill_stats{ct, t}.{2k, 3k, 4k, 5k, 2k_fast, 3k_fast, …}

​
Required scope

  • Minimum: cs2:players:read

​
Query

ParamDefaultDescription
mapallFilter to one map. Accepts all, de_inferno, inferno (without prefix), etc.
time_filter3mWindow. Accepts 3m, 6m, 1y, all.

​
Example

curl -H "X-API-Key: $TT_KEY" \
  "https://ticktock.bet/cs2/v1/players/7998?map=de_mirage&time_filter=6m"

Authorizations

​
X-API-Key
string
header
required

Tenant API key issued during onboarding

Path Parameters

​
hltv_id
integer
required

Query Parameters

​
map
string
default:all

Map filter: all or any HLTV map slug (e.g. de_inferno or inferno).

​
time_filter
string
default:3m

Window for map_stats: 3m, 6m, 1y, all.

Response

Successful Response

The response is of type Response Get Player Cs2 V1 Players Hltv Id Get · object.

Last modified on May 10, 2026