Extract and Clean World Football (Soccer) Data

Allow users to obtain clean and tidy football (soccer) game, team and player data. Data is collected from a number of popular sites, including 'FBref', transfer and valuations data from 'Transfermarkt'< https://www.transfermarkt.com/> and shooting location and other match stats data from 'Understat'< https://understat.com/> and 'fotmob'< https://www.fotmob.com/>. It gives users the ability to access data more efficiently, rather than having to export data tables to files before being able to complete their analysis.

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:

• FBref
• Transfermarkt
• Understat
• Fotmob

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 from fotmob, 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

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:

• StatsBomb via FBref
• Transfermarkt
• Understat
• Fotmob

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 https://twitter.com/jaseziv 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