🎮 CS2 API Documentation

The CS2 API provides read-only access to Counter-Strike data including tournaments, teams, players, matches with per-map results, live scores, and ML predictions. 400+ teams and 2,800+ matches. All responses are JSON.

Every API request requires a token. Get yours by registering a free account on sports.bzzoiro.com.

Include the token in the Authorization header:

Authorization: Token YOUR_API_KEY

Example:

curl -H "Authorization: Token abc123def456" https://csgo.bzzoiro.com/api/tournaments/

All list endpoints return paginated results with 50 items per page.

{
  "count": 85,
  "next": "https://csgo.bzzoiro.com/api/matches/?page=2",
  "previous": null,
  "results": [ ... ]
}

Use ?page=N to navigate pages.

1. Register: Create a free account at sports.bzzoiro.com/register/
2. Get your token: After registering you'll find your API token on your dashboard. The same token works across all platforms.
3. Make a request:

   curl -H "Authorization: Token YOUR_API_KEY" https://csgo.bzzoiro.com/api/matches/

4. Explore: Use the endpoints above to fetch teams, players, matches, live scores, and predictions.

import requests

API_TOKEN = "YOUR_API_KEY"
BASE_URL = "https://csgo.bzzoiro.com/api"
headers = {"Authorization": f"Token {API_TOKEN}"}

# Get upcoming predictions
resp = requests.get(f"{BASE_URL}/predictions/", headers=headers)
data = resp.json()

for pred in data["results"]:
    match = pred["match"]
    print(f"{match['home_team']['name']} vs {match['away_team']['name']}")
    print(f"  Winner: {pred['predicted_winner']} "
          f"(Home: {pred['home_win_prob']:.2f} "
          f"Away: {pred['away_win_prob']:.2f})")
    print(f"  Confidence: {pred['confidence']:.2f}")
    print()

# Get upcoming matches with map details
matches = requests.get(
    f"{BASE_URL}/matches/?status=notstarted",
    headers=headers
).json()
for match in matches["results"]:
    print(f"{match['home_team']['name']} vs {match['away_team']['name']}")
    print(f"  Best of {match['best_of']}")
    print()

# Get live matches
live = requests.get(f"{BASE_URL}/live/", headers=headers).json()
for match in live["results"]:
    print(f"LIVE {match['home_team']['name']} {match['home_score']}-"
          f"{match['away_score']} {match['away_team']['name']}")
    for m in match.get("maps", []):
        print(f"  {m['map_name']}: {m['home_score']}-{m['away_score']}")