teams.placements()
Get event placements for a team
Signature
import vlrdevapi as vlr
result = vlr.teams.placements(
team_id: int,
timeout: float = 5.0
) -> list[EventPlacement]Parameters
Prop
Type
Return Value
Type: list[EventPlacement]
Returns a list of event placements.
Prop
Type
PlacementDetail fields:
Prop
Type
Examples
Get Event Placements
import vlrdevapi as vlr
# Get all placements
placements = vlr.teams.placements(team_id=799)
print(f"Event placements: {len(placements)}")
for event in placements:
print(f"\n{event.event_name} ({event.year})")
for detail in event.placements:
print(f" {detail.series} - {detail.place}")
if detail.prize_money:
print(f" Prize: {detail.prize_money}")Filter by Year
import vlrdevapi as vlr
placements = vlr.teams.placements(team_id=799)
# Get 2024 placements
placements_2024 = [p for p in placements if p.year == "2024"]
print(f"2024 placements: {len(placements_2024)}")
for event in placements_2024:
print(f" {event.event_name}")Error Handling
- Network failures: Returns an empty list
[] - Invalid team ID: Returns an empty list
[] - No placements: 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/team/{team_id}