TutorialCS2 API tutorials

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
GET /cs2/matches/results?limit=2200 OK
$ curl "https://api.citoapi.com/api/v1/cs2/matches/results?limit=2" \ -H "x-api-key: $CITO_API_KEY"
{  "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.

Shell
export CITO_API_KEY="cito_..."   # from citoapi.com/signup

Step 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
curl -s "https://api.citoapi.com/api/v1/cs2/matches/results?limit=5" -H "x-api-key: $CITO_API_KEY"
Latest finished matches from GET /cs2/matches/results. Fetched from the production CS2 API on 20 Nov 2026, 13:15 UTC.
MatchScoreEventFormat
G2 Ares vs megoshort1–0CCT 2026 Europe Series 15 Closed QualifierBo3
Butterfly vs PRIVATE0–1GLuck Yungstar 2026 WildcardBo3
PRIVATE vs Enjoy1–2GLuck Yungstar 2026 WildcardBo3
SEGA DLL vs ABT0–2Master League Portugal Season 19Bo3
Nemesis vs 330–2NODWIN Clutch Series 14Bo3
NT vs BAKS0–2CCT 2026 Europe Series 14Bo3
Balkan Outlaws vs FORZE Reload0–2European Pro League Series 10Bo3
Walczaki vs Noir Verse0–1CCT 2026 Europe Series 15 Closed QualifierBo3
Black Phoenix vs Butterfly1–0GLuck Yungstar 2026 WildcardBo3
FarmVille vs EMPIRE2–1CROSSFIRE Season 7Bo3

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
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.

Python: the whole flow
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.

See pricing

Build CS2 live score apps

Free is for building and testing. Paid plans add commercial use, real-time live data and the full archive.