R package to obtain football (soccer) data from APIs
Switch branches/tags
Nothing to show
Clone or download
Latest commit 9f05b48 Sep 25, 2016
Failed to load latest commit information.
R Initial Upload Sep 25, 2016
data Initial Upload Sep 25, 2016
man Initial Upload Sep 25, 2016
vignettes Initial Upload Sep 25, 2016
.gitignore Initial commit Sep 25, 2016
DESCRIPTION Initial Upload Sep 25, 2016
LICENSE Initial commit Sep 25, 2016
NAMESPACE Initial Upload Sep 25, 2016
README.md Initial Upload Sep 25, 2016
footballR.Rproj Initial Upload Sep 25, 2016



footballR is an R package that calls various free football (soccer) APIs.

There's quite a few good free resources for football data out there. Some detailed historical data taken is available from the openfootball and the jokecamp github pages. You can read a detailed review of all football data sources and API services here.

Getting Started


Install from GitLab

# install.packages("devtools")

You can install from GitHub (identical mirror of GitLab)

# install.packages("devtools")

Alternatively, you can copy the R files onto your computer and run them all locally (only if the other approaches fail for some reason).

Required Packages

The package relies on httr and jsonlite. The former handles calls to the API, while the latter converts the call output from JSON to data frames. These should be installed automatically with the package.


A short tutorial on how to use the football-data.org API is available here.


This package is under active development and is subject to regular updates.

Currently, the package only supports calls to the football-data.org API.


Please let me know if something's not working.

Submit issues here.




The footballR package is provided with absolutely no warranty.