csstats APIcsstats.gg ↗

"""Walkthrough: CSStats SDK — Counter-Strike 2 player stats, matches, leaderboards."""
from parse_apis.CSStats_gg_API import CSStats, LeaderboardMode, PlayerNotFound

cs = CSStats()

# Search for a player by name
for result in cs.players.search(query="s1mple", limit=3):
    print(result.name, result.steam_id, result.profile_url)

# Drill into the first search result's full stats
first = cs.players.search(query="s1mple", limit=1).first()
if first:
    player = first.details()
    print(player.name, player.steam_id)
    for stat_name, stat_value in player.overview.items():
        print(f"  {stat_name}: {stat_value}")

# List recent matches for a player
full_player = cs.players.get(steam_id="76561197978186923")
for match in full_player.matches.list(limit=3):
    print(match.date, match.map, match.score, match.k, match.d, match.rating)

# Get the full scoreboard for a specific match
match = full_player.matches.list(limit=1).first()
if match:
    board = match.scoreboard()
    for team in board.teams:
        for mp in team:
            print(f"  {mp.name} K:{mp.k} D:{mp.d} A:{mp.a} Rating:{mp.rating}")

# Browse the premier leaderboard
for entry in cs.leaderboard(mode=LeaderboardMode.PREMIER).top(limit=5):
    print(entry.rank, entry.name, entry.elo)

# Typed error handling for a non-existent player
try:
    cs.players.get(steam_id="00000000000000000")
except PlayerNotFound as exc:
    print(f"Player not found: {exc.steam_id}")

# Fetch global ban statistics
report = cs.ban_reports.fetch()
print(f"Bans in last 30 days: {report.total_bans_30d}")

print("exercised: players.search / players.get / details / matches.list / scoreboard / leaderboard.top / ban_reports.fetch")