Skip to contents

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

Usage

espn_mbb_rankings()

Value

A hoopR_data tibble with one row per ranked team.

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

family_espn_mbb lists every function in this family.

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.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:25 UTC
#> # A tibble: 84 × 38
#>       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    2027 NC… 2027 : Week 2        1        1   1490
#>  2     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2        2        2   1432
#>  3     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2        3        3   1366
#>  4     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2        4        4   1339
#>  5     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2        5        6   1222
#>  6     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2        6        9   1161
#>  7     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2        7        7   1092
#>  8     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2        8       10    947
#>  9     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2        9       22    925
#> 10     1 AP To… AP Poll    ap    2027 NC… 2027 : Week 2       10       11    901
#> # ℹ 74 more rows
#> # ℹ 29 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>, …
# }