VlrDevApi

Matches

Browse upcoming, live, and completed matches from VLR.gg

The vlrdevapi.matches module exposes functions to read match listings with clean, typed models.

Functions

Quick Example

Get upcoming matches
import vlrdevapi as vlr

# Get next 5 upcoming matches
matches = vlr.matches.upcoming(limit=5)

for m in matches:
    print(f"{m.event} - {m.event_phase}")
    print(f"  {m.team1.name} vs {m.team2.name}")
    print(f"  Time: {m.time}")
    if m.team1.id and m.team2.id:
        print(f"  IDs: {m.team1.id} vs {m.team2.id}")

Notes

  • Team IDs are enriched by quickly opening the match header. They may be None for TBD teams.
  • Network failures return an empty list.
  • All functions support pagination for browsing large result sets.

Source

Data scraped from: https://www.vlr.gg/matches and https://www.vlr.gg/matches/results