Skip to contents

Get men's college basketball AP and Coaches Poll rankings from ESPN

Usage

espn_mbb_rankings()

Value

Returns a tibble

col_nametypesdescription
idintegerId.
namecharacterDisplay name.
short_namecharacterShort display name.
typecharacterRecord type / category.
headlinecharacterNews headline.
short_headlinecharacterShort news headline.
currentintegerCurrent.
previousintegerPrevious.
pointsnumericPoints scored.
first_place_votesintegerFirst place votes.
trendcharacterTrend.
datecharacterDate in YYYY-MM-DD format.
last_updatedcharacterLast updated.
record_summarycharacterWin-loss record summary string.
team_idintegerUnique team identifier.
team_uidcharacterESPN universal team identifier (UID format 's:40~l:...~t:...').
team_locationcharacterTeam city or location string.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_nicknamecharacterTeam nickname.
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
team_colorcharacterTeam primary color (hex without leading '#').
team_logocharacterTeam logo image URL.
occurrence_numberintegerOccurrence number.
occurrence_typecharacterOccurrence type.
occurrence_lastlogicalOccurrence last.
occurrence_valuecharacterOccurrence value.
occurrence_display_valuecharacterOccurrence display value.
season_yearintegerSeason year string ('YYYY-YY' format).
season_start_datecharacterDate in YYYY-MM-DD format.
season_end_datecharacterDate in YYYY-MM-DD format.
season_display_namecharacterSeason display label.
season_type_typeintegerSeason type type.
season_type_namecharacterSeason type name.
season_type_abbreviationcharacterSeason type abbreviation.
season_futures_refcharacterSeason futures ref.
first_occurrence_typecharacterFirst occurrence type.
first_occurrence_valuecharacterFirst occurrence value.

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_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_event_broadcasts(), espn_mbb_event_competitor_leaders(), espn_mbb_event_competitor_linescores(), espn_mbb_event_competitor_records(), espn_mbb_event_competitor_roster(), espn_mbb_event_competitor_roster_entry(), espn_mbb_event_competitor_score(), espn_mbb_event_competitor_statistics(), espn_mbb_event_odds(), espn_mbb_event_official_detail(), espn_mbb_event_officials(), espn_mbb_event_play(), espn_mbb_event_play_personnel(), espn_mbb_event_player_box(), 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_position(), espn_mbb_positions(), espn_mbb_powerindex(), 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_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), 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()

Author

Saiem Gilani

Examples

# Get current AP and Coaches Poll rankings
# \donttest{
try(espn_mbb_rankings())
#> ── ESPN MBB Rankings Information from ESPN.com ────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-22 07:30:31 UTC
#> # A tibble: 81 × 39
#>       id name   short_name type  headline short_headline current previous points
#>    <int> <chr>  <chr>      <chr> <chr>    <chr>            <int>    <int>  <dbl>
#>  1     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        1        3   1425
#>  2     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        2        7   1352
#>  3     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        3        2   1311
#>  4     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        4        1   1237
#>  5     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        5       13   1228
#>  6     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        6        8   1113
#>  7     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        7        5   1021
#>  8     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        8        6    924
#>  9     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3        9        4    909
#> 10     1 AP To… AP Poll    ap    2026 NC… 2026 : Week 3       10       10    891
#> # ℹ 71 more rows
#> # ℹ 30 more variables: first_place_votes <int>, trend <chr>, date <chr>,
#> #   last_updated <chr>, record_summary <chr>, team_id <int>, team_uid <chr>,
#> #   team_location <chr>, team_name <chr>, team_nickname <chr>,
#> #   team_abbreviation <chr>, team_color <chr>, team_logos <list>,
#> #   team_logo <chr>, occurrence_number <int>, occurrence_type <chr>,
#> #   occurrence_last <lgl>, occurrence_value <chr>, …
# }