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}")Calculate Total Prize Money
import vlrdevapi as vlr
import re
placements = vlr.teams.placements(team_id=799)
total_prize = 0
for event in placements:
for detail in event.placements:
if detail.prize_money:
# Extract numeric value from prize string
match = re.search(r'\$([\d,]+)', detail.prize_money)
if match:
amount = int(match.group(1).replace(',', ''))
total_prize += amount
print(f"Total prize money: ${total_prize:,}")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.
Tips
- Check list length before accessing:
if placements: - All optional fields can be
None- check before using - Placements are sorted by year (most recent first)
- Combine with
events.info(event_id)to get full event details - The
placementsfield is always a list, neverNone
Related
Source
Data scraped from: https://www.vlr.gg/team/{team_id}