CS2 API matches
List finished CS2 matches. Filter by team, event, and a UTC date range.
Reference
CS2 API documentation
Public paid endpoints cover played and upcoming matches, per-map scores and player box scores, teams, events, maps, players, and countries. Start with the free quickstart, then open an area. Building a Discord bot or tracker? See the CS2 Match Data API guide. Looking for an HLTV API? Read what this product is and is not.
Quick start
1. Get a free API key from the login or cabinet page. 2. Send it in the X-API-Key header. 3. Call a public endpoint — pick your stack:
Prefer TypeScript shapes? See request & response types..
Authorizations
API key from the GGScore cabinet. Do not send this key as Authorization: Bearer. Bearer is a cabinet session token.
X-API-Keyheader · apiKeyAPI key
Get keys in the cabinetPaid endpoints require this header. GET /api/v2/ping does not, and it does not count toward the daily cap.
Full endpoint reference
Each area has its own page, with parameters, code samples, and Try it.
CS2 score API results
One finished match: series score, each map's round totals, and player lines when that map was ingested.
CS2 upcoming matches API
Fixtures that do not have a final score yet. This is the upcoming list, not a live round feed.
CS2 player stats API
A player and recent map lines: kills, deaths, assists, ADR, and rating when that map was ingested.
CS2 teams API
Alphabetical team directory and one team card (id, title, logo when available).
CS2 events API
Tournament directory and one event card. Ids match the event on a match.
CS2 maps API
Maps from finished matches, plus recent results for a slug such as mirage.
Countries
Country rows used for filters and team geography.
Endpoints
The public routes. Open one for parameters, code samples, and Try it.
Matches
Teams
Events
Maps
Plans
The free key and the paid plans call the same results, schedule, and player box score endpoints. See pricing.