Stats
The Valorant stats API for Python
Pull Valorant player, team, and match statistics from VLR.gg in Python. VLRdevAPI returns typed models you can feed straight into a dashboard or notebook.
VLRdevAPI exposes Valorant statistics from VLR.gg as typed Python objects. It covers player agent stats and match history, team stats and placements, match scoreboards, and series-level round and economy data.
Statistics you can query
Player stats
Profiles and agent usage. Player profiles with top agents, per-agent statistics, and match history across events.
Team stats
Performance and placement. Aggregate team stats, event placements, roster history, and transactions.
Match stats
Scoreboards and maps. Final scores, per-map results, and player scoreboards for completed matches.
Series stats
Rounds and economy. Round-by-round timelines, performance data, and economy breakdowns for a series.
Standings
Groups and tables. Event group standings and stage tables from VCT and regional circuits.
News
Context and write-ups. The VLR.gg news feed and full articles for background on results.
Quickstart
Install the package and read a player profile. Stats arrive as typed models, ready to convert into a DataFrame or render in a dashboard.
import vlrdevapi
profile = vlrdevapi.player(438).profile()
print(f"{profile.name} - {', '.join(a.agent for a in profile.top_agents[:3])}")More detail in the quickstart docs.
Getting Valorant stats in Python
| VLRdevAPI | Scraping tables | Manual copy | |
|---|---|---|---|
| Data | Player, team, match, series stats | Whichever tables you parse | Whatever you copy by hand |
| Format | Typed models | HTML tables | Spreadsheets |
| Refresh | Re-fetch with one call | Re-scrape and re-parse | Manual |
| Rate limiting | Built in | Your responsibility | Not applicable |
| Maintenance | Handled in the library | High | Manual |
Frequently asked questions
- What player statistics are available?
- Player profiles include name, country, team, and top agents, plus agent statistics and match history across events.
- Can I get team statistics?
- Yes. The team namespace returns info, rosters, stats, placements, and transactions.
- Is match scoreboard data included?
- Yes. Completed matches include scores and per-map results, and series data adds round-by-round and economy statistics.
- Can I build a dashboard with this?
- Yes. Every response is a Pydantic model, so you can convert it to dictionaries or DataFrames and render it with any Python web or charting library.
- How current is the data?
- VLRdevAPI reads VLR.gg on each request, so data reflects what VLR.gg currently shows. Responses are cached briefly and the cache is configurable.
- Is there a free tier?
- There are no tiers. The SDK is free and open source, and applies a built-in rate limit so you stay within reasonable request volumes.
More answers in the full FAQ.
Related
Player analytics with pandas
Load stats into a DataFrame and analyze them.
Event analytics with Polars
Analyze event and match data with Polars.
Player reference
Methods and models for player data.
Team stats reference
Methods and models for team statistics.
Valorant esports API
The full set of esports data in Python.
Valorant API for Python
Install and work with typed models.