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
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
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 serverSearch 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) withseries.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
Related
Source
Data scraped from: https://www.vlr.gg/search/?q={query}&type=series