How to get CS2 match data.
Get a free key at citoapi.com, then call GET /cs2/matches/results for finished matches, GET /cs2/matches/{matchId}/maps for each map's score, and GET /cs2/matches/{matchId}/player-stats for kills, ADR, KAST and rating per player. Three requests, JSON out.
- 3 requests
- Professional matches
- 500 free requests / month
{ "success": true, "data": [ { "id": "cs2-match-2400634", "eventName": "CCT 2026 Europe Series 15 Closed Qualifier", "bestOf": 3, "team1Name": "G2 Ares", "team2Name": "megoshort", "score": { "team1": 1, "team2": 0 } }, { "id": "cs2-match-2400618", "eventName": "GLuck Yungstar 2026 Wildcard", "bestOf": 3, "team1Name": "Butterfly", "team2Name": "PRIVATE", "score": { "team1": 0, "team2": 1 } } ... ]}Step 1: How do I get an API key?
Sign up at citoapi.com and the key is shown immediately; it starts with cito_. Keep it in an environment variable and send it in the x-api-key header. The free plan is 500 requests a month, enough to follow this tutorial many times over.
export CITO_API_KEY="cito_..." # from citoapi.com/signupStep 2: How do I list finished CS2 matches?
GET /cs2/matches/results returns finished matches newest first, each with its event, format, teams and final series score. Use limit and page to move through the list; meta.hasNext says whether there is another page.
curl -s "https://api.citoapi.com/api/v1/cs2/matches/results?limit=5" -H "x-api-key: $CITO_API_KEY"| Match | Score | Event | Format |
|---|---|---|---|
| G2 Ares vs megoshort | 1–0 | CCT 2026 Europe Series 15 Closed Qualifier | Bo3 |
| Butterfly vs PRIVATE | 0–1 | GLuck Yungstar 2026 Wildcard | Bo3 |
| PRIVATE vs Enjoy | 1–2 | GLuck Yungstar 2026 Wildcard | Bo3 |
| SEGA DLL vs ABT | 0–2 | Master League Portugal Season 19 | Bo3 |
| Nemesis vs 33 | 0–2 | NODWIN Clutch Series 14 | Bo3 |
| NT vs BAKS | 0–2 | CCT 2026 Europe Series 14 | Bo3 |
| Balkan Outlaws vs FORZE Reload | 0–2 | European Pro League Series 10 | Bo3 |
| Walczaki vs Noir Verse | 0–1 | CCT 2026 Europe Series 15 Closed Qualifier | Bo3 |
| Black Phoenix vs Butterfly | 1–0 | GLuck Yungstar 2026 Wildcard | Bo3 |
| FarmVille vs EMPIRE | 2–1 | CROSSFIRE Season 7 | Bo3 |
Step 3: How do I get each map's score?
Take a match id from step 2 and call GET /cs2/matches/{matchId}/maps. Each map comes back with its name, both scores, the winner and the team that picked it.
curl -s "https://api.citoapi.com/api/v1/cs2/matches/cs2-match-2400634/maps" -H "x-api-key: $CITO_API_KEY"Step 4: How do I get player stats for the match?
GET /cs2/matches/{matchId}/player-stats returns every player's line for each map: kills, deaths, assists, ADR, KAST and rating. That is the box score most CS2 sites show.
import os, requests
API = "https://api.citoapi.com/api/v1/cs2"
H = {"x-api-key": os.environ["CITO_API_KEY"]}
def get(path, **params):
r = requests.get(f"{API}{path}", headers=H, params=params, timeout=10)
r.raise_for_status()
return r.json()["data"]
match = get("/matches/results", limit=1)[0]
print(match["eventName"], "|", match["team1Name"], match["team1Score"], "-", match["team2Score"], match["team2Name"])
for m in get(f"/matches/{match['id']}/maps"):
print(m)
for line in get(f"/matches/{match['id']}/player-stats"):
print(line)Can I get the same data from Steam?
Not for professional matches: the Steam Web API has no endpoints for pro results, maps or player stats. Steam only exposes share codes for your own matchmaking games, and their stats have to be parsed out of the replay demo.
Frequently asked questions
Something missing? Email support@citoapi.com.
What is the easiest way to get CS2 match data?
Call a CS2 API: GET /cs2/matches/results for finished matches, then /maps and /player-stats for one match. No Steam keys, demos or parsing.
How far back does CS2 match data go?
The CS2 API indexes 34,261 matches. Free keys get 30 days of in-depth history, Starter 90 days, Pro and above the full archive.
Can I get live CS2 match data the same way?
Yes. GET /cs2/matches/live lists matches in progress; /cs2/live/{matchId}/scoreboard has the round, the score and each player's line.
Keep going
- CS2 match results APIFinal series scores, map scores and box scores.
- CS2 player stats APIRating, ADR, KAST and K/D per map, career and form.
- CS2 API in PythonLive scores, results and player stats with requests.
- Steam Web API empty match dataWhy Steam returns no CS2 match details, and where match data lives.
Build CS2 live score apps
Free is for building and testing. Paid plans add commercial use, real-time live data and the full archive.