Skip to contents

Load a dataframe of player-level information, including IDs and other mostly-immutable data (birthdates, college, draft position etc.)

Usage

load_players(file_type = getOption("nflreadr.prefer", default = "rds"))

Arguments

file_type

One of c("rds", "qs", "csv", "parquet"). Can also be set globally with options(nflreadr.prefer)

Value

A tibble with one row per player.

See also

Issues with this data should be filed here: https://github.com/nflverse/nflreadr and it will be triaged appropriately.

Examples

# \donttest{
try({ # prevents cran errors
  load_players()
})
#> ── nflverse players ────────────────────────────────────────────────────────────
#>  Data updated: 2025-05-01 02:04:15 UTC
#> # A tibble: 20,758 × 32
#>    college_conference       current_team_id display_name draft_club draft_number
#>    <chr>                    <chr>           <chr>        <chr>             <int>
#>  1 NA                       4400            'Omar Ellis… NA                   NA
#>  2 Southeastern Conference  0750            A'Shawn Rob… DET                  46
#>  3 Big Ten Conference       2510            A.J. Arcuri  LA                  261
#>  4 Big Ten Conference       4600            A.J. Barner  SEA                 121
#>  5 American Athletic Confe… 0750            A.J. Bouye   NA                   NA
#>  6 Southeastern Conference  3700            A.J. Brown   TEN                  51
#>  7 Southeastern Conference  2120            A.J. Cann    JAX                  67
#>  8 Atlantic Coast Conferen… 2520            A.J. Cole    NA                   NA
#>  9 NA                       2700            A.J. Cruz    NA                   NA
#> 10 NA                       1540            A.J. Dalton  NA                   NA
#> # ℹ 20,748 more rows
#> # ℹ 27 more variables: draftround <int>, entry_year <int>, esb_id <chr>,
#> #   first_name <chr>, football_name <chr>, gsis_id <chr>, gsis_it_id <int>,
#> #   jersey_number <int>, last_name <chr>, position <chr>, position_group <chr>,
#> #   rookie_year <int>, short_name <chr>, status <chr>,
#> #   status_description_abbr <chr>, status_short_description <chr>,
#> #   team_abbr <chr>, uniform_number <chr>, height <dbl>, weight <int>, …
# }