Stephen Wade 22/02/2016
This is a simple interface to stats.nba.com based off of the Python package nba_py, which is sadly outdated as of February 2016.
Before going into any further details of the package, there are some house-keeping tasks:
- All the data from the website is Copyright (c) 2016 NBA Media Ventures, LLC. All rights reserved. When using this package you must agree to the Terms of Use of the website. All the terms are important and must be read and agreed to. Pay extra attention to: * Section 1 - Ownership and User Restrictions; * Section 9 - NBA Statistics; * Section 11--14 and 16--21; and * read all of it, really!
- As this package sends http requests to stats.nba.com, you must read and agree to the terms of their Privacy Policy before using this package.
- This code is licensed under the MIT license, and you may use this package strictly under those terms.
The details of the API end-points were manually sourced by the approach given in this blog post. In order to semi-future-proof the package, the queries to these end-points and the data extracted from them are evaluated through a fairly informal abstract data layer (ADL). The ADL is specified in internal data extracted from a YAML which can be viewed on github: http://www.github.com/stephematician/statsnbaR/tree/master/data-raw/ADL.yaml.
The package is split into player, team and game data. All the functions are fully documented, and so details can be found there. However for the sake of sales, here's some example code to give you an idea how easy it is to use the package
Installation is performed via github using the devtools package.
library(devtools)
install_github('stephematician/statsnbaR')Let's just have a look at the player data from the 2015-2016 season, including the historical players:
library(statsnbaR)
nba_players <- get_players(league='NBA')
tail(nba_players)This package was built and tested with the following R software:
> sessionInfo()
R version 3.2.3 (2015-12-10)
Platform: x86_64-pc-linux-gnu (64-bit)
Running under: Ubuntu 14.04.4 LTS
other attached packages:
[1] statsnbaR_0.1 httr_1.1.0
loaded via a namespace (and not attached):
[1] R6_2.1.2 curl_0.9.6 jsonlite_0.9.19