Skip to content
GGScore logoGGScore

CS2 API Features

GGScore provides three main endpoints for Counter-Strike 2 match data. All endpoints return JSON and support standard REST conventions. Use your API key in the X-API-Key header. See the API documentation for full details.

Countries

GET /api/v2/countries

Returns a list of all countries used in CS2 match data. Useful for filtering matches by region or building location-based features. Each country includes id, title, and image URL.

Played Matches

GET /api/v2/matches

Fetch completed CS2 match results with pagination. Includes teams, scores, event, match kind (BO1, BO3, etc.), played date, and HLTV link. Ideal for match trackers and historical analytics.

Upcoming Matches

GET /api/v2/upcoming_matches

Get upcoming CS2 fixtures and scheduled matches. Same structure as played matches — teams, event, date — so you can build calendars, notifications, and countdown widgets.

Why developers choose our CS2 API

  • — Structured JSON: no HTML parsing, no regex. Clean data out of the box.
  • — Pagination: handle large datasets with offset and limit.
  • — RESTful: standard HTTP, works with any client library.
  • — Rate limits per plan: Free (3/day), Premium (100/day), Black (unlimited).
  • — Swagger docs: try endpoints directly in the browser.

Authentication

All data endpoints require an API key. Get your key from the cabinet after signing in. Include it in the X-API-Key header with every request.

curl -H "X-API-Key: your_api_key" https://api.ggscore.net/api/v2/matches

Response format

All endpoints return JSON. Match objects include team names, images, scores, event info, match kind (BO1, BO3, BO5), played date, and HLTV links. Countries include id, title, and image URL. Responses use standard HTTP status codes: 200 (success), 401 (invalid key), 429 (rate limit exceeded).

Rate limits & quotas

PlanRequests/dayAPI keys
Free31
Premium100Up to 5
BlackUnlimitedUnlimited

Use cases by endpoint

Countries

  • • Region filters for match lists
  • • Location-based UI
  • • Country flags and labels

Played matches

  • • Match history and results
  • • Analytics and stats
  • • Fantasy scoring

Upcoming matches

  • • Match calendars
  • • Notifications and alerts
  • • Countdown widgets

Need more?

Check the API documentation for full schemas and examples. Have a custom use case? Contact us — we may be able to help.