Skip to contents

Returns metadata for one week (number, start / end dates, text label, and $ref to the per-week rankings endpoint).

Returns metadata for one week (number, start / end dates, text label, and $ref to the per-week rankings endpoint).

Usage

espn_mbb_season_week(
  week,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

espn_nba_season_week(
  week,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.

season

Season year. Defaults to most recent MBB season.

season_type

Season-type id (2 = regular (default)).

...

Additional arguments; currently unused.

Value

A hoopR_data tibble with one row per week.

col_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year.
season_typeintegerSeason-type id.
weekintegerWeek number.
textcharacterDisplay label (e.g. "Week 5").
start_datecharacterISO 8601 week start.
end_datecharacterISO 8601 week end.
rankings_refcharacter$ref to the per-week rankings endpoint.

A hoopR_data tibble with one row per week.

col_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year.
season_typeintegerSeason-type id.
weekintegerWeek number.
textcharacterDisplay label (e.g. "Week 5").
start_datecharacterISO 8601 week start.
end_datecharacterISO 8601 week end.
rankings_refcharacter$ref to the per-week rankings endpoint.

Details

Get ESPN MBB Season-Week Detail

Get ESPN NBA Season-Week Detail

See also

family_espn_mbb lists every function in this family.

family_espn_nba lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_season_week(week = 5, season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Season Week Detail ────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:33 UTC
#> # A tibble: 1 × 8
#>   league         season season_type  week text  start_date end_date rankings_ref
#>   <chr>           <int>       <int> <int> <chr> <chr>      <chr>    <chr>       
#> 1 mens-college-…   2025           2     5 Week… 2024-12-0… 2024-12… http://spor…
# }
# \donttest{
  espn_nba_season_week(week = 5, season = 2025)
#> ── ESPN NBA Season Week Detail ────────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:33 UTC
#> # A tibble: 1 × 8
#>   league season season_type  week text   start_date        end_date rankings_ref
#>   <chr>   <int>       <int> <int> <chr>  <chr>             <chr>    <chr>       
#> 1 nba      2025           2     5 Week 5 2024-11-19T08:00Z 2024-11… http://spor…
# }