Skip to contents

Load Team Level Stats

Usage

load_team_stats(
  seasons = most_recent_season(),
  ...,
  summary_level = c("week", "reg", "post", "reg+post"),
  file_type = getOption("nflreadr.prefer", default = "rds")
)

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 + post season stats

file_type

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

Value

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

See also

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

dictionary_team_stats for the data dictionary

Examples

# \donttest{
try({
  load_team_stats()
})
#> ── nflverse team stats: week level ─────────────────────────────────────────────
#>  Data updated: 2025-09-02 09:31:39 UTC
#> # A tibble: 570 × 102
#>    season  week team  season_type opponent_team completions attempts
#>     <int> <int> <chr> <chr>       <chr>               <int>    <int>
#>  1   2024     1 ARI   REG         BUF                    21       31
#>  2   2024     1 ATL   REG         PIT                    16       26
#>  3   2024     1 BAL   REG         KC                     26       41
#>  4   2024     1 BUF   REG         ARI                    18       23
#>  5   2024     1 CAR   REG         NO                     13       31
#>  6   2024     1 CHI   REG         TEN                    14       29
#>  7   2024     1 CIN   REG         NE                     21       29
#>  8   2024     1 CLE   REG         DAL                    24       45
#>  9   2024     1 DAL   REG         CLE                    19       32
#> 10   2024     1 DEN   REG         SEA                    26       42
#> # ℹ 560 more rows
#> # ℹ 95 more variables: 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>,
#> #   passing_epa <dbl>, passing_cpoe <dbl>, passing_2pt_conversions <int>,
#> #   carries <int>, rushing_yards <int>, rushing_tds <int>, …
# }