usfootballR is an R package for working with American soccer data. The package has functions to access live play-by-play and box score data from ESPN with shot locations when available.

A scraping and aggregating interface for ESPN’s MLS and NWSL statistics. It provides users with the capability to access the API’s game play-by-plays, box scores, standings and results to analyze the data for themselves.

Data freshness and pipeline status for every SportsDataverse dataset: sportsdataverse.org/status.

Installation

You can install the released version of usfootballR from GitHub with:

# You can install using the pacman package using the following code:
if (!requireNamespace('pacman', quietly = TRUE)){
  install.packages('pacman')
}
pacman::p_load_current_gh("sportsdataverse/usfootballR", dependencies = TRUE, update = TRUE)

Documentation

For more information on the package and function reference, please see the usfootballR documentation website.

Breaking Changes

Full News on Releases

Follow the SportsDataverse (@SportsDataverse) on X and star this repo

Our Authors

Saiem Gilani

Citations

To cite the usfootballR R package in publications, use:

BibTeX Citation

@misc{gilani_2021_usfootballR,
  author = {Saiem Gilani},
  title = {usfootballR: The SportsDataverse's R Package for MLS and NWSL Data.},
  url = {https://usfootballR.sportsdataverse.org},
  year = {2021}
}