Skip to content

📊 A public GraphQL API for getting statistics on professional Rocket League players, teams and matches.

Notifications You must be signed in to change notification settings

joshua-arts/rocket-league-stats-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rocket League Competitive API

The Rocket League Competitive API is an easy to use API that implements a GraphQL interface for retrieving data from the parallel.gg database. Currently it supports data from each of the RLCS seasons. I originally built it in order to get more familiar with GraphQL.

You can play around with the API here. If you want to use it in your apps, you can make POST requests to the endpoint at: https://rocket-league-esports-api.herokuapp.com/graphql

Using the API

The API has four basic types:

  1. Teams - Stats on a team for a given season/stage.
  2. Players - Stats on a player for a given season/stage.
  3. Matches - Stats on a single game in a best-of-x series.
  4. Games - Stats for a single player in a single games of a best-of-x series.

Here are the arguments that you can use when querying each type:

Types Arguments
Team season, stage, team
Player season, stage, team, player
Match season, stage, team, game, map, date, vs, result
Game season, stage, team, player, game, map, date, vs, result, side

All arguments can also be used as fields to ask for. Here are the fields that you can ask for:

Types Field
Team all arguments + score, goals, assists, saves, shots
Player all arguments + score, goals, assists, saves, shots
Match all arguments + players
Game all arguments + score, goals, assists, saves, shots

Stage is the only enum property. The following values are valid for stage: NA_LEAGUE_PLAY, EU_LEAGUE_PLAY, NA_PLAYOFFS, EU_PLAYOFFS, NA_OVERALL, EU_OVERALL, LAN.

Examples

Try some of these queries here!

View total score, goals, assists, saves and shots for each time in season 4 NA League Play.

{
  teams(season: 4, stage: NA_LEAGUE_PLAY){
    team
    score
    goals
    assists
    saves
    shots
  }
}

View goals scored by NRG eSports at each LAN they've attended.

{
  teams(team: "NRG eSports", stage: LAN){
    team
    stage
    season
    goals
  }
}

View total saves and shots for each player on NRG eSports in season 4 NA League Play.

{
  players(team: "NRG eSports", season: 4, stage: NA_LEAGUE_PLAY){
    player
    saves
    shots
  }
}

View total goals and shots for Jacob across the various stages in season 4.

{
  players(player: "Jacob", season: 4){
    stage
    goals
    shots
  }
}

View matches in season 4 between NRG eSports and Cloud9 and show date, map, game number, result and goals by player.

{
  matches(team: "NRG eSports", vs: "Cloud9", season: 4){
    date
    map
    game
    result
    players {
      player
      goals
    }
  }
}

View games Jacob participated in during season 4, and how many goals he got.

{
  games(player: "Jacob", season: 4){
    date
    map
    game
    vs
    result
    goals
  }
}

Contributing

If you'd like to contribute to the API, feel free to reach out or just go ahead and make a pull request!

Special thanks to Slokh for maintaining the database that this API uses and for allowing me access!

About

📊 A public GraphQL API for getting statistics on professional Rocket League players, teams and matches.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published