CS2 API tutorials with code that runs.
Every tutorial here starts from a free key and ends with working code: getting match data, quickstarts in Python and Node.js, a Discord score bot, signed webhooks for match alerts, spreadsheets, stream overlays and AI agents. Pick the one closest to what you are building.
- Complete, runnable code
- Python, Node.js, curl
- 500 free requests / month
{ "success": true, "data": [ { "id": "cs2-match-2398974", "eventName": "ROG JOURNEY Autumn 2026", "bestOf": 3, "team1Name": "Ninjas in Pyjamas", "team2Name": "Eternal Fire", "score": { "team1": 2, "team2": 0 } }, { "id": "cs2-match-2398896", "eventName": "FOX Legacy Season 1", "bestOf": 3, "team1Name": "SAW", "team2Name": "Lazer Cats", "score": { "team1": 2, "team2": 0 } } ... ]}Where should I start?
If you have never called the API, start with How to get CS2 match data: three requests take you from a list of results to per-map player stats. Then pick the quickstart for your language, and add webhooks or the live stream when you need updates pushed.
Every page in CS2 API tutorials
- How to get CS2 match dataResults, maps and player lines for any pro match in three requests.
- Steam API rate limitsThe Steam Web API's limits, what happens past them, and how to stay under.
- Steam Web API for CS2 tutorialStep by step through Steam's CS2 methods, and where they stop.
- HLTV API alternative tutorialMove results, ratings, rankings and live scores to a CS2 API.
- CS2 Discord score bot tutorialA self-updating live scoreboard bot in discord.js.
- CS2 match alert webhooksGet a signed POST when a round, map or match ends.
- CS2 API in PythonLive scores, results and player stats with requests.
- CS2 API in Node.jsFetch CS2 data from JavaScript and TypeScript.
- CS2 Discord bot APILive score and result commands for a Discord bot.
- CS2 data in Google SheetsPull rankings and results into a spreadsheet.
- CS2 MCP server for AI agentsGive Claude, Cursor and ChatGPT real CS2 data.
- CS2 fantasy APIPlayer lines per map for fantasy scoring.
- CS2 stream overlay APILive scoreboard data for OBS overlays and widgets.
Frequently asked questions
Something missing? Email support@citoapi.com.
Do the tutorials work on the free plan?
Yes. Every tutorial runs on a free key (500 requests a month, 10 a minute). Webhooks need Pro or Scale, and the webhook tutorial says so up front.
Is there an official CS2 API SDK?
The API is plain REST JSON, so any HTTP client works; the tutorials use requests in Python and fetch in Node.js. AI agents can use the Cito MCP server (npx cito-mcp install).
Reference
- CS2 API documentationAuth, the response envelope, errors, rate limits and every endpoint.
- CS2 API endpointsEvery CS2 endpoint on one page, grouped by job.
- CS2 API errorsExact error messages, why they happen and the fix, with code.
- CS2 API pricingFree, Starter, Pro and Scale: requests, live delay and history per plan.
Build CS2 live score apps
Free is for building and testing. Paid plans add commercial use, real-time live data and the full archive.