Skip to contents

Returns the list of week IDs for one (MBB season x season-type). MBB uses a week structure inherited from ESPN's schema, but week-level rankings are populated only for college (MBB / WBB).

Returns the list of week IDs for one (NBA season x season-type). NBA uses a week structure inherited from ESPN's schema, but week-level rankings are populated only for college (MBB / WBB).

Usage

espn_mbb_season_weeks(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

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

Arguments

season

Season year. Defaults to most recent MBB season.

season_type

Season-type id (2 = regular (default), 3 = postseason).

...

Additional arguments; currently unused.

Value

A tibble with one row per week.

Columns as documented in the shared espn_mbb_season_weeks_schema table.

A tibble with one row per week.

Columns as documented in the shared espn_mbb_season_weeks_schema table.

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_powerindex(), 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_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_powerindex(), 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_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_season_weeks(season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Season Weeks Index ────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:47:30 UTC
#> # A tibble: 24 × 5
#>    league                  season season_type  week ref                         
#>    <chr>                    <int>       <int> <int> <chr>                       
#>  1 mens-college-basketball   2025           2     1 http://sports.core.api.espn…
#>  2 mens-college-basketball   2025           2     2 http://sports.core.api.espn…
#>  3 mens-college-basketball   2025           2     3 http://sports.core.api.espn…
#>  4 mens-college-basketball   2025           2     4 http://sports.core.api.espn…
#>  5 mens-college-basketball   2025           2     5 http://sports.core.api.espn…
#>  6 mens-college-basketball   2025           2     6 http://sports.core.api.espn…
#>  7 mens-college-basketball   2025           2     7 http://sports.core.api.espn…
#>  8 mens-college-basketball   2025           2     8 http://sports.core.api.espn…
#>  9 mens-college-basketball   2025           2     9 http://sports.core.api.espn…
#> 10 mens-college-basketball   2025           2    10 http://sports.core.api.espn…
#> # ℹ 14 more rows
# }
# \donttest{
  espn_nba_season_weeks(season = 2025)
#> ── ESPN NBA Season Weeks Index ────────────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:47:31 UTC
#> # A tibble: 35 × 5
#>    league season season_type  week ref                                          
#>    <chr>   <int>       <int> <int> <chr>                                        
#>  1 nba      2025           2     1 http://sports.core.api.espn.com/v2/sports/ba…
#>  2 nba      2025           2     2 http://sports.core.api.espn.com/v2/sports/ba…
#>  3 nba      2025           2     3 http://sports.core.api.espn.com/v2/sports/ba…
#>  4 nba      2025           2     4 http://sports.core.api.espn.com/v2/sports/ba…
#>  5 nba      2025           2     5 http://sports.core.api.espn.com/v2/sports/ba…
#>  6 nba      2025           2     6 http://sports.core.api.espn.com/v2/sports/ba…
#>  7 nba      2025           2     7 http://sports.core.api.espn.com/v2/sports/ba…
#>  8 nba      2025           2     8 http://sports.core.api.espn.com/v2/sports/ba…
#>  9 nba      2025           2     9 http://sports.core.api.espn.com/v2/sports/ba…
#> 10 nba      2025           2    10 http://sports.core.api.espn.com/v2/sports/ba…
#> # ℹ 25 more rows
# }