Where a match is being broadcast
The channels carrying a match, official broadcast first and then by audience.
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.
The primary way to authenticate: Authorization: Bearer <api-key>. When a request also carries ?apiKey=, the header wins. We store only a SHA-256 hash of a key, never the key itself.
In: header
Path Parameters
Game slug. cs2 is the only populated title today; an un-onboarded game 404s cleanly.
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.
A team or a player also answers to a slug it was renamed away from, as long as no current team or player holds that slug — so a link made before a rename keeps working. The row returned carries its current slug.
Response Body
application/json
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": "match_merged", "message": "this match id was merged into 01a0d06b-4e06-7e01-905d-7384ae3c7ce1; use that id", "request_id": "01a12d10-6b2e-7d3a-9a4f-2c1d0e9b8a77" }}{ "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" }}