players.matches()
Get a player's match history
Signature
import vlrdevapi as vlr
result = vlr.players.matches(
player_id: int,
limit: int | None = None,
page: int | None = None,
timeout: float = 5.0
) -> list[Match]Parameters
Prop
Type
Return Value
Type: list[Match]
Returns a list of player matches. Each Match object contains:
Prop
Type
MatchTeam fields:
Prop
Type
Examples
Get Player Match History
import vlrdevapi as vlr
# Get recent matches for a player
matches = vlr.players.matches(player_id=123, limit=10)
for m in matches:
print(f"{m.event} - {m.stage} {m.phase}")
print(f" {m.player_team.name} vs {m.opponent_team.name}")
if m.result:
score = f"{m.player_score}-{m.opponent_score}" if m.player_score is not None else "N/A"
print(f" Result: {m.result.upper()} ({score})")
if m.date:
print(f" Date: {m.date}")Browse with Pagination
import vlrdevapi as vlr
# Get page 2 of player matches
matches = vlr.players.matches(player_id=123, page=2)
print(f"Found {len(matches)} matches on page 2")
for m in matches:
print(f"{m.event}: {m.result or 'TBD'}")Error Handling
- Network failures: Returns an empty list
[] - Invalid player ID: Returns an empty list
[] - No matches found: Returns an empty list
[]
The function never raises exceptions, making it safe to use without try-catch blocks.
Related
Source
Data scraped from: https://www.vlr.gg/player/matches/{player_id}