Get ESPN NBA Season Power Index (Long Format)

Returns ESPN's Basketball Power Index (BPI) and related per-team metrics for one NBA season, in long format: one row per (team x stat). Auto-paginates through all teams. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/powerindex.

Usage

espn_nba_powerindex(
  season = most_recent_nba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year (numeric). Defaults to the most recent NBA season.

season_type

Integer (1=preseason, 2=regular (default), 3=postseason).

...

Additional arguments; currently unused.

Value

A long tibble with one row per (team x stat).

col_name	types	description
league	character	League slug ("nba").
season	integer	Season year.
season_type	integer	1=preseason, 2=regular, 3=postseason.
team_id	character	ESPN team id (parsed from team_ref).
stat_name	character	Internal stat key (e.g. "bpi").
abbreviation	character	Short stat abbreviation.
display_name	character	Human-readable stat name.
description	character	Stat description.
value	numeric	Stat value.
display_value	character	Display-formatted value.
last_updated	character	Last-updated timestamp.
team_ref	character	$ref to the team-in-season resource.

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_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_event_broadcasts(), espn_nba_event_odds(), espn_nba_event_officials(), 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_scoreboard(), espn_nba_season_awards(), 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_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), 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{
  espn_nba_powerindex(season = 2025)
#> ── ESPN NBA Season Power Index ────────────────────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-05-19 01:34:03 UTC
#> # A tibble: 4,260 × 12
#>    league season season_type team_id stat_name     abbreviation display_name
#>    <chr>   <int>       <int> <chr>   <chr>         <chr>        <chr>       
#>  1 nba      2025           2 25      bpi           BPI          BPI         
#>  2 nba      2025           2 25      bpirank       bpiRank      BPI RANK    
#>  3 nba      2025           2 25      bpioffense    Off          BPI OFFENSE 
#>  4 nba      2025           2 25      bpidefense    Def          BPI DEFENSE 
#>  5 nba      2025           2 25      numwins       W            NUM WINS    
#>  6 nba      2025           2 25      numlosses     L            NUM LOSSES  
#>  7 nba      2025           2 25      winpct        WPct         WIN PCT     
#>  8 nba      2025           2 25      projectedw    ProjW        PROJ WINS   
#>  9 nba      2025           2 25      projectedl    ProjL        PROJ LOSSES 
#> 10 nba      2025           2 25      projectedwpct ProjWPct     PROJ WIN PCT
#> # ℹ 4,250 more rows
#> # ℹ 5 more variables: description <chr>, value <dbl>, display_value <chr>,
#> #   last_updated <chr>, team_ref <chr>
# }