VLRdevAPI

VLR.gg API

The VLR.gg API for Python

VLR.gg does not publish a public API. VLRdevAPI is a free, open-source Python SDK that reads VLR.gg for you and returns typed objects, so you can query Valorant esports data without writing or maintaining a scraper.

Short answer: VLR.gg has no official API. VLRdevAPI is an unofficial Python client that fetches and parses VLR.gg pages, then returns Pydantic models. It needs no API key and runs on Python 3.11 or newer.

Read the docsTutorial guides

What you can fetch from VLR.gg

  • Matches

    Upcoming, live, and completed results. Scores, scoreboards, and match metadata from VCT and regional Valorant events.

  • Players

    Profiles and statistics. Agent usage, match history, and career statistics for professional Valorant players.

  • Teams

    Rosters and rankings. Team info, current rosters, placements, and match history.

  • Events

    Tournaments and standings. Event listings, stages, participating teams, and group standings.

  • Series

    VODs and round data. Series info, VOD links, round-by-round data, and player economy statistics.

  • News

    Articles and listings. The VLR.gg news feed and full articles returned as Markdown.

Quickstart

Install the package with pip, then fetch upcoming matches. Each match is a typed object with teams, event, stage, and start time.

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.

How do you get VLR.gg data in Python?

VLRdevAPIScraping VLR.ggRiot official API
Setuppip install vlrdevapiWrite and maintain parsersRegister an app and key
Data sourceVLR.gg esports pagesVLR.gg esports pagesRiot account and match endpoints
OutputTyped Pydantic modelsRaw HTMLRiot JSON
Rate limitingBuilt inYour responsibilityPer-key limits
CostFreeFreeFree tier with limits
API keyNot requiredNot requiredRequired

Frequently asked questions

Does VLR.gg have an API?
No. VLR.gg does not publish a public API. VLRdevAPI is an unofficial client that fetches and parses VLR.gg pages on your behalf.
Is VLRdevAPI free?
Yes. VLRdevAPI is free and open source under the MIT license. It does not require an API key, a subscription, or an account.
Is this an official VLR.gg or Riot product?
No. VLRdevAPI is an independent open-source project. It is not affiliated with, endorsed by, or connected to VLR.gg or Riot Games.
What can I fetch from VLR.gg?
Upcoming, live, and completed matches; player profiles and statistics; team rosters and rankings; events, stages, and standings; series, VODs, and round data; and the news feed.
Which Python versions are supported?
Python 3.11 and newer.
How fast can I request data?
The client applies a built-in rate limit and caches responses. Both are configurable, and multi-stage endpoints fetch their pages in parallel.

More answers in the full FAQ.

Related

Valorant esports API

A wider look at the esports data VLRdevAPI exposes in Python.

Getting started

Install the SDK and make your first request.

API reference

Every namespace, method, and model in the library.

Tutorial guides

Build a match monitor, a stats dashboard, and more.

VLRdevAPI vs web scraping

How the SDK compares to parsing VLR.gg yourself.

FAQ

Answers about rate limits, caching, and data coverage.