Skip to contents

Load Player Level Stats

Source: R/load_stats.R
load_player_stats.Rd

Load Player Level Stats

Usage

load_player_stats(
  seasons = most_recent_season(),
  ...,
  summary_level = c("week", "reg", "post", "reg+post"),
  file_type = getOption("nflreadr.prefer", default = "rds"),
  stat_type = lifecycle::deprecated()
)

Arguments

seasons

a numeric vector of seasons to return, defaults to most recent season. If set to TRUE, returns all available data.

...

These dots are for future extensions and must be empty.

summary_level

choice: one of week (default), "reg" for regular season, "post" for postseason, "reg+post" for combined regular season + postseason stats

file_type

choice: one of c("rds", "csv", "parquet"). Can also be set globally with options(nflreadr.prefer)

stat_type

[Deprecated] - now returns all stat types by default

Value

A tibble of player statistics that aims to match NFL official box scores and season summaries

See also

https://nflreadr.nflverse.com/articles/dictionary_player_stats.html for a web version of the data dictionary

dictionary_player_stats for the data dictionary

Examples

# \donttest{
try({
  load_player_stats()
})
#> ── nflverse player stats: week level ───────────────────────────────────────────
#> ℹ Data updated: 2026-09-17 09:04:15 UTC
#> # A tibble: 1,118 × 150
#>    player_id  player_name player_display_name position position_group
#>    <chr>      <chr>       <chr>               <chr>    <chr>         
#>  1 00-0023459 A.Rodgers   Aaron Rodgers       QB       QB            
#>  2 00-0025565 N.Folk      Nick Folk           K        SPEC          
#>  3 00-0026190 C.Campbell  Calais Campbell     DE       DL            
#>  4 00-0026498 M.Stafford  Matthew Stafford    QB       QB            
#>  5 00-0027969 C.Heyward   Cameron Heyward     DE       DL            
#>  6 00-0029604 K.Cousins   Kirk Cousins        QB       QB            
#>  7 00-0029606 H.Smith     Harrison Smith      FS       DB            
#>  8 00-0029607 D.Davis     Demario Davis       OLB      LB            
#>  9 00-0029692 B.Anger     Bryan Anger         P        SPEC          
#> 10 00-0029714 A.DePaola   Andrew DePaola      LS       SPEC          
#> # ℹ 1,108 more rows
#> # ℹ 145 more variables: headshot_url <chr>, season <int>, week <int>,
#> #   season_type <chr>, game_id <chr>, team <chr>, opponent_team <chr>,
#> #   completions <int>, attempts <int>, passing_yards <int>, passing_tds <int>,
#> #   passing_interceptions <int>, sacks_suffered <int>, sack_yards_lost <int>,
#> #   sack_fumbles <int>, sack_fumbles_lost <int>, passing_air_yards <int>,
#> #   passing_yards_after_catch <int>, passing_first_downs <int>, …
# }