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 tomost_recent_mbb_season().- fox
An already-fetched
fox_mbb_teams_all()frame, orNULL(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_name | types | description |
| season | integer | Season year. |
| espn_team_id | integer | ESPN team id (canonical key). |
| espn_abbreviation | character | ESPN abbreviation. |
| espn_display_name | character | ESPN display name (school + mascot). |
| espn_short_name | character | ESPN short name. |
| espn_location | character | ESPN school/location only. |
| espn_mascot | character | ESPN mascot/nickname. |
| espn_conference | character | ESPN conference name. |
| fox_team_id | character | Fox Bifrost team id (NA if unmatched). |
| fox_team_name | character | Fox team name (NA if unmatched). |
| fox_section | character | Fox conference/section label (NA if unmatched). |
| bart_team | character | Torvik team name (NA if unmatched). |
| bart_conf | character | Torvik conference abbreviation (NA if unmatched). |
| kp_team | character | KenPom team name (NA if unmatched). |
| kp_conf | character | KenPom conference abbreviation (NA if unmatched). |
| yahoo_team_id | character | Yahoo team id (NA placeholder). |
| yahoo_team_name | character | Yahoo team name (NA placeholder). |
| fox_match_confidence | numeric | 1 for matched, NA for unmatched. |
| bart_match_confidence | numeric | 1 for matched, NA for unmatched. |
| kp_match_confidence | numeric | 1 for matched, NA for unmatched. |
| match_method | character | Combination of matched sources, e.g. |
| "fox+bart+kp" / "fox+bart" / "bart+kp" / | ||
| "fox_only" / "bart_only" / "kp_only" / | ||
| "espn_only". |
See also
Other MBB Crosswalk Functions:
load_mbb_player_crosswalk(),
load_mbb_schedule_crosswalk(),
load_mbb_team_crosswalk(),
mbb_player_crosswalk(),
mbb_schedule_crosswalk()
Examples
# \donttest{
try(mbb_team_crosswalk(season = 2025))
#> ✖ 2026-06-30 19:46:18.576146: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:21.533408: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:22.485332: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:22.996137: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:23.385749: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:23.700327: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:23.887405: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:24.313457: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:24.693918: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:24.884419: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:25.303418: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:25.509823: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:26.126966: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:26.623827: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:26.854191: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:27.801591: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:27.859988: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:27.913098: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:28.119985: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:28.399724: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:28.622772: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:29.021805: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:29.076527: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:29.290577: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:29.720747: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:30.030984: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:30.589404: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:30.775954: no Fox CBK teams data available!
#> ✖ Error: The API returned an error
#> ✖ 2026-06-30 19:46:31.227447: 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-30 19:46:31 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>
# }