Docsesportsodds.gg
Matches

Where a match is being broadcast

The channels carrying a match, official broadcast first and then by audience. **This is a live pointer, not a historical record.** The set is replaced in full on every refresh while a match is in progress, and it is emptied when the match ends — a channel URL stops resolving to this match once the broadcast is over, so a finished match returns an empty list rather than dead links. Do not store these rows as a match archive. Streams appear once a match is IN PROGRESS. A scheduled match that has not started returns an empty list even when a broadcast is already announced. `viewers` is the count at `observed_at`, not a live figure, and is `null` when the channel did not report one — which is not the same as zero. `platform` is one of `twitch`, `kick`, `youtube` or `other`; treat it as an open list. `embed_url` is the platform's embeddable player URL and is omitted when the channel has none. An unknown match id returns an empty list.

GET
/v1/{game}/matches/{id}/streams

The channels carrying a match, official broadcast first and then by audience.

This is a live pointer, not a historical record. The set is replaced in full on every refresh while a match is in progress, and it is emptied when the match ends — a channel URL stops resolving to this match once the broadcast is over, so a finished match returns an empty list rather than dead links. Do not store these rows as a match archive.

Streams appear once a match is IN PROGRESS. A scheduled match that has not started returns an empty list even when a broadcast is already announced.

viewers is the count at observed_at, not a live figure, and is null when the channel did not report one — which is not the same as zero. platform is one of twitch, kick, youtube or other; treat it as an open list. embed_url is the platform's embeddable player URL and is omitted when the channel has none.

An unknown match id returns an empty list.

Authorization

AuthorizationBearer <token>

Primary auth (live). Authorization: Bearer <api-key> — the header takes precedence over the query fallback. The raw key is hashed (SHA-256, hex) and looked up in api.keys.key_hash; the raw value is never stored.

In: header

Path Parameters

game*string

Game slug. cs2 is the only populated title today; an un-onboarded game 404s cleanly.

id*string

Resource identifier — either a UUID or the resource's human-readable slug, scoped to {game}. /v1/cs2/teams/natus-vincere and /v1/cs2/teams/019f23d1-fb5c-7987-b522-47c3a5e72111 address the same row, so you can go straight from a slug you already have without first looking up its id.

Slugs work on teams, players and tournaments. Matches have no slug, so a match id must be a UUID. Either way, an identifier that resolves to nothing returns 404 not_found.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/matches/019f2858-e253-7f3d-bdff-bc7738bd1036/streams"
{  "data": [    {      "id": "01a0b8d1-6c21-7a0e-9f11-3c2f0a91d001",      "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",      "platform": "kick",      "channel": "starladder",      "url": "https://kick.com/starladder",      "embed_url": "https://player.kick.com/starladder",      "language": "en",      "official": true,      "viewers": 460,      "observed_at": "2026-09-18T22:05:11.201884Z"    },    {      "id": "01a0b8d1-6c21-7b4c-8d02-51ab0c7de002",      "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",      "platform": "kick",      "channel": "circuitx",      "url": "https://kick.com/circuitx",      "language": "pt",      "official": false,      "viewers": 1314,      "observed_at": "2026-09-18T22:05:11.201884Z"    },    {      "id": "01a0b8d1-6c21-7cf8-b7e3-9d640ac1e003",      "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",      "platform": "twitch",      "channel": "VanFanTV",      "url": "https://www.twitch.tv/vanfantv",      "embed_url": "https://player.twitch.tv/?channel=vanfantv",      "language": "en",      "official": false,      "viewers": 0,      "observed_at": "2026-09-18T22:05:11.201884Z"    }  ],  "meta": {    "count": 3,    "next_cursor": null  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578"  }}

{  "error": {    "code": "rate_limited",    "message": "rate limit exceeded",    "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578"  }}

Per-player performance stats for one match GET

Player stat lines — whole-match aggregates (null map_number) first, then per-map rows. Ratings are our own proprietary computation. Enveloped: `{"data": [PlayerMatchStats, ...], "meta": {...}}` (not cursor-paginated; `next_cursor` is null).

Map veto (pick/ban) sequence for one match GET

The match's map pick/ban sequence in veto order (a CS2 bo3 runs ban/ban/pick/pick/ban/ban/decider). The decider step carries a null `team_id` — no team makes that choice. Unknown match id yields an empty list. Enveloped: `{"data": [MapVeto, ...], "meta": {...}}` (not cursor-paginated; `next_cursor` is null).