sportsdataverse

The sportsdataverse is a set of sports data packages that work in harmony because they share common data representations and API design. This package is designed to make it easy to install and load multiple sportsdataverse packages in a single step. Learn more about the sportsdataverse at sportsdataverse.org.

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

Installation

Install the stable release from CRAN:

install.packages("sportsdataverse")

Or install the development version from GitHub with:

if (!requireNamespace('pak', quietly = TRUE)){
  install.packages('pak')
}
pak::pak("sportsdataverse/sportsdataverse-R")

or prebuilt from the SportsDataverse r-universe with:

install.packages("sportsdataverse", repos = c("https://sportsdataverse.r-universe.dev", getOption("repos")))

Usage

library(sportsdataverse) will load the following packages:

• baseballr, for MLB and college baseball data.
• cfbfastR, for college football data.
• cfbseedR, for simulating college football seasons and playoff seeding.
• fastRhockey, for NHL and PWHL hockey data.
• hoopR, for men’s college and professional basketball data.
• mlbplotR, for MLB team and player logos, headshots, and plot themes.
• oddsapiR, for sportsbook odds from The Odds API.
• sportyR, for drawing regulation playing surfaces.
• wehoop, for women’s college and professional basketball data.

Additional ecosystem packages — cfbplotR, cfb4th, recruitR, and softballR — are available in the SportsDataverse but are not auto-loaded by library(sportsdataverse).

sportsdataverse::sportsdataverse_logo()

Follow sportsdataverse on X and star this repo

Our Authors

• Saiem Gilani
  

Cheat sheet

A printable one-page reference covering the sportsdataverse metapackage — the function families, the loaders, and what each one returns.

📄 Download the sportsdataverse-R cheat sheet (PDF)

Free to download, print and hand out; light and dark, US Letter landscape. Every SportsDataverse package has one — browse them all at sportsdataverse.org/cheatsheets.

Citations

To cite the sportsdataverse R package in publications, use:

BibTeX Citation

@misc{saiemgilani2021sdv,
  author = {Gilani, Saiem},
  title = {sportsdataverse: The Set of R Packages for Sports Data.},
  url = {https://r.sportsdataverse.org},
  year = {2026}
}

R Packages in the SportsDataverse

cfbfastR

cfbseedR

hoopR

wehoop

fastRhockey

baseballr

mlbplotR

sportyR

oddsapiR