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.match_summaries.list(status=MatchStatus.RESULTS, limit=1).first()
if match_summary:
    print(f"Match: {match_summary.team1} vs {match_summary.team2}")
    detail = match_summary.details()
    print(f"  Format: {detail.format}, Date: {detail.date}")
    for stream in detail.streams[:3]:
        print(f"  Stream: {stream.name} ({stream.platform}) — {stream.url}")
    for map_result in detail.maps[:2]:
        print(f"  {map_result.map}: {map_result.score1}-{map_result.score2}")
    if detail.all_maps:
        print(f"  All-maps MVP: {detail.all_maps[0].player} (rating: {detail.all_maps[0].rating})")

# Player stats leaderboard filtered by region and timespan.
for player in client.player_stats.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.team_rankings.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 / match_summaries.list / details / player_stats.list / team_rankings.list / team details")