Skip to contents

Get a teams full roster by year. If team is not selected, API returns rosters for every team from the selected year.

Usage

cfbd_team_roster(year, team = NULL)

Arguments

year

(Integer required): Year, 4 digit format (YYYY)

team

(String optional): Team, select a valid team in D-I football

Value

cfbd_team_roster() - A data frame with 12 variables:

athlete_id: character.

Referencing athlete id.

first_name: character.

Athlete first name.

last_name: character.

Athlete last name.

team: character.

Team name.

weight: integer.

Athlete weight.

height: integer.

Athlete height.

jersey: integer.

Athlete jersey number.

year: integer.

Athlete year.

position: character.

Athlete position.

home_city: character.

Hometown of the athlete.

home_state: character.

Hometown state of the athlete.

home_country: character.

Hometown country of the athlete.

home_latitude: numeric.

Hometown latitude.

home_longitude: number.

Hometown longitude.

home_county_fips: integer.

Hometown FIPS code.

headshot_url: character

Player ESPN headshot url.

Examples

# \donttest{
  try(cfbd_team_roster(year = 2013, team = "Florida State"))
#> ── Team roster data from CollegeFootballData.com ───────────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-09-10 01:24:23 UTC
#> # A tibble: 55 × 17
#>    athlete_id first_name last_name team      weight height jersey  year position
#>    <chr>      <chr>      <chr>     <chr>      <int>  <int>  <int> <int> <chr>   
#>  1 480772     Dan        Hicks     Florida …     NA     76      6    NA DE      
#>  2 480781     Jacobbi    McDaniel  Florida …     NA     72     55    NA DT      
#>  3 501075     Chad       Abram     Florida …     NA     72     41    NA FB      
#>  4 501076     Terrence   Brooks    Florida …     NA     71     31    NA DB      
#>  5 501077     Shayne     Broxsie   Florida …     NA     74     42    NA TE      
#>  6 501082     Jarred     Haggins   Florida …     NA     72     12    NA WR      
#>  7 501083     Christian  Jones     Florida …     NA     76      7    NA LB      
#>  8 501084     Lamarcus   Joyner    Florida …     NA     68     20    NA DB      
#>  9 501095     Telvin     Smith     Florida …     NA     75     22    NA LB      
#> 10 501097     Nigel      Terrell   Florida …     NA     74     43    NA LB      
#> # ℹ 45 more rows
#> # ℹ 8 more variables: home_city <chr>, home_state <chr>, home_country <chr>,
#> #   home_latitude <chr>, home_longitude <chr>, home_county_fips <chr>,
#> #   recruit_ids <list>, headshot_url <chr>
# }