Skip to contents

Returns the long-format ranked teams for one (season x season-type x week x ranking-source). Typically 25 rows for MBB (AP Top 25).

Returns the long-format ranked teams for one (season x season-type x week x ranking-source). NBA typically returns an empty tibble.

Usage

espn_mbb_week_ranking(
  ranking_id,
  week,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

espn_nba_week_ranking(
  ranking_id,
  week,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

ranking_id

Ranking source id (1 = AP, 2 = Coaches, etc.).

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 tibble with one row per ranked team (typically 25).

Columns as documented in the shared espn_mbb_week_ranking_schema table.

A tibble with one row per ranked team (typically 25).

Columns as documented in the shared espn_mbb_week_ranking_schema table.

Details

Get ESPN MBB Per-Week Ranking Detail

Get ESPN NBA Per-Week Ranking Detail

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_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_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_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_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_week_ranking(ranking_id = 1, week = 5, season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Week Ranking Detail ───────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:47:44 UTC
#> # A tibble: 25 × 19
#>    league    season season_type  week ranking_id name  short_name type  headline
#>    <chr>      <int>       <int> <int> <chr>      <chr> <chr>      <chr> <chr>   
#>  1 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#>  2 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#>  3 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#>  4 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#>  5 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#>  6 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#>  7 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#>  8 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#>  9 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#> 10 mens-col…   2025           2     5 1          AP T… AP Poll    ap    2025 NC…
#> # ℹ 15 more rows
#> # ℹ 10 more variables: date <chr>, current <int>, previous <int>, points <dbl>,
#> #   first_place_votes <int>, trend <chr>, record_summary <chr>, team_id <chr>,
#> #   team_ref <chr>, last_updated <chr>
# }
# \donttest{
  espn_nba_week_ranking(ranking_id = 1, week = 5, season = 2025)
#>  2026-08-27 17:47:44.511801: Failed to retrieve ESPN nba week-5 ranking 1 for season=2025
#>  Args: league = "nba", season = 2025, season_type = 2L, week = 5, ranking_id = 1
#>  Error: The API returned an error
#> ── ESPN NBA Week Ranking Detail ───────────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:47:44 UTC
#> # A tibble: 0 × 0
# }