Skip to contents

Returns ESPN's Basketball Power Index (BPI) and related per-team metrics for one MBB season, in long format: one row per (team x stat). Auto-paginates through all teams.

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_mbb_powerindex(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

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

Arguments

season

Season year (numeric). Defaults to the most recent MBB 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_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year.
season_typeinteger1=preseason, 2=regular, 3=postseason.
team_idcharacterESPN team id.
stat_namecharacterInternal stat key.
abbreviationcharacterShort stat abbreviation.
display_namecharacterHuman-readable stat name.
descriptioncharacterStat description.
valuenumericStat value.
display_valuecharacterDisplay-formatted value.
last_updatedcharacterLast-updated timestamp.
team_refcharacter$ref to the team-in-season resource.

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

col_nametypesdescription
leaguecharacterLeague slug ("nba").
seasonintegerSeason year.
season_typeinteger1=preseason, 2=regular, 3=postseason.
team_idcharacterESPN team id (parsed from team_ref).
stat_namecharacterInternal stat key (e.g. "bpi").
abbreviationcharacterShort stat abbreviation.
display_namecharacterHuman-readable stat name.
descriptioncharacterStat description.
valuenumericStat value.
display_valuecharacterDisplay-formatted value.
last_updatedcharacterLast-updated timestamp.
team_refcharacter$ref to the team-in-season resource.

See also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster_entry(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Other ESPN NBA Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster_entry(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp(), espn_nba_draft_pick(), espn_nba_freeagents(), espn_nba_player_contracts(), espn_nba_team_depthchart(), espn_nba_transactions()

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_powerindex(season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Season Power Index ────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:47:16 UTC
#> # A tibble: 1,475 × 12
#>    league         season season_type team_id stat_name abbreviation display_name
#>    <chr>           <int>       <int> <chr>   <chr>     <chr>        <chr>       
#>  1 mens-college-…   2025          NA 150     bpi       NA           BPI         
#>  2 mens-college-…   2025          NA 150     bpirank   NA           BPI RK      
#>  3 mens-college-…   2025          NA 150     rpirank   NA           RPI RK      
#>  4 mens-college-…   2025          NA 150     sor       NA           SOR         
#>  5 mens-college-…   2025          NA 150     sorrank   NA           SOR RK      
#>  6 mens-college-…   2025          NA 150     sospast   NA           SOS         
#>  7 mens-college-…   2025          NA 150     sospastr… NA           SOS RK      
#>  8 mens-college-…   2025          NA 150     wins      NA           W           
#>  9 mens-college-…   2025          NA 150     losses    NA           L           
#> 10 mens-college-…   2025          NA 150     winpct    NA           W-L         
#> # ℹ 1,465 more rows
#> # ℹ 5 more variables: description <chr>, value <dbl>, display_value <chr>,
#> #   last_updated <chr>, team_ref <chr>
# }
# \donttest{
  espn_nba_powerindex(season = 2025)
#> ── ESPN NBA Season Power Index ────────────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:47:19 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>
# }