bref_team_roster: *Basketball-Reference Team Roster*

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

Basketball-Reference Team Roster

Description

Get a team's season roster from Basketball-Reference.

No API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_team_roster(team, season = most_recent_nba_season())

Arguments

team	(character required): Basketball-Reference team abbreviation (e.g. BOS, LAL, GSW). Historical franchises use their era code (e.g. NJN, SEA).
season	(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_nba_season().

Value

A hoopR_data tibble with one row per player on the roster:

col_name	types	description
number	character	Jersey number.
player	character	Player name.
pos	character	Position.
height	character	Height.
weight	integer	Weight (lbs).
birth_date	character	Birth date.
years_experience	character	Years of NBA experience (R for rookies).
college	character	College.
team	character	Team abbreviation (echoes the team argument).
season	integer	Season (echoes the season argument).

See Also

Other Basketball-Reference Functions: bref_awards(), bref_draft(), bref_injuries(), bref_player_bios(), bref_player_game_log(), bref_players_stats(), bref_standings(), bref_teams_stats()

Examples

  try(bref_team_roster(team = "BOS", season = 2024))

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