VLRdevAPI

A Python SDK for Valorant Esports

Python 3.11+/PyPI

A type-safe Python SDK for Valorant esports data from VLR.gg. Fetch live match results, player statistics, team rosters, and tournament brackets through a fully typed interface. Built by RiftWatch.

Read the DocsView on GitHub
vlrdevapi
$

A Python library for Valorant esports data from VLR.gg

Stop scraping VLR.gg by hand. VLRdevAPI handles parsing, data normalization, rate limiting, and type safety so you can build Valorant esports applications faster.

  • Match Data

    Live scores and stats.

    Access live and historical Valorant match results, scores, and statistics from every professional tournaments.

  • Player Stats

    Performance metrics.

    Pull detailed player performance metrics, agent usage data, and career statistics across all major Valorant esports events.

  • Team Info

    Rosters and rankings.

    Get team rosters, rankings, and organization histories for every team competing in the Valorant esports scene worldwide.

  • Event Coverage

    Tournament data.

    Browse tournament brackets, schedule data, and event metadata from VLR.gg - from VCT to regional Valorant circuits.

How It Works

Fetch Valorant esports data in seconds with Python.

Install the VLRdevAPI Python package, import the client, and start querying Valorant esports data. Built-in rate limiting and response caching are included out of the box.

  • Install with pip

    One command, zero setup

    Install the VLRdevAPI Python SDK via pip and get started immediately. No complex configuration or system dependencies required.

    pip install vlrdevapi

  • Import the library

    Minimal boilerplate

    Import the VLRdevAPI Python client and start fetching Valorant esports data in just two lines of Python code.

    from vlrdevapi import VLRdevAPI
    client = VLRdevAPI()

  • Set up your client

    Configure once, use everywhere

    Create a VLRdevAPI client instance with your preferred settings. Built-in caching and rate limiting work out of the box.

    client = VLRdevAPI(cache_ttl=300)
    client.set_rate_limit(max_per_minute=30)

  • Query match data

    Live and historical results

    Fetch Valorant match results, player statistics, team rosters, and tournament brackets with fully typed Python responses.

    matches = client.get_matches()
    players = client.get_players()
    teams = client.get_teams()

  • Build your app

    Typed data, zero guesswork

    Use fully typed Python models to build your Valorant esports application with confidence. Autocomplete and validation in every response.

    for match in matches:
        print(match.team1, match.score1)