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.3 ──
#>  Data updated: 2022-09-23 03:23:51 UTC
#> # A tibble: 14 × 28
#>    team_id school   mascot abbre…¹ alt_n…² alt_n…³ alt_n…⁴ confe…⁵ class…⁶ color
#>      <int> <chr>    <chr>  <chr>   <chr>   <chr>   <chr>   <chr>   <chr>   <chr>
#>  1     333 Alabama  Crims… ALA     NA      ALA     Alabama SEC     fbs     #690…
#>  2       8 Arkansas Razor… ARK     NA      ARK     Arkans… SEC     fbs     #9c1…
#>  3       2 Auburn   Tigers AUB     NA      AUB     Auburn  SEC     fbs     #032…
#>  4      57 Florida  Gators FLA     NA      FLA     Florida SEC     fbs     #002…
#>  5      61 Georgia  Bulld… UGA     NA      UGA     Georgia SEC     fbs     #CC0…
#>  6      96 Kentucky Wildc… UK      NA      UK      Kentuc… SEC     fbs     #005…
#>  7      99 LSU      Tigers LSU     Louisi… LSU     LSU     SEC     fbs     #fdd…
#>  8     344 Mississ… Bulld… MSST    NA      MSST    Miss St SEC     fbs     #762…
#>  9     142 Missouri Tigers MIZ     NA      MIZ     Missou… SEC     fbs     #000…
#> 10     145 Ole Miss Rebels MISS    NA      MISS    Ole Mi… SEC     fbs     #001…
#> 11    2579 South C… Gamec… SC      NA      SC      South … SEC     fbs     #670…
#> 12    2633 Tenness… Volun… TENN    NA      TENN    Tennes… SEC     fbs     #EE9…
#> 13     245 Texas A… Aggies TA&M    NA      TA&M    Texas … SEC     fbs     #5C0…
#> 14     238 Vanderb… Commo… VAN     NA      VAN     Vander… SEC     fbs     #000…
#> # … with 18 more variables: 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>, and abbreviated variable names ¹​abbreviation,
#> #   ²​alt_name1, ³​alt_name2, ⁴​alt_name3, ⁵​conference, ⁶​classification

  try(cfbd_team_info(conference = "Ind"))
#> ── Team information from CollegeFootballData.com ───────────── cfbfastR 1.9.3 ──
#>  Data updated: 2022-09-23 03:23:51 UTC
#> # A tibble: 7 × 28
#>   team_id school    mascot abbre…¹ alt_n…² alt_n…³ alt_n…⁴ confe…⁵ class…⁶ color
#>     <int> <chr>     <chr>  <chr>   <chr>   <chr>   <chr>   <chr>   <chr>   <chr>
#> 1     349 Army      Black… ARMY    NA      ARMY    Army    FBS In… fbs     #ce9…
#> 2     252 BYU       Couga… BYU     Brigha… BYU     BYU     FBS In… fbs     #001…
#> 3      41 Connecti… Huski… CONN    NA      CONN    UConn   FBS In… fbs     #001…
#> 4    2335 Liberty   Flames LIB     NA      LIB     Liberty FBS In… fbs     #071…
#> 5     166 New Mexi… Aggies NMSU    NA      NMSU    New Me… FBS In… fbs     #891…
#> 6      87 Notre Da… Fight… ND      NA      ND      Notre … FBS In… fbs     #001…
#> 7     113 UMass     Minut… UMASS   NA      UMASS   UMass   FBS In… fbs     #880…
#> # … with 18 more variables: 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>, and abbreviated variable names ¹​abbreviation,
#> #   ²​alt_name1, ³​alt_name2, ⁴​alt_name3, ⁵​conference, ⁶​classification

  try(cfbd_team_info(year = 2019))
#> ── Team information from CollegeFootballData.com ───────────── cfbfastR 1.9.3 ──
#>  Data updated: 2022-09-23 03:23:51 UTC
#> # A tibble: 130 × 28
#>    team_id school   mascot abbre…¹ alt_n…² alt_n…³ alt_n…⁴ confe…⁵ divis…⁶ color
#>      <int> <chr>    <chr>  <chr>   <chr>   <chr>   <chr>   <chr>   <chr>   <chr>
#>  1    2005 Air For… Falco… AFA     NA      AFA     Air Fo… Mounta… Mounta… #004…
#>  2    2006 Akron    Zips   AKR     NA      AKR     Akron   Mid-Am… East    #002…
#>  3     333 Alabama  Crims… ALA     NA      ALA     Alabama SEC     West    #690…
#>  4    2026 Appalac… Mount… APP     NA      APP     Appala… Sun Be… West    #000…
#>  5      12 Arizona  Wildc… ARIZ    NA      ARIZ    Arizona Pac-12  South   #002…
#>  6       9 Arizona… Sun D… ASU     NA      ASU     Arizon… Pac-12  South   #942…
#>  7       8 Arkansas Razor… ARK     NA      ARK     Arkans… SEC     West    #9c1…
#>  8    2032 Arkansa… Red W… ARST    NA      ARST    Arkans… Sun Be… East    #e81…
#>  9     349 Army     Black… ARMY    NA      ARMY    Army    FBS In… NA      #ce9…
#> 10       2 Auburn   Tigers AUB     NA      AUB     Auburn  SEC     West    #032…
#> # … with 120 more rows, 18 more variables: 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>, and abbreviated variable names ¹​abbreviation,
#> #   ²​alt_name1, ³​alt_name2, ⁴​alt_name3, ⁵​conference, ⁶​division
# }