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.


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)){
pacman::p_load_current_gh("saiemgilani/usfootballR", dependencies = TRUE, update = TRUE)


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

Breaking Changes

Full News on Releases

Follow the SportsDataverse on Twitter and star this repo

Twitter Follow

GitHub stars

Our Authors


To cite the usfootballR R package in publications, use:

BibTex Citation

  author = {Saiem Gilani},
  title = {usfootballR: The SportsDataverse's R Package for MLS and NWSL Data.},
  url = {},
  year = {2021}