The goal of cfbfastR is to provide the community with an R package for working with CFB data. It is an R API wrapper around Beyond data aggregation and tidying ease, one of the multitude of services that cfbfastR provides is for benchmarking open-source expected points and win probability metrics.


You can install the released version of cfbfastR 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/cfbfastR", dependencies = TRUE, update = TRUE)
# if you would prefer devtools installation
if (!requireNamespace('devtools', quietly = TRUE)){
# Alternatively, using the devtools package:
devtools::install_github(repo = "saiemgilani/cfbfastR")

Breaking Changes

Full News on Releases

College Football Data API Keys

The CollegeFootballData API now requires an API key, here’s a quick run-down:


Save the script and restart your RStudio session, by clicking Session (in between Plots and Build) and click Restart R (there also exists the shortcut Ctrl + Shift + F10 to restart your session). If set correctly, from then on you should be able to use any of the cfbd_ functions without any other changes.

  • For less consistent usage: At the beginning of every session or within an R environment, save your API key as the environment variable CFBD_API_KEY (with quotations) using a command like the following.

Follow cfbfastR on Twitter and star this repo

Twitter Follow

GitHub stars

Authors Emeritus - cfbscrapR

Special Thanks


To cite the cfbfastR R package in publications, use:

BibTex Citation

  author = {Saiem Gilani and Akshay Easwaran and Jared Lee and Eric Hess},
  title = {cfbfastR: The SportsDataverse's R Package for College Football Data.},
  url = {},
  year = {2021}