VLR Dev API
A clean Python client for Valorant esports data from VLR.gg
Welcome
VLR Dev API is a typed Python client for Valorant esports data scraped from VLR.gg.
- Typed models with safe defaults
- Consistent, human-friendly function signatures
- Null-safe examples and clear error handling
- Built-in rate limiting (10 req/s default, configurable)
Quick Start
import vlrdevapi as vlr
# Upcoming matches
matches = vlr.matches.upcoming(limit=5)
for m in matches:
print(m.event, '-', m.team1.name, 'vs', m.team2.name)Get Started
Installation
Install the package with pip and verify your setup
Quick Start
First request, best practices, and common patterns
API Reference
Browse all modules, functions, models, and examples
Popular Modules
Search
Players, teams, events, and series
Matches
Upcoming, live, and completed
Events
Info, matches, standings, summaries
Players
Profiles, matches, agent stats
Teams
Info, roster, matches, placements
Series
Headers and per-map statistics
Example: End-to-end
import vlrdevapi as vlr
team = vlr.teams.info(team_id=1034)
if team:
roster = vlr.teams.roster(team.team_id)
upcoming = vlr.teams.upcoming_matches(team.team_id, limit=2)
print(f"{team.name} ({team.tag}) - {team.country}")
print(f"Roster: {len(roster)} players")
print("\nNext matches:")
for match in upcoming:
print(f" {match.tournament_name}: {match.team1.name} vs {match.team2.name}")