Skip to content

CS2 maps API

Maps used in finished matches, plus recent results for a map slug such as dust2 or mirage.

GET/api/v2/maps

List maps used in played matches

Distinct CS2 maps referenced by finished matches. Each row includes slug (use in /maps/{slug}/recent_matches), title, and last_played_at.

Authorizations

X-API-Keyheader

Required. API key from the GGScore cabinet. Do not send this key as Authorization: Bearer. Bearer is a cabinet session token.

Request

curl -sS 'https://ggscore.net/api/v2/maps' \
  -H "X-API-Key: YOUR_API_KEY"

Try it

GET https://ggscore.net/api/v2/maps

Get keys in the cabinet

GET/api/v2/maps/{slug}/recent_matches

Recent played matches on a map

Returns up to limit finished matches that included the given map slug, ordered by played_at descending. Slugs match GET /maps items.

Authorizations

X-API-Keyheader

Required. API key from the GGScore cabinet. Do not send this key as Authorization: Bearer. Bearer is a cabinet session token.

Parameters

slugrequiredpath

Map slug from the catalog (e.g. dust2, mirage). Case-sensitive.

limitoptionalquery

Maximum matches to return (default 30, cap 100).

Request

curl -sS 'https://ggscore.net/api/v2/maps/mirage/recent_matches' \
  -H "X-API-Key: YOUR_API_KEY"

Try it

GET https://ggscore.net/api/v2/maps/mirage/recent_matches

Get keys in the cabinet