mbb_team_crosswalk: *Get the MBB cross-source team crosswalk*

In hoopR: Access Men's Basketball Play by Play Data

Get the MBB cross-source team crosswalk

Description

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_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_nba_team_crosswalk(), mbb_player_crosswalk(), mbb_schedule_crosswalk()

Examples

  try(mbb_team_crosswalk(season = 2025))

hoopR documentation built on Aug. 25, 2026, 9:07 a.m.