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_nba_season_weeks(
season = most_recent_nba_season(),
season_type = c(2L, 3L),
...
)Value
A tibble with one row per week.
| col_name | types | description |
| league | character | League slug. |
| season | integer | Season year. |
| season_type | integer | Season-type id. |
| week | integer | Week number (1-based). |
| ref | character | $ref URL for the week detail. |
See also
Other ESPN NBA Functions:
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_franchise(),
espn_nba_franchises(),
espn_nba_freeagents(),
espn_nba_futures(),
espn_nba_game_all(),
espn_nba_game_broadcasts(),
espn_nba_game_odds(),
espn_nba_game_official_detail(),
espn_nba_game_officials(),
espn_nba_game_play(),
espn_nba_game_play_personnel(),
espn_nba_game_player_box(),
espn_nba_game_powerindex(),
espn_nba_game_predictor(),
espn_nba_game_probabilities(),
espn_nba_game_propbets(),
espn_nba_game_rosters(),
espn_nba_game_situation(),
espn_nba_game_team_leaders(),
espn_nba_game_team_linescores(),
espn_nba_game_team_records(),
espn_nba_game_team_roster(),
espn_nba_game_team_roster_entry(),
espn_nba_game_team_score(),
espn_nba_game_team_statistics(),
espn_nba_injuries(),
espn_nba_leaders(),
espn_nba_news(),
espn_nba_pbp(),
espn_nba_player_awards(),
espn_nba_player_box(),
espn_nba_player_career_stats(),
espn_nba_player_contract(),
espn_nba_player_contracts(),
espn_nba_player_eventlog(),
espn_nba_player_eventlog_v2(),
espn_nba_player_gamelog(),
espn_nba_player_info(),
espn_nba_player_overview(),
espn_nba_player_seasons(),
espn_nba_player_splits(),
espn_nba_player_statisticslog(),
espn_nba_player_stats(),
espn_nba_player_stats_v3(),
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_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_team_stats(),
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()
Examples
# \donttest{
espn_nba_season_weeks(season = 2025)
#> ── ESPN NBA Season Weeks Index ────────────────────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-06-04 12:21:06 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
# }