Table of Contents
{worldfootballR} for Soccer
worldfootballR
Overview
This package is designed to allow users to extract various world football results and player statistics from the following popular football (soccer) data sites:
Installation
You can install the CRAN version of
worldfootballR
with:
install.packages("worldfootballR")
You can install the released version of
worldfootballR
from
GitHub with:
# install.packages("devtools")
devtools::install_github("JaseZiv/worldfootballR")
library(worldfootballR)
Usage
Package vignettes have been built to help you get started with the package.
- For functions to extract data from FBref, see here
- For functions to extract data from Transfermarkt, see here
- For functions to extract data from Understat, see here
- For functions to extract data for international matches from FBref, see here
News
To stay up-to-date with the latest changes, see the package change log
Leagues and Seasons
Fbref
For FBref.com data (match and season data), a list of leagues and
seasons included in the package can be found in the
worldfootballR_data
repository and can be found
here
Transfermarkt
For transfermarkt.com data (valuations and transfers), a list of leagues
and seasons included in the package can be found in the
worldfootballR_data
repository and can be found
here
Understat
The following leagues are currently supported by Understat (these values
can be passed in to the league
arguments of most understat_
functions):
- “EPL”
- “La liga”
- “Bundesliga”
- “Serie A”
- “Ligue 1”
- “RFPL”
Attribute the Source
When using the functions in the package, please ensure you attribute the source of the data based on the function you use.
Data providers are listed below:
Acknowledgements
Special mention goes out to Ewan
Henderson’s awesome
understatr
library for the
inspiration and internal code for the understat_
functions contained
in this package.
Contributing
Issues and Improvements
When creating an issue, please include:
- Reproducible examples
- A brief description of what the expected results are
- If applicable, the fbref.com, transfermarkt.com or understat.com page the observed behaviour is occurring on
- For improvement suggestions, what features are being requested and their purpose
Feel free to get in touch via email or twitter if you aren’t able to create an issue.
Show your support
Follow me on Twitter (jaseziv) for updates
If this package helps you, all I ask is that you star this repo