Matches

Per-player CS2 depth breakdowns for one match

The five CS2 depth breakdowns for one match, grouped into a single object: per-player weapons, grenades, hitgroups (body hit-group distribution), duels (the killer→victim kills matrix) and flashes…

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

The five CS2 depth breakdowns for one match, grouped into a single object: per-player weapons, grenades, hitgroups (body hit-group distribution), duels (the killer→victim kills matrix) and flashes (the flasher→flashed blind matrix). These are per-MATCH aggregates (not per map). Each group is a flat array whose elements carry their own player_id (and, for duels/flashes, the ordered pair of player ids), so a client groups by player itself. A match with no depth on record (older or lower-tier matches — roughly one in six lack it) returns every group as an empty array (never null); an unknown match id does the same. Single-resource envelope: {"data": {weapons, grenades, hitgroups, duels, flashes}}. Already fetching the match? ?include=depth on GET /v1/{game}/matches/{id} returns this inside that response, in the same request (several at once: include=maps,stats,depth).

Authorization

AuthorizationBearer <token>

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. To try the API with no account, use the public sample key eo_sample_public: one published key, shared by everyone, that reads a fixed sample of past matches within daily limits. For evaluation; our Terms apply.

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.

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/depth"
{  "data": {    "weapons": [      {        "id": "01a0b3da-19a2-7701-ba5c-62163a0fdae4",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "weapon_slug": "galil-ar",        "weapon_name": "Galil AR",        "weapon_class": "Rifle",        "team_side": "t",        "shots": 51,        "hits": 13,        "kills": 5,        "headshots": 2,        "damage": 419,        "wall_bangs": 0,        "trade_kills": 3,        "created_at": "2026-09-18T09:30:10.210859Z"      },      {        "id": "01a0b3da-19a2-7e78-b06f-b38c92fc4a8d",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "weapon_slug": "ak-47",        "weapon_name": "AK-47",        "weapon_class": "Rifle",        "team_side": "t",        "shots": 90,        "hits": 10,        "kills": 4,        "headshots": 3,        "damage": 427,        "wall_bangs": 0,        "trade_kills": 1,        "created_at": "2026-09-18T09:30:10.210859Z"      }    ],    "grenades": [      {        "id": "01a0b3da-19a2-7eaa-9c6f-db8006638024",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "grenade_name": "Decoy Grenade",        "team_side": "t",        "owns": 0,        "throws": 1,        "hits": 0,        "kills": 0,        "created_at": "2026-09-18T09:30:10.210859Z"      },      {        "id": "01a0b3da-19a2-78c1-99ca-aacbf1027ac3",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "grenade_name": "Flashbang",        "team_side": "ct",        "owns": 1,        "throws": 3,        "hits": 3,        "kills": 0,        "created_at": "2026-09-18T09:30:10.210859Z"      }    ],    "hitgroups": [      {        "id": "01a0b3da-19a2-7f49-a174-69135ecd3261",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "hit_group": "Chest",        "team_side": "ct",        "hits": 10,        "damage": 186,        "kills": 1,        "created_at": "2026-09-18T09:30:10.210859Z"      },      {        "id": "01a0b3da-19a2-7c60-a457-5a79b1dfaaf6",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "hit_group": "Chest",        "team_side": "t",        "hits": 14,        "damage": 275,        "kills": 2,        "created_at": "2026-09-18T09:30:10.210859Z"      }    ],    "duels": [      {        "id": "01a0b3da-19a2-77c0-8c15-ee184bda4dac",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "killer_player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "victim_player_id": "019f28e2-76af-7029-97b5-70686851cd14",        "kind": "enemy",        "kills": 5,        "weapon_names": "M4A1, M4A1, M4A1, M4A4, MP9",        "created_at": "2026-09-18T09:30:10.210859Z"      },      {        "id": "01a0b55a-a37c-7cfa-a564-502ce254b543",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "killer_player_id": "01a0a3e2-96a0-7b37-8172-f2fae5cb4679",        "victim_player_id": "019f2bda-1afe-7645-b9dd-b05c9a89b19e",        "kind": "team",        "kills": 1,        "weapon_names": "AK-47",        "created_at": "2026-09-18T16:30:11.325144Z"      }    ],    "flashes": [      {        "id": "01a0b3da-19a2-7e28-8a64-b5117cd27449",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "flasher_player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "flashed_player_id": "019f28e2-22cb-7de3-b94b-7652094f468c",        "count": 5,        "duration_ns": 7217897904,        "created_at": "2026-09-18T09:30:10.210859Z"      },      {        "id": "01a0b3da-19a2-7aa2-baa5-474feee9aa5b",        "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",        "flasher_player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47",        "flashed_player_id": "019f28e2-22cb-74ea-af0f-0408f360cec2",        "count": 2,        "duration_ns": 4303754880,        "created_at": "2026-09-18T09:30:10.210859Z"      }    ]  }}
{  "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"  }}