Valorant esports API
The Valorant esports API for Python
Query Valorant esports data from VLR.gg in Python. VLRdevAPI returns matches, results, standings, rosters, players, and event data as typed models. Free, and no API key required.
VLRdevAPI is a free, typed Python API for Valorant esports data. It covers VCT and regional competition data on VLR.gg, including upcoming and completed matches, live scores, group standings, team rosters, and player statistics.
Esports data you can query
Matches and results
Upcoming, live, and completed. Match schedules, live scores, and final results with per-map scoreboards.
Standings
Groups and placements. Event group tables, team placements, and stage-by-stage standings.
Teams
Rosters and history. Team info, active rosters, aggregate stats, placements, and transactions.
Players
Profiles and agent stats. Player profiles, top agents, agent statistics, and match history.
Events
Tournaments and stages. Event listings, stages, participating teams, and match schedules.
Series
VODs and round data. Series info, VOD links, round timelines, performance, and economy data.
Quickstart
The same pattern works across every namespace. Install the package, then read upcoming matches or drill into a specific team.
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}")More detail in the quickstart docs.
Where does the data come from?
| VLRdevAPI | Riot official API | Community JSON services | |
|---|---|---|---|
| Coverage | Pro esports results, standings, rosters | Account and in-game match data | Varies by service |
| Source | VLR.gg | Riot | Unofficial scrapers |
| Output | Typed Pydantic models | Riot JSON | Custom JSON |
| API key | Not required | Required | Sometimes required |
| Cost | Free | Free tier with limits | Varies |
| Maintenance | Handled in the library | Riot-maintained | Varies |
Frequently asked questions
- Is there a Valorant esports API?
- Riot does not publish a general esports results API. VLRdevAPI provides one for Python by reading VLR.gg, which tracks professional Valorant matches and events.
- What esports data can I access?
- Upcoming, live, and completed matches with scores; event stages and standings; team rosters, stats, and placements; player profiles and agent stats; series, VODs, and round data; and news articles.
- Does it cover VCT?
- Yes. VLR.gg tracks VCT and regional Valorant circuits, and VLRdevAPI returns whatever VLR.gg lists, including event stages and standings.
- Can I get live match data?
- Yes. vlrdevapi.matches.live() returns matches that are currently in progress.
- Do I need a Riot API key?
- No. VLRdevAPI does not use the Riot API and does not require a key of any kind.
- How current is the data?
- VLRdevAPI reads VLR.gg on each request, so results reflect what VLR.gg currently shows. Responses are cached briefly and the cache is configurable.
More answers in the full FAQ.
Related
VLR.gg API for Python
Why an unofficial client exists and what it covers.
Valorant API for Python
Install the SDK and work with typed models.
Valorant stats API
Player, team, and match statistics in Python.
Documentation
Guides and the full API reference.
Build a match monitor
Track live Valorant matches with Python.
How the options compare
VLRdevAPI against other Valorant data sources.