VLRdevAPI

Event Info

Fetch detailed metadata for a specific event - name, series, dates, prize information, location, and regions.

event.info(event_id) returns comprehensive metadata for a single event on vlr.gg.

Signature

event.info(event_id: int) -> EventInfo

Parameters

Prop

Type

Returns - EventInfo

Prop

Type

Prop

Type

EventStageTag Fields

Prop

Type

EventRegion Fields

Prop

Type

EventPrize Fields

Prop

Type

EventLocation Fields

Prop

Type

Examples

Basic event info

Fetch the core identifying information for an event - its name, subtitle, series, and thumbnail.

import vlrdevapi

info = vlrdevapi.event(2765).info()
print(f"Name: {info.name}")
print(f"Subtitle: {info.subtitle}")
print(f"Series: {info.series.name} ({info.series.href})")

Dates and prize pool

Retrieve scheduling details and financial information. The start_date and end_date fields contain datetime.date objects. Prize details are available via the prize sub-object with structured amount and currency fields.

import vlrdevapi

info = vlrdevapi.event(2765).info()
print(f"Start: {info.start_date}")
print(f"End: {info.end_date}")
print(f"Prize: {info.prize.raw_text}")
if info.prize.amount:
    print(f"Amount: {info.prize.currency_symbol}{info.prize.amount:,}")

Location and regions

Access the event's physical location and associated regions. Events can have multiple regions (e.g. an International event) and may have separate region-level and venue-level locations.

import vlrdevapi

info = vlrdevapi.event(2765).info()
if info.location:
    print(f"Location: {info.location.country}")
    print(f"Venue: {info.location.venue}")
if info.region_location:
    print(f"Region: {info.region_location.country}")
for region in info.regions:
    print(f"Tag: {region.name}")

Series and stage context

The series and stage fields link the event to its broader competitive circuit. Use the href values to construct relative URLs for navigation.

import vlrdevapi

info = vlrdevapi.event(2765).info()
print(f"Series: {info.series.name} ({info.series.href})")
print(f"Stage: {info.stage.name} ({info.stage.href})")

Last updated on

On this page