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).

Usage

espn_mbb_week_ranking(
  ranking_id,
  week,
  season = most_recent_mbb_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).

col_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year.
season_typeintegerSeason-type id.
weekintegerWeek number.
ranking_idcharacterESPN ranking id.
namecharacterRanking name (e.g. "AP Top 25").
short_namecharacterShort name.
typecharacterRanking type code.
headlinecharacterFull headline.
datecharacterDate of the ranking.
currentintegerCurrent rank.
previousintegerPrevious-week rank.
pointsnumericVoting points.
first_place_votesintegerFirst-place vote count.
trendcharacterTrend indicator (e.g. "+3", "-2", "-").
record_summarycharacterTeam's record at time of poll (e.g. "20-2").
team_idcharacterESPN team id.
team_refcharacter$ref to the team-in-season resource.
last_updatedcharacterLast-updated timestamp.

Details

Get ESPN MBB Per-Week Ranking Detail

See also

Other ESPN MBB Functions: espn_mbb_athlete_awards(), espn_mbb_athlete_career_stats(), espn_mbb_athlete_eventlog(), espn_mbb_athlete_eventlog_v2(), espn_mbb_athlete_gamelog(), espn_mbb_athlete_info(), espn_mbb_athlete_overview(), espn_mbb_athlete_seasons(), espn_mbb_athlete_splits(), espn_mbb_athlete_statisticslog(), espn_mbb_athlete_stats(), espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_event_broadcasts(), espn_mbb_event_odds(), espn_mbb_event_officials(), espn_mbb_event_powerindex(), espn_mbb_event_predictor(), espn_mbb_event_probabilities(), espn_mbb_event_propbets(), espn_mbb_event_situation(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_rosters(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_box(), espn_mbb_player_stats(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), 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_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_rankings(), espn_mbb_wp()

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-05-19 01:33:37 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>
# }