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

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

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.

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 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:17 UTC
#> # A tibble: 14 × 28
#>    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          NA        ALA       Alabama   SEC       
#>  2       8 Arkansas Razor… ARK          NA        ARK       Arkansas  SEC       
#>  3       2 Auburn   Tigers AUB          NA        AUB       Auburn    SEC       
#>  4      57 Florida  Gators FLA          NA        FLA       Florida   SEC       
#>  5      61 Georgia  Bulld… UGA          NA        UGA       Georgia   SEC       
#>  6      96 Kentucky Wildc… UK           NA        UK        Kentucky  SEC       
#>  7      99 LSU      Tigers LSU          Louisian… LSU       LSU       SEC       
#>  8     344 Mississ… Bulld… MSST         NA        MSST      Miss St   SEC       
#>  9     142 Missouri Tigers MIZ          NA        MIZ       Missouri  SEC       
#> 10     145 Ole Miss Rebels MISS         NA        MISS      Ole Miss  SEC       
#> 11    2579 South C… Gamec… SC           NA        SC        South Ca… SEC       
#> 12    2633 Tenness… Volun… TENN         NA        TENN      Tennessee SEC       
#> 13     245 Texas A… Aggies TA&M         NA        TA&M      Texas A&M SEC       
#> 14     238 Vanderb… Commo… VAN          NA        VAN       Vanderbi… SEC       
#> # ℹ 20 more variables: 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 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:17 UTC
#> # A tibble: 4 × 28
#>   team_id school    mascot abbreviation alt_name1 alt_name2 alt_name3 conference
#>     <int> <chr>     <chr>  <chr>        <lgl>     <chr>     <chr>     <chr>     
#> 1     349 Army      Black… ARMY         NA        ARMY      Army      FBS Indep…
#> 2      41 Connecti… Huski… CONN         NA        CONN      UConn     FBS Indep…
#> 3      87 Notre Da… Fight… ND           NA        ND        Notre Da… FBS Indep…
#> 4     113 UMass     Minut… UMASS        NA        UMASS     UMass     FBS Indep…
#> # ℹ 20 more variables: 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 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:18 UTC
#> # A tibble: 130 × 28
#>    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… AFA          NA        AFA       Air Force Mountain …
#>  2    2006 Akron    Zips   AKR          NA        AKR       Akron     Mid-Ameri…
#>  3     333 Alabama  Crims… ALA          NA        ALA       Alabama   SEC       
#>  4    2026 Appalac… Mount… APP          NA        APP       Appalach… Sun Belt  
#>  5      12 Arizona  Wildc… ARIZ         NA        ARIZ      Arizona   Pac-12    
#>  6       9 Arizona… Sun D… ASU          NA        ASU       Arizona … Pac-12    
#>  7       8 Arkansas Razor… ARK          NA        ARK       Arkansas  SEC       
#>  8    2032 Arkansa… Red W… ARST         NA        ARST      Arkansas… Sun Belt  
#>  9     349 Army     Black… ARMY         NA        ARMY      Army      FBS Indep…
#> 10       2 Auburn   Tigers AUB          NA        AUB       Auburn    SEC       
#> # ℹ 120 more rows
#> # ℹ 20 more variables: division <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>
# }