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-06-13 07:27:32.366167: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:32.914318: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.09793: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.275069: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.35327: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.403146: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.427227: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.45131: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.477059: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.501493: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.526058: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.550338: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.57444: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.598277: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.62554: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.6546: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.678183: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.701859: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.726037: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.749908: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.773534: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.797155: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.821223: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.845228: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.869203: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.89292: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.920489: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.944298: no Fox CBK teams data available!
#>  Error: The API returned an error
#>  2026-06-13 07:27:33.968032: 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-06-13 07:27:34 UTC
#> # A tibble: 362 × 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     
#> # ℹ 352 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>
# }