VlrDevApi

search.search_series()

Search for series

Signature

import vlrdevapi as vlr

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

Parameters

Prop

Type

Return Value

Type: list[SearchSeriesResult]

Returns a list of series search results.

Prop

Type

Examples

Search for Series

Search for series
import vlrdevapi as vlr

# Search for series
series_results = vlr.search.search_series("vct")

print(f"Found {len(series_results)} series")
for s in series_results:
    print(f"Series ID: {s.series_id}")
    print(f"  Name: {s.name}")
    print(f"  URL: {s.url}")

Get Series Details

Get series details
import vlrdevapi as vlr
import time

# Search and get full info
series_results = vlr.search.search_series("champions")

for series in series_results[:3]:  # First 3 results
    print(f"\nFound: {series.name}")
    
    # Get detailed series info
    series_info = vlr.series.info(series.series_id)
    if series_info:
        print(f"  Teams: {series_info.teams[0].name} vs {series_info.teams[1].name}")
        print(f"  Score: {series_info.score[0]}-{series_info.score[1]}")
        
        # Get map data
        maps_data = vlr.series.matches(series.series_id)
        print(f"  Maps: {len(maps_data)}")

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=series