nba_groups
NBA conference, division and subdivision reference.
57 seasons (1971–2027) · 122 assets · 584 KB · last asset written 2026-09-27
Upstream source: the league's membership source and every source's names and ids for its groups (see the build repo).
Season key. the ending year (2025 = 2024-25)
Note. A reference table, not observations. Four tables:
groups(one row per SDV group lineage,{league}:{slug}),group_seasons(each group's name, abbreviation and parent as of that season),group_aliases(every source's ids and names for a group, with validity windows) andteam_group_seasons(each team's subdivision, conference and division by season, one file per season). Historical names come from dated, cited rows: ESPN, stats.ncaa.org and CFBD all show today's names for past seasons. Schema: sdv-reference-dataCONTRACT.md.
Files in this release
| Format | Files | Name pattern |
|---|---|---|
csv |
61 | {dataset}_{season}.csv |
parquet |
61 | {dataset}_{season}.parquet |
This tag carries 4 distinct datasets under one release: nba_team_group_seasons, nba_groups, nba_group_aliases, nba_group_seasons.
Direct download (no auth, no API key):
https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_groups/nba_team_group_seasons_2027.parquet
How to load it
| Surface | Call |
|---|---|
| Python | from sportsdataverse.nba import load_nba_groupsload_nba_groups() |
| Python | from sportsdataverse.nba import load_nba_group_seasonsload_nba_group_seasons() |
| Python | from sportsdataverse.nba import load_nba_group_aliasesload_nba_group_aliases() |
| Python | from sportsdataverse.nba import load_nba_team_group_seasonsload_nba_team_group_seasons(seasons=[2027]) |
| R | hoopR::load_nba_groups() |
| Any | pd.read_parquet("https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_groups/...") — the assets are plain files on a public URL |
How it is produced
- Capture —
sdv-reference-data:fetch()insdv_reference/leagues/nba.pysnapshots the sources intoraw/nba/. - Build —
sdv-reference-data:scripts/pipeline/20_build_tables.sh nba(offline, fromraw/and citedcurated/rows). - Publish —
scripts/pipeline/30_publish_releases.sh nbain sdv-reference-data uploads the assets to this tag.
The code that writes these files:
sdv_reference/leagues/nba.pysdv-reference-data
Automation
No scheduled automation is attached to this tag: it is refreshed on demand.
What depends on it
sportsdataverse-py—sportsdataverse.nba.load_nba_groups()reads this tag directly (API docs).sportsdataverse-py—sportsdataverse.nba.load_nba_group_seasons()reads this tag directly (API docs).sportsdataverse-py—sportsdataverse.nba.load_nba_group_aliases()reads this tag directly (API docs).sportsdataverse-py—sportsdataverse.nba.load_nba_team_group_seasons()reads this tag directly (API docs).hoopR—hoopR::load_nba_groups()reads this tag directly.sportsdataverse-web— reads this tag in application code.
Part of SportsDataverse. Every release in this repository is a public, versioned data asset: the files are stable URLs you can read straight from R, Python, or anything that speaks HTTP. Issues with the data belong on the producing repository listed above; issues with a loader belong on that package's repository.