VLR APIvlr.gg ↗

"""Walkthrough: VLR.gg Valorant Esports SDK — bounded, re-runnable."""
from parse_apis.vlr_gg_valorant_esports_api import (
    VLR, MatchStatus, Timespan, PlayerRegion, RankingRegion, ResourceNotFound
)

client = VLR()

# List current events and check agent pick rates for the first one.
event = client.events.list(limit=1).first()
if event:
    print(f"Event: {event.name} (id={event.event_id})")
    for agent in event.agents.list(limit=5):
        print(f"  {agent.agent}: {agent.pick_rate}")

# Browse recent completed matches, then drill into one for map-level stats.
match_summary = client.matchsummaries.list(status=MatchStatus.RESULTS, limit=1).first()
if match_summary:
    print(f"Match: {match_summary.team1} vs {match_summary.team2}")
    detail = match_summary.details()
    for map_result in detail.maps:
        print(f"  {map_result.map}: {map_result.score1}-{map_result.score2}")

# Player stats leaderboard filtered by region and timespan.
for player in client.playerstats.list(
    timespan=Timespan.SIXTY_DAYS, region=PlayerRegion.NA, limit=3
):
    print(f"{player.player} ({player.team}) — rating: {player.rating}, KD: {player.kd}")

# Team rankings and drill into team details with typed error handling.
ranking = client.teamrankings.list(region=RankingRegion.NORTH_AMERICA, limit=1).first()
if ranking:
    try:
        team = ranking.details()
        print(f"{team.team_name} roster: {len(team.roster)} members")
        for member in team.roster[:3]:
            print(f"  {member.player} — {member.role or 'player'}")
    except ResourceNotFound as exc:
        print(f"Team not found: {exc}")

print("exercised: events.list / agents.list / matchsummaries.list / details / playerstats.list / teamrankings.list / team details")