v1.4.0
🐍Python 3.11+
The Ultimate Python Library
for VLR.gg
Access Valorant esports data with a clean, type-safe Python API. Get tournament info, match schedules, player stats, and more in seconds.
$pip install vlrdevapi
$uv add vlrdevapi
Complete Data Access
Events, matches, players, teams, series, and search functionality at your fingertips.
Type-Safe
Frozen Python dataclasses with rich type hints for a better development experience.
Production-Ready
Built-in error handling, retry logic, and rate limiting for robust applications.
Easy to Use
Simple, intuitive API design that lets you focus on building, not scraping.
example.py
Inputimport vlrdevapi as vlr
# Search for anything
results = vlr.search.search("nrg")
print(f"Found {results.total_results} results")
# Get upcoming matches
matches = vlr.matches.upcoming(limit=5)
for match in matches:
print(f"{match.team1.name} vs {match.team2.name}")terminal
Output$ python example.py
Found 42 results
NRG vs Sentinels
Cloud9 vs 100 Thieves
Leviatán vs KRÜ Esports
G2 Esports vs Evil Geniuses
LOUD vs FURIA