# Cito CS2 API CS2 API **Canonical:** https://apis.io/apis/citoapi/citoapi-cs2-api/ **Provider:** Cito CS2 API — https://apis.io/providers/citoapi/ **Base URL:** https://api.citoapi.com/api/v1 **Documentation:** https://citoapi.com/docs/api/cs2 Cito CS2 API CS2 API is one of 11 APIs that [Cito CS2 API](https://apis.io/providers/citoapi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include CS2. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas. Counter-Strike 2: live matches, results, maps, rounds, teams, players, events, rankings, stats and skins. **Beta.** CS2 is in beta. If anything looks wrong, email support@citoapi.com with the endpoint and the id you called. Docs: https://citoapi.com/docs/api/cs2 **Response shape.** Every response is `{ success, data, meta }`. Lists put rows in `data` and counts or paging in `meta`. **Ids.** Matches, teams, players and events have ids like `cs2-match-2398421`, `cs2-team-7020`, `cs2-player-11893`, `cs2-event-8038`. Teams, players and events also accept their slug (`vitality`, `zywoo`). **Paging.** `limit` sets how many rows come back. Each endpoint lists its own maximum (100 on most). Asking for more returns the maximum, not an error. Page with `offset` or `page` where the endpoint lists them. **Lists are compact.** List endpoints return summary rows. Fetch the single record (`/cs2/events/{eventIdOrSlug}`, `/cs2/teams/{teamIdOrSlug}`) for the full structure. **Images.** Logos, player photos, map images and event banners are served from `api.citoapi.com` and do not change address. An image field is `null` when we have no image for that record yet. Treat `null` as "no image" and show a placeholder. **Missing data.** When a record exists but a section has no data yet, the response says so with `data_available: false` and an `unavailable_reason`, rather than an error. **Times** are ISO 8601 in UTC. ## Operations (60 of 149) | Method | Path | Summary | |---|---|---| | GET | `/cs2` | CS2 API overview | | GET | `/cs2/status/sync` | CS2 data freshness | | GET | `/cs2/changelog` | CS2 data changelog | | GET | `/cs2/webhooks/events` | CS2 webhook event types | | GET | `/cs2/webhooks` | CS2 webhook event types | | POST | `/cs2/webhooks` | How to register a CS2 webhook | | GET | `/cs2/search` | Search CS2 | | GET | `/cs2/autocomplete` | CS2 autocomplete | | GET | `/cs2/roster-changes/recent` | Recent roster changes | | GET | `/cs2/transfers/recent` | Recent transfers | | GET | `/cs2/transfers` | Transfers | | GET | `/cs2/live/stream` | Live update stream (SSE) | | GET | `/cs2/live/{matchId}/socket` | Live socket details | | GET | `/cs2/live/{matchId}/scoreboard` | Live scoreboard | | GET | `/cs2/live/{matchId}/rounds` | Live rounds | | GET | `/cs2/live/{matchId}/events` | Live events | | GET | `/cs2/live/{matchId}/player-stats` | Live player stats | | GET | `/cs2/live/{matchId}/maps` | Live maps | | GET | `/cs2/live/{matchId}/snapshots` | Live snapshots | | GET | `/cs2/live/{matchId}/state` | Live state | | GET | `/cs2/live/{matchId}` | Live match | | GET | `/cs2/live` | Live matches | | GET | `/cs2/matches/live` | Live matches | | GET | `/cs2/matches/today` | Today's matches | | GET | `/cs2/matches/past` | Past matches | | GET | `/cs2/matches/search` | Search matches | | GET | `/cs2/matches/upcoming` | Upcoming matches | | GET | `/cs2/matches/recent` | Recent results | | GET | `/cs2/matches/results` | Recent results | | GET | `/cs2/matches/completed` | Recent results | | GET | `/cs2/matches/{matchId}/streams` | Match streams | | GET | `/cs2/matches/{matchId}/head-to-head` | Match head-to-head | | GET | `/cs2/matches/{matchId}/demos` | Match demos | | GET | `/cs2/matches/{matchId}/maps` | Match maps | | GET | `/cs2/matches/{matchId}/games` | Match games | | GET | `/cs2/matches/{matchId}/player-stats` | Match player stats | | GET | `/cs2/matches/{matchId}/lineup-stats` | Match lineup stats | | GET | `/cs2/matches/{matchId}/players` | Match player stats | | GET | `/cs2/matches/{matchId}/stats` | Match player stats | | GET | `/cs2/matches/{matchId}` | Match details | | GET | `/cs2/matches` | List matches | | GET | `/cs2/games/{gameId}/stats` | Map player stats | | GET | `/cs2/games/{gameId}/player-stats` | Map player stats | | GET | `/cs2/games/{gameId}/rounds` | Map rounds | | GET | `/cs2/games/{gameId}/events` | Map events | | GET | `/cs2/games/{gameId}` | Game details | | GET | `/cs2/maps` | Map catalog | | GET | `/cs2/map-pool` | Active map pool | | GET | `/cs2/maps/pool` | Active map pool | | GET | `/cs2/weapons` | Weapon catalog | | GET | `/cs2/regions` | Regions | | GET | `/cs2/leagues` | Leagues | | GET | `/cs2/skins/trending` | Trending skins | | GET | `/cs2/skins/search` | List skins | | GET | `/cs2/skins/{skinIdOrSlug}/prices` | Skin prices | | GET | `/cs2/skins/{skinIdOrSlug}/order-book` | Skin order book | | GET | `/cs2/skins/{skinIdOrSlug}/history` | Skin price history | | GET | `/cs2/skins/{skinIdOrSlug}` | Skin details | | GET | `/cs2/skins` | List skins | | GET | `/cs2/maps/{mapId}/stats` | Map player stats | …and 89 more operations. They are listed in full on the page. ## Machine-readable artifacts (7) - **OpenAPI** — https://artifacts.apis.io/citoapi/openapi/citoapi-cs2-api-openapi.yml - **JSONSchema** — https://artifacts.apis.io/citoapi/json-schema/citoapi-tennis-match-detail-response-schema.json - **JSONSchema** — https://artifacts.apis.io/citoapi/json-schema/citoapi-tennis-player-profile-schema.json - **JSONSchema** — https://artifacts.apis.io/citoapi/json-schema/citoapi-raf-bout-schema.json - **JSONSchema** — https://artifacts.apis.io/citoapi/json-schema/citoapi-tennis-live-match-detail-schema.json - **JSONSchema** — https://artifacts.apis.io/citoapi/json-schema/citoapi-tennis-tournament-detail-response-schema.json - **JSONSchema** — https://artifacts.apis.io/citoapi/json-schema/citoapi-bkfc-bout-schema.json ## Other Cito CS2 API APIs (10) - [Cito UFC API](https://apis.io/apis/citoapi/cito-ufc-api/) - [Cito CS2 API BKFC API](https://apis.io/apis/citoapi/citoapi-bkfc-api/) - [Cito CS2 API Call of Duty API](https://apis.io/apis/citoapi/citoapi-call-of-duty-api/) - [Cito CS2 API Dota 2 API](https://apis.io/apis/citoapi/citoapi-dota-2-api/) - [Cito CS2 API Fortnite API](https://apis.io/apis/citoapi/citoapi-fortnite-api/) - [Cito CS2 API QR Code API](https://apis.io/apis/citoapi/citoapi-qr-code-api/) - [Cito CS2 API RAF Wrestling API](https://apis.io/apis/citoapi/citoapi-raf-wrestling-api/) - [Cito CS2 API Tennis API](https://apis.io/apis/citoapi/citoapi-tennis-api/) - [Cito CS2 API UFC API](https://apis.io/apis/citoapi/citoapi-ufc-api/) - [Cito CS2 API Utility API](https://apis.io/apis/citoapi/citoapi-utility-api/) ## Tags CS2 --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/citoapi/citoapi-cs2-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/citoapi/.