Archived
This data repo and the associated worldfootballR package will no longer be maintained.
Thanks to you all for all you continued support over the years of maintaining it. It was a pleasure.
)
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
As at 2024-06-29, we are no longer including instructions to install
from CRAN. The version pushed to CRAN is very much out of date, and with
very regular updates to this library, we advise installing from GitHub
only.
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
- For functions to load pre-scraped data, see
here
Loading Data
Since the release of v0.5.3, the library now supports very rapid
loading of pre-collected data through the use of load_ functions.
The data available for loading is stored in the worldfootballR_data
repository. The repo can be found
here.
Head to the vignette
here
to see examples of which data is available for rapid loading.
News
To stay up-to-date with the latest changes, see the package change
log
Note that fotmob data is no longer provided since the release of
v0.6.4 due to a change in their terms of
service.
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
Before creating an issue, please ensure you have the latest version
installed from GitHub. Check the changelog for more details on changes
that have been made to the library.
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
Bluesky if you aren’t
able to create an issue.
Show your support
Follow me on Bluesky
jaseziv for updates
If this package helps you, all I ask is that you star this repo. If you
did want to show your support and contribute to server time and data
storage costs, feel free to send a small donation through the link
below.
评论