Leetify APIapi-public-docs.cs-prod.leetify.com ↗

"""Walkthrough: Leetify CS2 API — player profiles, match history, match details."""
from parse_apis.leetify_public_cs_api import Leetify, ResourceNotFound

client = Leetify()

# Validate an API key — quick connectivity check.
status = client.apikeystatuses.validate(api_key="test-key")
print(f"Key valid: {status.valid} | {status.message}")

# Fetch a player profile by Steam64 ID — typed fields on the result.
player = client.players.get(steam64_id="76561197969209908")
print(f"Player: {player.name} | Matches: {player.total_matches} | Winrate: {player.winrate}")
print(f"Rating — Aim: {player.rating.aim}, Positioning: {player.rating.positioning}")
print(f"Ranks — Premier: {player.ranks.premier}, Faceit: {player.ranks.faceit}")

# Walk the player's match history (limit= caps total items fetched).
for entry in player.match_history(limit=3):
    print(f"Match {entry.id[:8]}… | {entry.map_name} | {entry.data_source} | banned={entry.has_banned_player}")
    for ts in entry.team_scores:
        print(f"  Team {ts.team_number}: {ts.score}")

# Drill into a single match for full per-player stats.
first_match = player.match_history(limit=1).first()
if first_match:
    match = first_match.details()
    print(f"\nMatch detail: {match.map_name} ({match.finished_at})")
    for ps in match.stats:
        print(f"  {ps.name}: K/D {ps.total_kills}/{ps.total_deaths} | Rating: {ps.leetify_rating}")

# Alternative match lookup by data source ID.
alt_match = client.matches.get_by_source(data_source="matchmaking", data_source_id=match.data_source_match_id)
print(f"\nSame match via source: {alt_match.map_name} | {alt_match.id}")

# Typed error handling: catch ResourceNotFound on a bad lookup.
try:
    client.players.get(steam64_id="00000000000000000")
except ResourceNotFound as exc:
    print(f"\nExpected error: {exc}")

print("\nExercised: apikeystatuses.validate / players.get / match_history / details / matches.get_by_source / ResourceNotFound")