Skip to contents

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:6 https://packages.microsoft.com/ubuntu/22.04/prod jammy InRelease
## Hit:2 http://azure.archive.ubuntu.com/ubuntu jammy InRelease
## Hit:3 http://azure.archive.ubuntu.com/ubuntu jammy-updates InRelease
## Hit:7 https://dl.google.com/linux/chrome-stable/deb stable InRelease
## Hit:4 http://azure.archive.ubuntu.com/ubuntu jammy-backports InRelease
## Hit:5 http://azure.archive.ubuntu.com/ubuntu jammy-security 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.2s]
## 
## 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 Team Info

cfbd_team_info(conference = "SEC")
## ── Team information from CollegeFootballData.com ───────────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:25 UTC
## # A tibble: 16 × 43
##    team_id school   mascot abbreviation alt_name1 alt_name2 alt_name3 conference
##      <int> <chr>    <chr>  <chr>        <chr>     <chr>     <chr>     <chr>     
##  1     333 Alabama  Crims… ALA          ALA       Alabama   NA        SEC       
##  2       8 Arkansas Razor… ARK          ARK       Arkansas  NA        SEC       
##  3       2 Auburn   Tigers AUB          AUB       Auburn    NA        SEC       
##  4      57 Florida  Gators FLA          FLA       Florida   NA        SEC       
##  5      61 Georgia  Bulld… UGA          UGA       Georgia   NA        SEC       
##  6      96 Kentucky Wildc… UK           UK        Kentucky  NA        SEC       
##  7      99 LSU      Tigers LSU          Louisian… LSU       LSU       SEC       
##  8     344 Mississ… Bulld… MSST         MSST      Mississi… NA        SEC       
##  9     142 Missouri Tigers MIZ          MIZ       Missouri  NA        SEC       
## 10     201 Oklahoma Soone… OU           OU        Oklahoma  NA        SEC       
## 11     145 Ole Miss Rebels MISS         MISS      Ole Miss  NA        SEC       
## 12    2579 South C… Gamec… SC           SC        South Ca… NA        SEC       
## 13    2633 Tenness… Volun… TENN         TENN      Tennessee NA        SEC       
## 14     251 Texas    Longh… TEX          TEX       Texas     NA        SEC       
## 15     245 Texas A… Aggies TA&M         TA&M      Texas A&M NA        SEC       
## 16     238 Vanderb… Commo… VAN          VAN       Vanderbi… NA        SEC       
## # ℹ 35 more variables: division <lgl>, classification <chr>, color <chr>,
## #   alt_color <chr>, logo <chr>, logo_2 <chr>, logos_3 <chr>, logos_4 <chr>,
## #   logos_5 <chr>, logos_6 <chr>, logos_7 <chr>, logos_8 <chr>, logos_9 <chr>,
## #   logos_10 <chr>, logos_11 <chr>, logos_12 <chr>, logos_13 <chr>,
## #   logos_14 <chr>, logos_15 <chr>, logos_16 <chr>, twitter <chr>,
## #   venue_id <int>, venue_name <chr>, city <chr>, state <chr>, zip <chr>,
## #   country_code <chr>, timezone <chr>, latitude <dbl>, longitude <dbl>, …
cfbd_team_info(conference = "Ind")
## ── Team information from CollegeFootballData.com ───────────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:25 UTC
## # A tibble: 2 × 43
##   team_id school    mascot abbreviation alt_name1 alt_name2 alt_name3 conference
##     <int> <chr>     <chr>  <chr>        <chr>     <chr>     <chr>     <chr>     
## 1      87 Notre Da… Fight… ND           ND        Notre Da… NA        FBS Indep…
## 2      41 UConn     Huski… CONN         Connecti… CONN      UConn     FBS Indep…
## # ℹ 35 more variables: division <lgl>, classification <chr>, color <chr>,
## #   alt_color <chr>, logo <chr>, logo_2 <chr>, logos_3 <chr>, logos_4 <chr>,
## #   logos_5 <chr>, logos_6 <chr>, logos_7 <chr>, logos_8 <chr>, logos_9 <chr>,
## #   logos_10 <chr>, logos_11 <chr>, logos_12 <chr>, logos_13 <chr>,
## #   logos_14 <chr>, logos_15 <chr>, logos_16 <chr>, twitter <chr>,
## #   venue_id <int>, venue_name <chr>, city <chr>, state <chr>, zip <chr>,
## #   country_code <chr>, timezone <chr>, latitude <dbl>, longitude <dbl>, …
cfbd_team_info(year = 2019)
## ── Team information from CollegeFootballData.com ───────────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:26 UTC
## # A tibble: 130 × 43
##    team_id school   mascot abbreviation alt_name1 alt_name2 alt_name3 conference
##      <int> <chr>    <chr>  <chr>        <chr>     <chr>     <chr>     <chr>     
##  1    2005 Air For… Falco… AF           AF        Air Force NA        Mountain …
##  2    2006 Akron    Zips   AKR          AKR       Akron     NA        Mid-Ameri…
##  3     333 Alabama  Crims… ALA          ALA       Alabama   NA        SEC       
##  4    2026 App Sta… Mount… APP          Appalach… APP       App State Sun Belt  
##  5      12 Arizona  Wildc… ARIZ         ARIZ      Arizona   NA        Pac-12    
##  6       9 Arizona… Sun D… ASU          ASU       Arizona … NA        Pac-12    
##  7       8 Arkansas Razor… ARK          ARK       Arkansas  NA        SEC       
##  8    2032 Arkansa… Red W… ARST         ARST      Arkansas… NA        Sun Belt  
##  9     349 Army     Black… ARMY         ARMY      Army      NA        FBS Indep…
## 10       2 Auburn   Tigers AUB          AUB       Auburn    NA        SEC       
## # ℹ 120 more rows
## # ℹ 35 more variables: division <chr>, classification <chr>, color <chr>,
## #   alt_color <chr>, logo <chr>, logo_2 <chr>, logos_3 <chr>, logos_4 <chr>,
## #   logos_5 <chr>, logos_6 <chr>, logos_7 <chr>, logos_8 <chr>, logos_9 <chr>,
## #   logos_10 <chr>, logos_11 <chr>, logos_12 <chr>, logos_13 <chr>,
## #   logos_14 <chr>, logos_15 <chr>, logos_16 <chr>, twitter <chr>,
## #   venue_id <int>, venue_name <chr>, city <chr>, state <chr>, zip <chr>, …

Get Team Matchup History (Total Record)

cfbd_team_matchup_records("Texas", "Oklahoma")
## ── Team matchup record from CollegeFootballData.com ────────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:26 UTC
## # A tibble: 1 × 7
##   start_year end_year team1 team1_wins team2    team2_wins  ties
##        <int>    <int> <chr>      <int> <chr>         <int> <int>
## 1       1902     2025 Texas         62 Oklahoma         51     5
cfbd_team_matchup_records("Texas A&M", "TCU", min_year = 1975)
## ── Team matchup record from CollegeFootballData.com ────────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:26 UTC
## # A tibble: 1 × 7
##   start_year end_year team1     team1_wins team2 team2_wins  ties
##        <int>    <int> <chr>          <int> <chr>      <int> <int>
## 1       1975     2001 Texas A&M         22 TCU            0     0

Get Team Matchup History

cfbd_team_matchup("Texas", "Oklahoma")
## ── Team matchup history from CollegeFootballData.com ───────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:26 UTC
## # A tibble: 118 × 11
##    season  week season_type date         neutral_site venue home_team home_score
##     <int> <int> <chr>       <chr>        <lgl>        <chr> <chr>          <int>
##  1   1902     4 regular     1902-10-04T… FALSE        NA    Texas             22
##  2   1903     6 regular     1903-10-17T… FALSE        NA    Oklahoma           6
##  3   1903    10 regular     1903-11-13T… FALSE        NA    Oklahoma           5
##  4   1904    10 regular     1904-11-16T… FALSE        NA    Texas             40
##  5   1905     8 regular     1905-11-03T… FALSE        NA    Oklahoma           2
##  6   1906     7 regular     1906-11-02T… FALSE        NA    Oklahoma           9
##  7   1907     9 regular     1907-11-15T… FALSE        NA    Texas             29
##  8   1908     9 regular     1908-11-13T… FALSE        NA    Oklahoma          50
##  9   1909    10 regular     1909-11-19T… FALSE        NA    Texas             30
## 10   1910    11 regular     1910-11-24T… FALSE        NA    Texas              0
## # ℹ 108 more rows
## # ℹ 3 more variables: away_team <chr>, away_score <int>, winner <chr>
cfbd_team_matchup("Texas A&M", "TCU")
## ── Team matchup history from CollegeFootballData.com ───────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:26 UTC
## # A tibble: 89 × 11
##    season  week season_type date         neutral_site venue home_team home_score
##     <int> <int> <chr>       <chr>        <lgl>        <lgl> <chr>          <int>
##  1   1903     5 regular     1903-10-10T… FALSE        NA    Texas A&M         11
##  2   1903    12 regular     1903-11-28T… FALSE        NA    Texas A&M         14
##  3   1903    10 regular     1903-11-14T… FALSE        NA    Texas A&M         16
##  4   1904     6 regular     1904-10-22T… FALSE        NA    Texas A&M         29
##  5   1905     3 regular     1905-09-30T… FALSE        NA    Texas A&M         20
##  6   1905     8 regular     1905-11-04T… FALSE        NA    Texas A&M         24
##  7   1906     6 regular     1906-10-27T… FALSE        NA    Texas A&M         42
##  8   1906     8 regular     1906-11-10T… FALSE        NA    Texas A&M         22
##  9   1907     8 regular     1907-11-05T… FALSE        NA    Texas A&M         32
## 10   1908     7 regular     1908-10-31T… FALSE        NA    Texas A&M         13
## # ℹ 79 more rows
## # ℹ 3 more variables: away_team <chr>, away_score <int>, winner <chr>
cfbd_team_matchup("Texas A&M", "TCU", min_year = 1975)
## ── Team matchup history from CollegeFootballData.com ───────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:27 UTC
## # A tibble: 22 × 11
##    season  week season_type date         neutral_site venue home_team home_score
##     <int> <int> <chr>       <chr>        <lgl>        <lgl> <chr>          <int>
##  1   1975     7 regular     1975-10-18T… FALSE        NA    TCU                6
##  2   1976    12 regular     1976-11-20T… FALSE        NA    Texas A&M         59
##  3   1977    12 regular     1977-11-19T… FALSE        NA    TCU               23
##  4   1978    13 regular     1978-11-25T… FALSE        NA    Texas A&M         15
##  5   1979    13 regular     1979-11-24T… FALSE        NA    TCU                7
##  6   1980    13 regular     1980-11-22T… FALSE        NA    Texas A&M         13
##  7   1981    12 regular     1981-11-21T… FALSE        NA    TCU                7
##  8   1982    12 regular     1982-11-20T… FALSE        NA    Texas A&M         34
##  9   1983    13 regular     1983-11-19T… FALSE        NA    TCU               10
## 10   1984    14 regular     1984-11-24T… FALSE        NA    Texas A&M         35
## # ℹ 12 more rows
## # ℹ 3 more variables: away_team <chr>, away_score <int>, winner <chr>
cfbd_team_matchup("Florida State", "Florida", min_year = 1975)
## ── Team matchup history from CollegeFootballData.com ───────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:27 UTC
## # A tibble: 52 × 11
##    season  week season_type date         neutral_site venue home_team home_score
##     <int> <int> <chr>       <chr>        <lgl>        <chr> <chr>          <int>
##  1   1975     7 regular     1975-10-18T… FALSE        NA    Florida           34
##  2   1976     7 regular     1976-10-16T… FALSE        NA    Florida …         26
##  3   1977    14 regular     1977-12-03T… FALSE        NA    Florida            9
##  4   1978    13 regular     1978-11-25T… FALSE        NA    Florida …         38
##  5   1979    13 regular     1979-11-24T… FALSE        NA    Florida           16
##  6   1980    15 regular     1980-12-06T… FALSE        NA    Florida …         17
##  7   1981    13 regular     1981-11-28T… FALSE        NA    Florida           35
##  8   1982    14 regular     1982-12-04T… FALSE        NA    Florida …         10
##  9   1983    15 regular     1983-12-03T… FALSE        NA    Florida           53
## 10   1984    15 regular     1984-12-01T… FALSE        NA    Florida …         17
## # ℹ 42 more rows
## # ℹ 3 more variables: away_team <chr>, away_score <int>, winner <chr>

Get Team Rosters

cfbd_team_roster(year = 2013, team = "Florida State")
## ── Team roster data from CollegeFootballData.com ───────────── cfbfastR 3.0.0 ──
##  Data updated: 2026-09-07 09:28:27 UTC
## # A tibble: 134 × 17
##    athlete_id first_name last_name   team    weight height jersey  year position
##    <chr>      <chr>      <chr>       <chr>    <int>  <int>  <int> <int> <chr>   
##  1 -1011031   Colton     Woodall     Florid…    190     75     49  2013 DB      
##  2 -1011030   James      Wilder, Jr. Florid…    229     74     32  2013 RB      
##  3 -1011029   Levonte    Whitfield   Florid…    178     67      7  2013 WR      
##  4 -1011028   Jermaine   Washington  Florid…    194     68     36  2013 WR      
##  5 -1011027   Jonathan   Wallace     Florid…    295     79     74  2013 OL      
##  6 -1011026   Donovan    Todd        Florid…    205     71     39  2013 DB      
##  7 -1011025   Bryan      Stork       Florid…    300     76     52  2013 OL      
##  8 -1011024   Nathan     Slater      Florid…    223     74     45  2013 LB      
##  9 -1011023   Garrett    Scott       Florid…    275     75     69  2013 OL      
## 10 -1011022   Michael    Scheerhorn  Florid…    240     76     79  2013 OL      
## # ℹ 124 more rows
## # ℹ 8 more variables: home_city <chr>, home_state <chr>, home_country <chr>,
## #   home_latitude <dbl>, home_longitude <dbl>, home_county_fips <chr>,
## #   recruit_ids <list>, headshot_url <chr>

Get Team Talent

## ── 247sports team talent ratings from CollegeFootballData.com ──────────────────
##  Data updated: 2026-09-07 09:28:27 UTC
## # A tibble: 138 × 3
##     year school     talent
##    <int> <chr>       <dbl>
##  1  2026 Georgia     1004.
##  2  2026 Texas        985.
##  3  2026 Oregon       984.
##  4  2026 Alabama      974.
##  5  2026 Ohio State   964.
##  6  2026 Notre Dame   953.
##  7  2026 Texas A&M    933 
##  8  2026 LSU          932.
##  9  2026 USC          899 
## 10  2026 Florida      891.
## # ℹ 128 more rows
cfbd_team_talent(year = 2018)
## ── 247sports team talent ratings from CollegeFootballData.com ──────────────────
##  Data updated: 2026-09-07 09:28:27 UTC
## # A tibble: 236 × 3
##     year school        talent
##    <int> <chr>          <dbl>
##  1  2018 Ohio State      984.
##  2  2018 Alabama         979.
##  3  2018 Georgia         964 
##  4  2018 USC             934.
##  5  2018 Clemson         893.
##  6  2018 LSU             890.
##  7  2018 Florida State   889.
##  8  2018 Michigan        862.
##  9  2018 Texas           861.
## 10  2018 Notre Dame      848.
## # ℹ 226 more rows

Our Authors

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}
}