VlrDevApi

search.search_events()

Search for events

Signature

import vlrdevapi as vlr

result = vlr.search.search_events(
    query: str,
    timeout: float = 5.0
) -> list[SearchEventResult]

Parameters

Prop

Type

Return Value

Type: list[SearchEventResult]

Returns a list of event search results.

Prop

Type

Examples

Search for Events

Search for events
import vlrdevapi as vlr

# Search for events
events = vlr.search.search_events("champions")

print(f"Found {len(events)} events")
for e in events:
    print(f"{e.name}")
    print(f"  Dates: {e.date_range}")
    print(f"  Prize: {e.prize}")
    print(f"  URL: {e.url}")

Get Event Details

Get event details
import vlrdevapi as vlr

# Search and get full info
events = vlr.search.search_events("vct")

for event in events[:3]:  # First 3 results
    print(f"\nFound: {event.name}")
    
    # Get detailed event info
    event_info = vlr.events.info(event.event_id)
    if event_info:
        print(f"  Name: {event_info.name}")
        print(f"  Prize: {event_info.prize}")
        print(f"  Location: {event_info.location}")
        print(f"  Dates: {event_info.date_text}")

Error Handling

  • Network failures: Returns an empty list []
  • No results found: Returns an empty list []
  • Empty query: Returns an empty list []

The function never raises exceptions, making it safe to use without try-catch blocks.

Source

Data scraped from: https://www.vlr.gg/search/?q={query}&type=events