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.3 ──
#>  Data updated: 2022-09-23 03:23:54 UTC
#> # A tibble: 55 × 17
#>    athlete_id first_n…¹ last_…² team  weight height jersey  year posit…³ home_…⁴
#>    <chr>      <chr>     <chr>   <chr>  <int>  <int>  <int> <int> <chr>   <chr>  
#>  1 480772     Dan       Hicks   Flor…     NA     76      6    NA DE      Oxford 
#>  2 480781     Jacobbi   McDani… Flor…     NA     72     55    NA DT      Greenv…
#>  3 501075     Chad      Abram   Flor…     NA     72     41    NA FB      Lakela…
#>  4 501076     Terrence  Brooks  Flor…     NA     71     31    NA DB      Dunnel…
#>  5 501077     Shayne    Broxsie Flor…     NA     74     42    NA TE      Montic…
#>  6 501082     Jarred    Haggins Flor…     NA     72     12    NA WR      Lakela…
#>  7 501083     Christian Jones   Flor…     NA     76      7    NA LB      Winter…
#>  8 501084     Lamarcus  Joyner  Flor…     NA     68     20    NA DB      Ft. La…
#>  9 501095     Telvin    Smith   Flor…     NA     75     22    NA LB      Valdos…
#> 10 501097     Nigel     Terrell Flor…     NA     74     43    NA LB      Helena 
#> # … with 45 more rows, 7 more variables: home_state <chr>, home_country <chr>,
#> #   home_latitude <chr>, home_longitude <chr>, home_county_fips <chr>,
#> #   recruit_ids <list>, headshot_url <chr>, and abbreviated variable names
#> #   ¹​first_name, ²​last_name, ³​position, ⁴​home_city
# }