Skip to contents

Build a wide, one-row-per-team-per-season crosswalk linking ESPN, Fox Sports (Bifrost), Bart Torvik (barttorvik.com), and KenPom (hoopR::teams_links bundled data) men's college basketball team identities, keyed on espn_team_id. Yahoo columns are NA placeholders. ESPN is deduped by team_id (first occurrence kept).

Fox is joined on the full normalized mascot name (with a curated alias bridge for cases where Fox and ESPN differ). Torvik and KenPom are each joined on the normalized school/location name after a curated alias pass for common divergences (e.g. "UConn" / "Connecticut", "Ole Miss" / "Mississippi", "LIU" / "Long Island University"). No authentication is required for any source — Fox is the only network call (slow, ~60 s); Torvik is a single CSV; KenPom uses the bundled teams_links object.

Usage

mbb_team_crosswalk(season = most_recent_mbb_season(), fox = NULL)

Arguments

season

Season year (4-digit, e.g. 2025). Defaults to most_recent_mbb_season().

fox

An already-fetched fox_mbb_teams_all() frame, or NULL (default) to fetch live. Pass a pre-fetched frame to avoid the ~60-second Fox enumeration when calling repeatedly.

Value

A hoopR_data tibble, one row per ESPN team:

col_nametypesdescription
seasonintegerSeason year.
espn_team_idintegerESPN team id (canonical key).
espn_abbreviationcharacterESPN abbreviation.
espn_display_namecharacterESPN display name (school + mascot).
espn_short_namecharacterESPN short name.
espn_locationcharacterESPN school/location only.
espn_mascotcharacterESPN mascot/nickname.
espn_conferencecharacterESPN conference name.
fox_team_idcharacterFox Bifrost team id (NA if unmatched).
fox_team_namecharacterFox team name (NA if unmatched).
fox_sectioncharacterFox conference/section label (NA if unmatched).
bart_teamcharacterTorvik team name (NA if unmatched).
bart_confcharacterTorvik conference abbreviation (NA if unmatched).
kp_teamcharacterKenPom team name (NA if unmatched).
kp_confcharacterKenPom conference abbreviation (NA if unmatched).
yahoo_team_idcharacterYahoo team id (NA placeholder).
yahoo_team_namecharacterYahoo team name (NA placeholder).
fox_match_confidencenumeric1 for matched, NA for unmatched.
bart_match_confidencenumeric1 for matched, NA for unmatched.
kp_match_confidencenumeric1 for matched, NA for unmatched.
match_methodcharacterCombination of matched sources, e.g.
"fox+bart+kp" / "fox+bart" / "bart+kp" /
"fox_only" / "bart_only" / "kp_only" /
"espn_only".

Examples

# \donttest{
  try(mbb_team_crosswalk(season = 2025))
#>  2026-08-27 17:51:18.327342: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:19.255019: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:19.622561: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:19.684618: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:19.728101: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:19.858797: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:19.946935: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:19.989695: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.031138: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.073578: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.116349: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.158688: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.201887: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.243397: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.285051: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.326849: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.369268: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.411575: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.453989: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.496545: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.538677: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.581528: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.62393: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.666529: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.709115: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.753355: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.79755: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-08-27 17:51:20.8405: no Fox CBK teams data available!
#>  Error: The API returned an error
#> ── MBB team crosswalk (ESPN / Fox / Torvik / KenPom) ──────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:51:20 UTC
#> # A tibble: 366 × 21
#>    season espn_team_id espn_abbreviation espn_display_name       espn_short_name
#>     <int>        <int> <chr>             <chr>                   <chr>          
#>  1   2025         2000 ACU               Abilene Christian Wild… Abilene Chrstn 
#>  2   2025         2005 AF                Air Force Falcons       Air Force      
#>  3   2025         2006 AKR               Akron Zips              Akron          
#>  4   2025         2010 AAMU              Alabama A&M Bulldogs    Alabama A&M    
#>  5   2025          333 ALA               Alabama Crimson Tide    Alabama        
#>  6   2025         2011 ALST              Alabama State Hornets   Alabama St     
#>  7   2025         2016 ALCN              Alcorn State Braves     Alcorn St      
#>  8   2025           44 AMER              American University Ea… American       
#>  9   2025         2026 APP               App State Mountaineers  App State      
#> 10   2025            9 ASU               Arizona State Sun Devi… Arizona St     
#> # ℹ 356 more rows
#> # ℹ 16 more variables: espn_location <chr>, espn_mascot <chr>,
#> #   espn_conference <chr>, fox_team_id <chr>, fox_team_name <chr>,
#> #   fox_section <chr>, bart_team <chr>, bart_conf <chr>, kp_team <chr>,
#> #   kp_conf <chr>, yahoo_team_id <chr>, yahoo_team_name <chr>,
#> #   fox_match_confidence <dbl>, bart_match_confidence <dbl>,
#> #   kp_match_confidence <dbl>, match_method <chr>
# }