Skip to contents

Get ESPN NBA team stats data

Source: R/espn_nba_data.R
espn_nba_team_stats.Rd

Get ESPN NBA team stats data

Usage

espn_nba_team_stats(team_id, year, season_type = "regular", total = FALSE)

Arguments

team_id

Team ID

year

Year

season_type

(character, default: regular): Season type - regular or postseason

total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the team stats data

col_nametypesdescription
team_idintegerUnique team identifier.
team_guidcharacterESPN team GUID.
team_uidcharacterESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationcharacterTeam city or location string.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
team_display_namecharacterFull team display name.
team_short_display_namecharacterShort team display name (e.g. 'Aces').
team_colorcharacterTeam primary color (hex without leading '#').
team_alternate_colorcharacterTeam alternate color (hex without leading '#').
team_is_activelogicalTRUE if the team is currently active.
team_is_all_starlogicalTRUE if the row represents an All-Star team.
logo_hrefcharacterTeam or league logo URL.
logo_dark_hrefcharacterLogo URL for dark backgrounds.
logos_href_2characterLogos href 2.
logos_href_3characterLogos href 3.
defensive_blocksnumericShort for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_reboundsnumericThe number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_stealsnumericThe number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_turnover_pointsnumericThe amount of points resulting from the possession following a turnover.
defensive_def_rebound_ratenumericThe percentage of missed shots that a team rebounds defensively. Rebound Rate = (Defensive Rebounds x Team Minutes) divided by (Player Minutes x (Team Defensive Rebounds + Opponent Defensive Rebounds)).
defensive_avg_defensive_reboundsnumericThe average defensive rebounds per game.
defensive_avg_blocksnumericThe average blocks per game.
defensive_avg_stealsnumericThe average steals per game.
defensive_avg48defensive_reboundsnumericThe average number of defensive rebounds per 48 minutes.
defensive_avg48blocksnumericThe average number of blocks per 48 minutes.
defensive_avg48stealsnumericThe average number of steals per 48 minutes.
general_disqualificationsnumericThe number of times a player reached the foul limit.
general_flagrant_foulsnumericThe number of fouls that the officials thought were unnecessary or excessive.
general_foulsnumericThe number of times a player had illegal contact with the opponent.
general_rebound_ratenumericThe percentage of missed shots that a team rebounds. Rebound Rate = (Rebounds x Team Minutes) divided by (Player Minutes x (Team Rebounds + Opponent Rebounds)).
general_ejectionsnumericThe number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_foulsnumericThe number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_reboundsnumericThe total number of rebounds (offensive and defensive).
general_minutesnumericThe total number of minutes played.
general_avg_minutesnumericThe average number of minutes per game.
general_fantasy_ratingnumericThe Fantasy Rating of a player.
general_nba_ratingnumericGeneral nba rating.
general_plus_minusnumericA player's estimated on-court impact on team performance measured in point differential per 100 possessions.
general_avg_reboundsnumericThe average rebounds per game.
general_avg_foulsnumericThe average fouls committed per game.
general_avg_flagrant_foulsnumericThe average number of flagrant fouls per game.
general_avg_technical_foulsnumericThe average number of technical fouls per game.
general_avg_ejectionsnumericThe average ejections per game.
general_avg_disqualificationsnumericThe average number of disqualifications per game.
general_assist_turnover_rationumericThe average number of assists a player or team records per turnover.
general_steal_foul_rationumericThe average number of steals a player or team records per foul committed.
general_block_foul_rationumericThe average number of blocks a player or record per foul committed.
general_avg_team_reboundsnumericThe average number of rebounds for a team per game.
general_total_reboundsnumericThe total number of rebounds for a team or player.
general_total_technical_foulsnumericThe total number of technical fouls for a team or player.
general_team_assist_turnover_rationumericThe number of assists per turnover for a team.
general_team_reboundsnumericThe total number of rebounds for a team.
general_steal_turnover_rationumericThe number of steals per turnover.
general_avg48reboundsnumericThe average number of rebounds per 48 minutes.
general_avg48foulsnumericThe average number of fouls committed per 48 minutes.
general_avg48flagrant_foulsnumericThe average number of flagrant fouls committed per 48 minutes.
general_avg48technical_foulsnumericThe average number of technical fouls committed per 48 minutes.
general_avg48ejectionsnumericThe average number of ejections per 48 minutes.
general_avg48disqualificationsnumericThe average number of disqualifications per 48 minutes.
general_r40numericRebounds Per 40 Minutes.
general_games_playednumericGames Played.
general_games_startednumericThe number of games started by an athlete.
general_double_doublenumericThe number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_doublenumericThe number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assistsnumericThe number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_effective_fg_pctnumericOffensive effective field goals percentage (0-1 decimal).
offensive_field_goalsnumericField Goal makes and attempts.
offensive_field_goals_attemptednumericThe number of times a 2pt field goal was attempted.
offensive_field_goals_madenumericThe number of times a 2pt field goal was made.
offensive_field_goal_pctnumericThe ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throwsnumericFree Throw makes and attempts.
offensive_free_throw_pctnumericThe ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attemptednumericThe number of times a free throw was attempted.
offensive_free_throws_madenumericThe number of times a free throw was made.
offensive_offensive_reboundsnumericThe number of times when the offense obtains the possession of the ball after a missed shot.
offensive_pointsnumericThe number of points scored.
offensive_turnoversnumericThe number of times a player loses possession to the other team.
offensive_three_point_pctnumericThe ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_three_point_field_goals_attemptednumericThe number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_madenumericThe number of times a 3pt field goal was made.
offensive_true_shooting_pctnumericWhat a team's shooting percentage would be if we accounted for free throws and 3-pointers. True Shooting Percentage = (Total points x 50) divided by ((FGA + (FTA x 0.44)).
offensive_team_turnoversnumericThe number of turnovers for the team.
offensive_total_turnoversnumericThe number of turnovers plus team turnovers for the team.
offensive_assist_rationumericThe percentage of a team's possessions that ends in an assist. Assist Ratio = (Assists x 100) divided by ((FGA + (FTA x 0.44) + Assists + Turnovers).
offensive_points_in_paintnumericThe amount of points scored in the area known as "the Paint"(the rectangle between the foul line and the baseline).
offensive_off_rebound_ratenumericThe percentage of missed shots that a team rebounds offensively. Offensive Rebound Rate = (Offensive Rebounds x Team Minutes) divided by (Player Minutes x (Team Offensive Rebounds + Opponent Defensive Rebounds)).
offensive_turnover_rationumericThe percentage of a team's possessions that end in a turnover. Turnover Ratio = (Turnover x 100) divided by ((FGA + (FTA x 0.44) + Assists + Turnovers).
offensive_fast_break_pointsnumericThe number of points scored on fast breaks.
offensive_possessionsnumericThe total number of possessions for a team or player.
offensive_pace_factornumericThe number of possessions a team uses per game.
offensive_avg_field_goals_madenumericThe average field goals made per game.
offensive_avg_field_goals_attemptednumericThe average field goals attempted per game.
offensive_avg_three_point_field_goals_madenumericThe average three point field goals made per game.
offensive_avg_three_point_field_goals_attemptednumericThe average three point field goals attempted per game.
offensive_avg_free_throws_madenumericThe average free throw shots made per game.
offensive_avg_free_throws_attemptednumericThe average free throw shots attempted per game.
offensive_avg_pointsnumericThe average number of points scored per game.
offensive_avg_offensive_reboundsnumericThe average offensive rebounds per game.
offensive_avg_assistsnumericThe average assists per game.
offensive_avg_turnoversnumericThe average turnovers committed per game.
offensive_offensive_rebound_pctnumericThe percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessionsnumericAn estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessionsnumericThe average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessionsnumericThe number of points per estimated possession for a team or player.
offensive_avg_team_turnoversnumericThe average number of turnovers for a team per game.
offensive_avg_total_turnoversnumericThe average number of total turnovers for a team per game.
offensive_three_point_field_goal_pctnumericThe ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_madenumericThe number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attemptednumericThe number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_madenumericThe number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attemptednumericThe number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pctnumericThe percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiencynumericThe efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiencynumericThe efficiency with which a team or player scores the basketball.
offensive_avg48field_goals_madenumericThe average number of fieldgoals made per 48 minutes.
offensive_avg48field_goals_attemptednumericThe average number of fieldgoals attempted per 48 minutes.
offensive_avg48three_point_field_goals_madenumericThe average per number of 3-Pointers made per 48 minutes.
offensive_avg48three_point_field_goals_attemptednumericThe average number of 3-pointers attempted per 48 minutes.
offensive_avg48free_throws_madenumericThe average number of Free Throws made per 48 minutes.
offensive_avg48free_throws_attemptednumericThe average number of free throws attempted per 48 minutes.
offensive_avg48pointsnumericThe average number of points scored per 48 minutes.
offensive_avg48offensive_reboundsnumericThe average number of offenseive rebounds per 48 minutes.
offensive_avg48assistsnumericThe average number of assists per 48 minutes.
offensive_avg48turnoversnumericThe average number of turnovers per 48 minutes.
offensive_p40numericPoints Per 40 Minutes.
offensive_a40numericAssists Per 40 Minutes.

See also

Other ESPN NBA Functions: espn_nba_athlete_awards(), espn_nba_athlete_career_stats(), espn_nba_athlete_contract(), espn_nba_athlete_contracts(), espn_nba_athlete_eventlog(), espn_nba_athlete_eventlog_v2(), espn_nba_athlete_gamelog(), espn_nba_athlete_info(), espn_nba_athlete_overview(), espn_nba_athlete_seasons(), espn_nba_athlete_splits(), espn_nba_athlete_statisticslog(), espn_nba_athlete_stats(), espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_event_broadcasts(), espn_nba_event_competitor_leaders(), espn_nba_event_competitor_linescores(), espn_nba_event_competitor_records(), espn_nba_event_competitor_roster(), espn_nba_event_competitor_roster_entry(), espn_nba_event_competitor_score(), espn_nba_event_competitor_statistics(), espn_nba_event_odds(), espn_nba_event_official_detail(), espn_nba_event_officials(), espn_nba_event_play(), espn_nba_event_play_personnel(), espn_nba_event_player_box(), espn_nba_event_powerindex(), espn_nba_event_predictor(), espn_nba_event_probabilities(), espn_nba_event_propbets(), espn_nba_event_situation(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_rosters(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_box(), espn_nba_player_stats(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Author

Saiem Gilani

Examples

# \donttest{
try(espn_nba_team_stats(team_id = 13, year = 2020))
#> ── ESPN NBA Team Season Stats from ESPN.com ───────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-05-19 19:27:12 UTC
#> # A tibble: 1 × 213
#>   team_id team_guid team_uid team_slug team_location team_name team_abbreviation
#>     <int> <chr>     <chr>    <chr>     <chr>         <chr>     <chr>            
#> 1      13 2876e98b… s:40~l:… los-ange… Los Angeles   Lakers    LAL              
#> # ℹ 206 more variables: team_display_name <chr>, team_short_display_name <chr>,
#> #   team_color <chr>, team_alternate_color <chr>, team_is_active <lgl>,
#> #   team_is_all_star <lgl>, logo_href <chr>, logo_dark_href <chr>,
#> #   logos_href_2 <chr>, logos_href_3 <chr>, logos_href_4 <chr>,
#> #   logos_width_4 <int>, logos_height_4 <int>, logos_alt_4 <chr>,
#> #   logos_rel_full_4 <chr>, logos_rel_primary_logo_on_white_color <chr>,
#> #   logos_last_updated_4 <chr>, logos_href_5 <chr>, logos_width_5 <int>, …
# }