Documentation

VLRdevAPI is a Python library that provides a clean, type-safe interface for fetching Valorant esports data from VLR.gg. It handles scraping, parsing, and data normalization so you can focus on building your application.

FeaturesCopy Anchor Link

• Match Data - Fetch upcoming and completed matches with detailed statistics
• Player Profiles - Access player stats, agent usage, and performance metrics
• Team Information - Get team rosters, rankings, and match history
• Event Coverage - Browse tournaments, schedules, and results
• News & Articles - Browse the news listing and fetch full articles with Markdown content
• Type-Safe - Full type hints for better IDE support and fewer runtime errors
• Concurrent Fetching - Multi-stage endpoints fetch their pages in parallel with a thread pool

QuickstartCopy Anchor Link

# with uv (recommended)
uv add vlrdevapi

# or with pip
pip install vlrdevapi

import vlrdevapi

page = vlrdevapi.matches.upcoming()
for match in page.matches[:3]:
    team1 = match.team1.name if match.team1 else "TBD"
    team2 = match.team2.name if match.team2 else "TBD"
    print(f"{team1} vs {team2} | {match.event}")

Popular use casesCopy Anchor Link

• VLR.gg API for Python - Why an unofficial client exists for VLR.gg, and what it fetches
• Valorant esports API - Query Valorant esports data from VLR.gg in Python
• Valorant API for Python - Install the client and work with typed models
• Valorant stats API - Player, team, and match statistics in Python

MoreCopy Anchor Link

• Tutorial guides - Step-by-step walkthroughs for real projects
• Blog - Builds, comparisons, and deep dives
• FAQ - Answers about installation, rate limits, and data coverage