Skip to contents

Returns franchise-level metadata for a men's college basketball program. Franchise IDs are stable across program reorganization or rebrands.

Returns franchise-level metadata for an NBA franchise. Franchise IDs are stable across relocations and rebrands - useful for tracking franchise history independent of current team identity.

Usage

espn_mbb_franchise(franchise_id, ...)

espn_nba_franchise(franchise_id, ...)

Arguments

franchise_id

ESPN franchise identifier (character or numeric).

...

Additional arguments; currently unused.

Value

A hoopR_data tibble with one row per franchise.

col_nametypesdescription
idcharacterESPN franchise identifier.
uidcharacterESPN UID string.
slugcharacterURL-safe identifier.
locationcharacterFranchise location.
namecharacterFranchise name.
nicknamecharacterCommon nickname.
abbreviationcharacterShort abbreviation.
display_namecharacterFull display name.
short_display_namecharacterShort display name.
colorcharacterPrimary color (hex, no leading '#').
is_activelogicalWhether franchise is currently active.
leaguecharacterLeague slug.
logocharacterPrimary logo URL.
logo_darkcharacterDark-mode logo URL.
venue_refcharacter$ref to franchise's primary venue.
team_refcharacter$ref to the current team for franchise.

A hoopR_data tibble with one row per franchise.

col_nametypesdescription
idcharacterESPN franchise identifier.
uidcharacterESPN UID string.
slugcharacterURL-safe identifier.
locationcharacterFranchise location.
namecharacterFranchise name.
nicknamecharacterCommon nickname (often same as name).
abbreviationcharacterShort abbreviation.
display_namecharacterFull display name.
short_display_namecharacterShort display name.
colorcharacterPrimary color (hex, no leading '#').
is_activelogicalWhether franchise is currently active.
leaguecharacterLeague slug ("nba").
logocharacterPrimary logo URL.
logo_darkcharacterDark-mode logo URL.
venue_refcharacter$ref to franchise's primary venue.
team_refcharacter$ref to the current team for franchise.

See also

family_espn_mbb lists every function in this family.

family_espn_nba lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_franchise(franchise_id = 150)
#> ── ESPN MENS-COLLEGE-BASKETBALL Franchise from ESPN.com ───────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:11:55 UTC
#> # A tibble: 1 × 16
#>   id    uid             slug   location name  nickname abbreviation display_name
#>   <chr> <chr>           <chr>  <chr>    <chr> <chr>    <chr>        <chr>       
#> 1 150   s:40~l:41~f:150 duke-… Duke     Blue… Duke     DUKE         Duke Blue D…
#> # ℹ 8 more variables: short_display_name <chr>, color <chr>, is_active <lgl>,
#> #   league <chr>, logo <chr>, logo_dark <chr>, venue_ref <chr>, team_ref <chr>
# }
# \donttest{
  espn_nba_franchise(franchise_id = 13)
#> ── ESPN NBA Franchise from ESPN.com ───────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:11:56 UTC
#> # A tibble: 1 × 16
#>   id    uid            slug    location name  nickname abbreviation display_name
#>   <chr> <chr>          <chr>   <chr>    <chr> <lgl>    <chr>        <chr>       
#> 1 13    s:40~l:46~f:13 los-an… Los Ang… Lake… NA       LAL          Los Angeles…
#> # ℹ 8 more variables: short_display_name <chr>, color <chr>, is_active <lgl>,
#> #   league <chr>, logo <chr>, logo_dark <chr>, venue_ref <chr>, team_ref <chr>
# }