Unified Search

GET

cs2

Unified CS2 search across matches, teams, players, tournaments

curl --request GET \
  --url https://ticktock.bet/cs2/v1/search \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://ticktock.bet/cs2/v1/search"

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/search', 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/search",
  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/search"

	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/search")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ticktock.bet/cs2/v1/search")

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": [
    {
      "type": "team",
      "id": 11712,
      "label": "Sashi",
      "sub_label": "EMEA · #42",
      "score": 1
    },
    {
      "type": "match",
      "id": "52ef0d9c-7c1f-4c4e-9b3a-4a5e2f8b1c10",
      "label": "Sashi vs OG",
      "sub_label": "ESL Pro League S20 · live",
      "score": 1
    },
    {
      "type": "player",
      "id": 7998,
      "label": "s1mple",
      "sub_label": "Aleksandr Kostyliev",
      "score": 0.68
    },
    {
      "type": "tournament",
      "id": 7902,
      "label": "ESL Pro League S20",
      "sub_label": "2026 · S-tier · LAN",
      "score": 0.41
    }
  ],
  "meta": {
    "count": 4,
    "by_type": {
      "team": 1,
      "match": 1,
      "player": 1,
      "tournament": 1
    },
    "types_searched": [
      "matches",
      "teams",
      "players",
      "tournaments"
    ],
    "q": "sashi"
  }
}

{
  "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": [
    {
      "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

One flat, score-sorted list of mixed-type hits. Each item carries a type discriminator (match / team / player / tournament), the entity’s stable id, a short label for the primary line, a sub_label for the secondary line, and a score between 0 and 1. Hits are intentionally lean — clients follow up with GET /cs2/v1/{type}/{id} when the user picks one. Designed for global autocomplete bars: one round-trip per keystroke, no client-side merging across four list endpoints.

Required scope

No single scope is required at the endpoint level. Instead, each result type is filtered by the matching list scope:

Result type	Required scope
`match`	`cs2:matches:list`
`team`	`cs2:teams:list`
`player`	`cs2:players:list`
`tournament`	`cs2:tournaments:list`

Missing a scope simply drops that type from the response — no 403. A key with zero list scopes gets an empty data array. This lets the same endpoint serve narrow-scope keys (e.g. team-only autocomplete) and broad operator keys without a distinct URL per audience.

Ranking

Tiered relevance score over each entity’s name column, taking the max across tiers:

Tier	Match condition	Score
exact (case-insensitive)	`lower(name) = lower(q)`	1.00
prefix	`name ILIKE 'q%'`	0.90
substring	`name ILIKE '%q%'`	0.70
trigram similarity	pg_trgm `similarity(name, q)`	0.00 – 1.00

Rows scoring below 0.15 are dropped. Trigram tier handles typos and partial words (“vitalty” → “Vitality”, “naturl” → “Natural”) via Postgres pg_trgm GIN indexes. Match search. Matches don’t carry their own name. They’re scored via FK joins — a match’s score is max(team_a_score, team_b_score, tournament_score). Typing a team surfaces that team’s upcoming/live/recent fixtures; typing a tournament surfaces all its matches.

Behaviour notes

Minimum query length is 2 characters. Single-char queries match too broadly to rank usefully and return 400.
limit is the total across all types, not a per-type cap. One result type can fill all slots when no others match.
types= is honoured first, then scope-filtered. Asking for types=teams,players with a teams-only key returns teams; the unknown-to-this-key players type is silently dropped.
Stable ordering on ties. Matches are passed in first, so when a team and a match tie on score, the match wins — fixtures are the most actionable autocomplete result.

Examples

Autocomplete across everything:

curl -H "X-API-Key: $TT_KEY" \
  "https://ticktock.bet/cs2/v1/search?q=vitality&limit=8"

Teams + players only, deeper result list:

curl -H "X-API-Key: $TT_KEY" \
  "https://ticktock.bet/cs2/v1/search?q=zyw&types=teams,players&limit=20"

Find upcoming fixtures by tournament name:

curl -H "X-API-Key: $TT_KEY" \
  "https://ticktock.bet/cs2/v1/search?q=blast+major&types=matches&limit=15"

GET /cs2/v1/teams?search= — same ranking, scoped to teams, supports pagination and region filter.
GET /cs2/v1/players?search= — same ranking, scoped to players, supports current-team filter.

Authorizations

X-API-Key

string

header

required

Tenant API key issued during onboarding

Query Parameters

string

required

Search query. Minimum 2 characters.

Minimum string length: 2

types

string | null

Comma-separated subset of matches,teams,players,tournaments. Omitted → all four (subject to scope filtering).

limit

integer

default:10

Maximum results across all types combined.

Required range: 1 <= x <= 50

Response

Successful Response

The response is of type Response Unified Search Cs2 V1 Search Get · object.

Last modified on May 10, 2026

List MatchesBucketed list of live, upcoming, and finished CS2 matches

Unified CS2 search across matches, teams, players, tournaments

curl --request GET \
  --url https://ticktock.bet/cs2/v1/search \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://ticktock.bet/cs2/v1/search"

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/search', 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/search",
  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/search"

	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/search")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ticktock.bet/cs2/v1/search")

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": [
    {
      "type": "team",
      "id": 11712,
      "label": "Sashi",
      "sub_label": "EMEA · #42",
      "score": 1
    },
    {
      "type": "match",
      "id": "52ef0d9c-7c1f-4c4e-9b3a-4a5e2f8b1c10",
      "label": "Sashi vs OG",
      "sub_label": "ESL Pro League S20 · live",
      "score": 1
    },
    {
      "type": "player",
      "id": 7998,
      "label": "s1mple",
      "sub_label": "Aleksandr Kostyliev",
      "score": 0.68
    },
    {
      "type": "tournament",
      "id": 7902,
      "label": "ESL Pro League S20",
      "sub_label": "2026 · S-tier · LAN",
      "score": 0.41
    }
  ],
  "meta": {
    "count": 4,
    "by_type": {
      "team": 1,
      "match": 1,
      "player": 1,
      "tournament": 1
    },
    "types_searched": [
      "matches",
      "teams",
      "players",
      "tournaments"
    ],
    "q": "sashi"
  }
}

{
  "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": [
    {
      "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

Ranking

Behaviour notes

Examples

Authorizations

Query Parameters

Response

​What it returns

​Required scope

​Ranking

​Behaviour notes

​Examples

​Related

Authorizations

Query Parameters

Response

What it returns

Required scope

Ranking

Behaviour notes

Examples

Related