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)}")
    time.sleep(1)  # Small delay to avoid overwhelming the server

Search and Analyze Maps

Search and analyze maps
import vlrdevapi as vlr

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

if series_results:
    series = series_results[0]  # First result
    print(f"Series: {series.name}")
    
    # Get detailed map data
    series_info = vlr.series.info(series.series_id)
    if series_info:
        print(f"\nMaps played:")
        for map_data in series_info.maps:
            print(f"  {map_data.map_name}: {map_data.team1_score}-{map_data.team2_score}")

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.

Tips

  • Check list length before accessing results: if series_results:
  • All optional fields can be None - check before using
  • Use the series_id (which is a match ID) with series.info() for detailed match data
  • Series results include individual matches from events
  • Combine with series.info() to get map-by-map details, picks/bans, and player stats

Source

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