SC2API

The goal of SC2API is to build a simple and easy-to-use API wrapper for Blizzard Starcraft II API in the R programming language.

Installation

The SC2API is published on CRAN and can be installed using

install.packages('SC2API')

You can also install the development version of SC2API from GitHub with:

# install.packages("devtools")
# devtools::install_github("SamMorrissette/sc2api")
install.packages("SC2API", repos = c('https://sammorrissette.r-universe.dev', 'https://cloud.r-project.org'))

Note that there is also a vignette that comes with the package that can be installed using:

# install.packages("devtools")
devtools::install_github("SamMorrissette/sc2api", build_vignettes = TRUE, dependencies = TRUE)

Example Usage

This is a basic example to obtain the MMR (match-maker rating) of the current top 10 players in the North America Grandmaster leaderboard.

First, you must set your own token in the R environment by supplying your own client ID and client secret. For more information on how to obtain these, visit Getting Started.

library(SC2API)

set_token("YOUR CLIENT ID", "YOUR CLIENT SECRET")

data <- get_gm_leaderboard(1) # An argument of "1" corresponds to the North American ladder.
top10 <- data[1:10,] # Extract the top 10 players
playerMMR <- top10$mmr # Extract the "mmr" vector from each player. 
print(playerMMR)
#>  [1] 6609 6451 6425 6322 6276 6232 6208 6135 6106 6092