Skip to contents

Get ESPN MCH / WCH Rankings (Site v2 polls)

Usage

espn_mch_rankings(...)

espn_wch_rankings(...)

Arguments

...

Passed through to .retry_request() (e.g. proxy =).

Value

A fastRhockey_data tibble with one row per (poll, team), always with the same 25 columns; zero rows (with those columns) when no poll is published:

col_nametypedescription
poll_idintegerESPN poll identifier.
poll_namecharacterPoll name.
poll_short_namecharacterPoll short name.
poll_typecharacterPoll type code.
seasonintegerSeason end-year.
season_typeintegerSeason type (2 = regular season, 3 = postseason).
weekintegerPoll week within the season type.
week_displaycharacterPoll week display string.
poll_datecharacterPoll date (ISO 8601).
rankedlogicalTRUE for a ranked team, FALSE for a team receiving votes.
team_idcharacterESPN team identifier.
rankintegerCurrent rank (NA when not ranked).
previous_rankintegerPrevious poll rank (0 = unranked).
pointsnumericPoll points.
first_place_votesintegerFirst-place votes (NA when not published).
trendcharacterRank trend indicator.
record_summarycharacterTeam record summary.
team_uidcharacterESPN team UID.
team_locationcharacterTeam location.
team_namecharacterTeam name.
team_nicknamecharacterTeam nickname.
team_abbreviationcharacterTeam abbreviation.
team_colorcharacterTeam colour hex (NA when ESPN ships "NULL").
team_logocharacterTeam logo URL.
last_updatedcharacterEntry last-updated timestamp.

Details

ESPN men's college hockey polls (USCHO), league slug mens-college-hockey. rank is NA on the vote-receiving rows (ranked = FALSE); previous_rank keeps ESPN's 0 for a team unranked in the previous poll. Mirrors sportsdataverse-py espn_mch_rankings().

espn_wch_rankings() is the same wrapper for women's college hockey (league slug womens-college-hockey): same arguments, same columns.

See also

family_espn_mch lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_mch_rankings())
#> ── MENS-COLLEGE-HOCKEY Rankings data from ESPN.com ──────── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:26:28 UTC
#> # A tibble: 33 × 25
#>    poll_id poll_name        poll_short_name  poll_type  season season_type  week
#>      <int> <chr>            <chr>            <chr>       <int>       <int> <int>
#>  1   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#>  2   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#>  3   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#>  4   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#>  5   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#>  6   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#>  7   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#>  8   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#>  9   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#> 10   10624 USCHO Men's Poll USCHO Men's Poll USCHOMENS…   2027           2     7
#> # ℹ 23 more rows
#> # ℹ 18 more variables: week_display <chr>, poll_date <chr>, ranked <lgl>,
#> #   team_id <chr>, rank <int>, previous_rank <int>, points <dbl>,
#> #   first_place_votes <int>, trend <chr>, record_summary <chr>, team_uid <chr>,
#> #   team_location <chr>, team_name <chr>, team_nickname <chr>,
#> #   team_abbreviation <chr>, team_color <chr>, team_logo <chr>,
#> #   last_updated <chr>
# }
# \donttest{
  try(espn_wch_rankings())
#> ── WOMENS-COLLEGE-HOCKEY Rankings data from ESPN.com ────── fastRhockey 1.1.0 ──
#> ℹ Data updated: 2026-11-13 21:26:28 UTC
#> # A tibble: 20 × 25
#>    poll_id poll_name          poll_short_name poll_type season season_type  week
#>      <int> <chr>              <chr>           <chr>      <int>       <int> <int>
#>  1   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#>  2   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#>  3   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#>  4   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#>  5   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#>  6   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#>  7   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#>  8   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#>  9   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 10   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 11   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 12   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 13   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 14   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 15   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 16   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 17   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 18   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 19   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> 20   10604 USCHO Women's Poll USCHO Women's … USCHOWOM…   2027           2     8
#> # ℹ 18 more variables: week_display <chr>, poll_date <chr>, ranked <lgl>,
#> #   team_id <chr>, rank <int>, previous_rank <int>, points <dbl>,
#> #   first_place_votes <int>, trend <chr>, record_summary <chr>, team_uid <chr>,
#> #   team_location <chr>, team_name <chr>, team_nickname <chr>,
#> #   team_abbreviation <chr>, team_color <chr>, team_logo <chr>,
#> #   last_updated <chr>
# }