Skip to contents

CFB Data Games Examples

Saiem Gilani, Akshay Easwaran, Jared Lee
@saiemgilani @saiemgilani @akeaswaran @akeaswaran

Source: vignettes/cfbd_games.Rmd
cfbd_games.Rmd

Load and Install Packages 

if (!requireNamespace('pak', quietly = TRUE)){
  install.packages('pak')
}
pak::pak(c("dplyr", "tidyr", "gt", "cfbfastR"))
## ℹ Loading metadata database
## ✔ Loading metadata database ... done
## 
## 
## → Package library at /home/runner/work/_temp/Library.
## ✔ All system requirements are already installed.
## 
## ℹ No downloads are needed
## ℹ Installing system requirements
## ℹ Executing `sudo sh -c apt-get -y update`
## Get:1 file:/etc/apt/apt-mirrors.txt Mirrorlist [144 B]
## Hit:2 http://azure.archive.ubuntu.com/ubuntu jammy InRelease
## Hit:3 http://azure.archive.ubuntu.com/ubuntu jammy-updates InRelease
## Hit:6 https://packages.microsoft.com/repos/azure-cli jammy InRelease
## Hit:4 http://azure.archive.ubuntu.com/ubuntu jammy-backports InRelease
## Hit:5 http://azure.archive.ubuntu.com/ubuntu jammy-security InRelease
## Hit:7 https://dl.google.com/linux/chrome-stable/deb stable InRelease
## Hit:8 https://packages.microsoft.com/ubuntu/22.04/prod jammy InRelease
## Reading package lists...
## ℹ Executing `sudo sh -c apt-get -y install libicu-dev libcurl4-openssl-dev libssl-dev cmake make libuv1-dev pandoc libnode-dev libxml2-dev`
## Reading package lists...
## Building dependency tree...
## Reading state information...
## libicu-dev is already the newest version (70.1-2).
## make is already the newest version (4.3-4.1build1).
## pandoc is already the newest version (2.9.2.1-3ubuntu2).
## cmake is already the newest version (3.22.1-1ubuntu1.22.04.2).
## libcurl4-openssl-dev is already the newest version (7.81.0-1ubuntu1.27).
## libssl-dev is already the newest version (3.0.2-0ubuntu1.29).
## libuv1-dev is already the newest version (1.43.0-1ubuntu0.1).
## libxml2-dev is already the newest version (2.9.13+dfsg-1ubuntu0.12).
## libnode-dev is already the newest version (12.22.9~dfsg-1ubuntu3.6).
## 0 upgraded, 0 newly installed, 0 to remove and 34 not upgraded.
## ✔ 4 pkgs + 72 deps: kept 72 [10.1s]
## 
## Attaching package: 'dplyr'
## The following objects are masked from 'package:stats':
## 
##     filter, lag
## The following objects are masked from 'package:base':
## 
##     intersect, setdiff, setequal, union
library(tidyr)
library(gt)
library(cfbfastR)
# pak::pak("sportsdataverse/cfbfastR")

Get game information 

df_2018_wk_1 <- cfbfastR::cfbd_game_info(year=2018, week = 1)

df_2018_wk_7_ind <- cfbfastR::cfbd_game_info(year=2018, week = 7, conference = "Ind")

line_scores <- cfbfastR::cfbd_game_info(year=2018, week = 13, team = "Texas A&M", quarter_scores = TRUE)

Get calendar weeks and dates 

cfbfastR::cfbd_calendar(2019)

Find game broadcast and media information 

cfbfastR::cfbd_game_media(2019, week = 4, conference = "ACC")

Get CFBD Advanced Game Box Scores (by game_id) 

cfbfastR::cfbd_game_box_advanced(game_id = 401114233)

Get CFBD Game Team Box Scores 

cfbfastR::cfbd_game_team_stats(2019, team = "LSU")
## ── Team stats data from CollegeFootballData.com ────────────── cfbfastR 3.0.0 ──
## ℹ Data updated: 2026-08-29 13:21:45 UTC
## # A tibble: 26 × 78
##      game_id school     conference home_away opponent opponent_conference points
##        <int> <chr>      <chr>      <chr>     <chr>    <chr>                <int>
##  1 401110778 Texas      Big 12     home      LSU      SEC                     38
##  2 401110778 LSU        SEC        away      Texas    Big 12                  45
##  3 401110842 Alabama    SEC        home      LSU      SEC                     41
##  4 401110842 LSU        SEC        away      Alabama  SEC                     46
##  5 401110850 Ole Miss   SEC        home      LSU      SEC                     37
##  6 401110850 LSU        SEC        away      Ole Miss SEC                     58
##  7 401110869 LSU        SEC        home      Texas A… SEC                     50
##  8 401110869 Texas A&M  SEC        away      LSU      SEC                      7
##  9 401110790 LSU        SEC        home      Northwe… Southland               65
## 10 401110790 Northwest… Southland  away      LSU      SEC                     14
## # ℹ 16 more rows
## # ℹ 71 more variables: total_yards <chr>, net_passing_yards <chr>,
## #   completion_attempts <chr>, passing_tds <chr>, yards_per_pass <chr>,
## #   passes_intercepted <chr>, interception_yards <chr>, interception_tds <chr>,
## #   rushing_attempts <chr>, rushing_yards <chr>, rush_tds <chr>,
## #   yards_per_rush_attempt <chr>, first_downs <chr>, third_down_eff <chr>,
## #   fourth_down_eff <chr>, punt_returns <chr>, punt_return_yards <chr>, …
cfbfastR::cfbd_game_team_stats(2013, team = "Florida State")
## ── Team stats data from CollegeFootballData.com ────────────── cfbfastR 3.0.0 ──
## ℹ Data updated: 2026-08-29 13:21:45 UTC
## # A tibble: 26 × 78
##      game_id school     conference home_away opponent opponent_conference points
##        <int> <chr>      <chr>      <chr>     <chr>    <chr>                <int>
##  1 332640052 Florida S… ACC        home      Bethune… MEAC                    54
##  2 332640052 Bethune-C… MEAC       away      Florida… ACC                      6
##  3 332570052 Florida S… ACC        home      Nevada   Mountain West           62
##  4 332570052 Nevada     Mountain … away      Florida… ACC                      7
##  5 332710103 Boston Co… ACC        home      Florida… ACC                     34
##  6 332710103 Florida S… ACC        away      Boston … ACC                     48
##  7 332780052 Florida S… ACC        home      Maryland ACC                     63
##  8 332780052 Maryland   ACC        away      Florida… ACC                      0
##  9 333340057 Florida    SEC        home      Florida… ACC                      7
## 10 333340057 Florida S… ACC        away      Florida  SEC                     37
## # ℹ 16 more rows
## # ℹ 71 more variables: total_yards <chr>, net_passing_yards <chr>,
## #   completion_attempts <chr>, passing_tds <chr>, yards_per_pass <chr>,
## #   passes_intercepted <chr>, interception_yards <chr>, interception_tds <chr>,
## #   rushing_attempts <chr>, rushing_yards <chr>, rush_tds <chr>,
## #   yards_per_rush_attempt <chr>, first_downs <chr>, third_down_eff <chr>,
## #   fourth_down_eff <chr>, punt_returns <chr>, punt_return_yards <chr>, …

Get CFBD Game Player Box Scores 

cfbfastR::cfbd_game_player_stats(2018, week = 15, conference = "Ind")

cfbfastR::cfbd_game_player_stats(2013, week = 1, team = "Florida State", category = "passing")

Get CFBD Team Game Records 

cfbfastR::cfbd_game_records(2018, team = "Notre Dame")

cfbfastR::cfbd_game_records(2013, team = "Florida State")

Our Authors

Our Contributors

Citation

To cite the cfbfastR R package in publications, use:

BibTeX Citation

@misc{cfbfastr,
  author = {Saiem Gilani and Akshay Easwaran and Jared Lee and Eric Hess},
  title = {cfbfastR: Access College Football Play by Play Data},
  url = {https://cfbfastR.sportsdataverse.org/},
  year = {2021}
}