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
matches.upcoming()
Get upcoming matches with pagination support
matches.live()
Fetch matches that are currently live
matches.completed()
Browse recently completed matches with scores
Quick Example
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