Team info lookup
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 ifonly_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.
See also
Other CFBD Teams:
cfbd_team_matchup()
,
cfbd_team_matchup_records()
,
cfbd_team_roster()
,
cfbd_team_talent()
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>
# }