Skip to content

An Unofficial REST API for vlr.gg, a site for Valorant Pro Esports match results and news.

License

Notifications You must be signed in to change notification settings

jordyvandijken/vlrggapi

 
 

Repository files navigation

vlrggapi

An Unofficial REST API for vlr.gg, a site for Valorant Esports match and news coverage.

Current Endpoints

All endpoints are relative to https://vlrggapi-fawn.vercel.app.

/news

  • Method: GET
  • Cached Time: 300 seconds (5 Minutes)
  • Response:
    {
        "data": {
            "status": 200,
            'segments': [
                {
                    'title': str,
                    'description': str,
                    'date': str,
                    'author': str,
                    'url_path': str
                }
            ],
        }
    }

/matches/results

  • Method: GET
  • Cached Time: 300 seconds (5 Minutes)
  • Response:
    {
        "data": {
            "status": 200,
            'segments': [
                {
                  "team1": str,
                  "team2": str,
                  "score1": str,
                  "score2": str,
                  "time_completed": str,
                  "round_info": str,
                  "tournament_name": str,
                  "match_page": str,
                  "match_stream": {
                    "status": 200,
                    "data": [
                      {
                        "title": str,
                        "href": str,
                        "platform": str
                      },
                    ]
                  },
                  "tournament_icon": str
                }
            ],
        }
    }

/rankings/<region>

  • Method: GET
  • Region: north-america, europe, asia-pacific, latin-america, oceania, korea, mena
  • Cached Time: 300 seconds (5 Minutes)
  • Response:
    {
        "data": {
            "status": 200,
            'segments': [
                {
                    'rank': str,
                    'team': str,
                    'country': str,
                    'streak': str,
                    'record': str,
                    'winnings': str,
                    'logo': str,
                    'url_path': str
                }
            ],
        }
    }

/stats/<region>

  • Method: GET
  • Cached Time: 300 seconds (5 Minutes)
  • Region: na, eu, ap, sa, oce, mn
  • Response:
    {
        "data": {
            "status": 200,
            'segments': [
                {
                  'title': str,
                  "player": str,
                  "org": str,
                  "average_combat_score": str,
                  "kill_deaths": str,
                  "average_damage_per_round": str,
                  "kills_per_round": str,
                  "assists_per_round": str,
                  "first_kills_per_round": str,
                  "first_deaths_per_round": str,
                  "headshot_percentage": str,
                  "clutch_success_percentage": str
                }
            ],
        }
    }

/match/streams/<match>

  • Method: GET
  • Cached Time: 300 seconds (5 Minutes)
  • Response:
    {
        "status": 200,
        "data": [
            {
              "title": str,
              "href": str,
              "platform": str
            },
        ]
    }

Installation

Source

$ git clone https://github.com/jordyvandijken/vlrggapi/
$ cd vlrggapi
$ pip3 install -r requirements.txt

Usage

python3 main.py

Built With

Contributing

Feel free to submit a pull request or an issue!

License

The MIT License (MIT)

Original github

Andre Saddler

About

An Unofficial REST API for vlr.gg, a site for Valorant Pro Esports match results and news.

Resources

License

Stars

Watchers

Forks

Languages

  • Python 97.4%
  • Dockerfile 2.3%
  • Procfile 0.3%