Skip to contents

Team info lookup

Usage

cfbd_team_info(
  conference = NULL,
  only_fbs = TRUE,
  year = most_recent_cfb_season()
)

Arguments

conference

(String optional): Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC, Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC Required if year not provided

only_fbs

(Logical default TRUE): Filter for only returning FBS teams for a given year. If year is left blank while only_fbs is TRUE, then will return values for most current year

year

(Integer optional): Year, 4 digit format (YYYY). Filter for getting a list of major division team for a given year. Required if conference not provided and the year parameter is only supported if only_fbs is TRUE.

Value

cfbd_team_info() - A data frame with 12 variables:

team_id: integer.

Referencing team id.

school: character.

Team name.

mascot: character.

Team mascot.

abbreviation: character.

Team abbreviations.

alt_name1: character.

Team alternate name 1 (as it appears in play_text).

alt_name2: character.

Team alternate name 2 (as it appears in play_text).

alt_name3: character.

Team alternate name 3 (as it appears in play_text).

conference: character.

Conference of team.

division: character.

Division of team within the conference.

classification: character.

Conference classification (fbs,fcs,ii,iii)

color: character.

Team color (primary).

alt_color: character.

Team color (alternate).

logos: character.

Team logos.

venue_id: character.

Referencing venue id.

venue_name: character.

Stadium name.

city: character.

Team/venue city.

state: character.

Team/venue state.

zip: character.

Team/venue zip code (someone double check Miami (FL) on if they're in the same zip code).

country_code: character.

Team/venue country code.

timezone: character.

Team/venue timezone.

latitude: character.

Venue latitude.

longitude: character.

Venue longitude.

elevation: character.

Venue elevation.

capacity: character.

Venue capacity.

year_constructed: character.

Year the venue was constructed.

grass: character.

TRUE/FALSE response on whether the field is grass or not (oh, and there are so many others).

dome: character.

TRUE/FALSE flag for if the venue is a domed stadium.

Examples

# \donttest{
  try(cfbd_team_info(conference = "SEC"))
#> ── Team information from CollegeFootballData.com ───────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-25 19:41:46 UTC
#> # A tibble: 16 × 29
#>    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       
#> # ℹ 21 more variables: division <lgl>, classification <chr>, color <chr>,
#> #   alt_color <chr>, logo <chr>, logo_2 <chr>, twitter <chr>, venue_id <int>,
#> #   venue_name <chr>, city <chr>, state <chr>, zip <chr>, country_code <chr>,
#> #   timezone <chr>, latitude <dbl>, longitude <dbl>, elevation <chr>,
#> #   capacity <int>, year_constructed <int>, grass <lgl>, dome <lgl>

  try(cfbd_team_info(conference = "Ind"))
#> ── Team information from CollegeFootballData.com ───────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-25 19:41:46 UTC
#> # A tibble: 2 × 29
#>   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…
#> # ℹ 21 more variables: division <lgl>, classification <chr>, color <chr>,
#> #   alt_color <chr>, logo <chr>, logo_2 <chr>, twitter <chr>, venue_id <int>,
#> #   venue_name <chr>, city <chr>, state <chr>, zip <chr>, country_code <chr>,
#> #   timezone <chr>, latitude <dbl>, longitude <dbl>, elevation <chr>,
#> #   capacity <int>, year_constructed <int>, grass <lgl>, dome <lgl>

  try(cfbd_team_info(year = 2019))
#> ── Team information from CollegeFootballData.com ───────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-25 19:41:47 UTC
#> # A tibble: 130 × 29
#>    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
#> # ℹ 21 more variables: division <chr>, classification <chr>, color <chr>,
#> #   alt_color <chr>, logo <chr>, logo_2 <chr>, twitter <chr>, venue_id <int>,
#> #   venue_name <chr>, city <chr>, state <chr>, zip <chr>, country_code <chr>,
#> #   timezone <chr>, latitude <dbl>, longitude <dbl>, elevation <chr>,
#> #   capacity <int>, year_constructed <int>, grass <lgl>, dome <lgl>
# }