Skip to main content
GET
/
cs2
/
v1
/
players
List CS2 players
curl --request GET \
  --url https://ticktock.bet/cs2/v1/players \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "hltv_id": 7998,
      "nickname": "s1mple",
      "country_code": "UA",
      "current_team_hltv_id": 6651
    }
  ],
  "meta": {
    "count": 1
  }
}

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 directory keyed by HLTV id. Filter by current team via team_hltv_id; search runs the same trigram-ranked match used by the unified search endpoint — exact → prefix → substring → fuzzy similarity, scored 0–1. When search is supplied, results come back ordered by relevance score. Without it, the default sort is nickname A→Z.

​
Required scope

  • Minimum: cs2:players:list

​
Example

curl -H "X-API-Key: $TT_KEY" \
  "https://ticktock.bet/cs2/v1/players?search=s1mple"
Trigram tolerates typos: 
curl -H "X-API-Key: $TT_KEY" \
  "https://ticktock.bet/cs2/v1/players?search=zywo"
For global autocomplete across all entity types in one call, use GET /cs2/v1/search.

Authorizations

​
X-API-Key
string
header
required

Tenant API key issued during onboarding

Query Parameters

​
team_hltv_id
integer | null

Filter by current team's HLTV ID.

​
search
string | null

Trigram-ranked search on nickname. Exact > prefix > substring > fuzzy similarity. Same ranking the unified /search endpoint uses.

​
limit
integer
default:100
Required range: 1 <= x <= 500

Response

Successful Response

The response is of type Response List Players Cs2 V1 Players Get · object.

Last modified on May 10, 2026