Skip to contents

Player profile by season-player id: bio, position, club and previous clubs.

Endpoint: GET https://api.basketball-bundesliga.de/season-players/{season_player_id} (DBBL: the same route on https://api-1.dbbl.scb.world).

Usage

scb_season_player(season_player_id, league = "bbl")

Arguments

season_player_id

(required) Season-player id (season_player_id in a box score, an action or scb_season_players): one player's engagement with one club.

league

(default "bbl") League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Value

A hoopR_data tibble: Player profile by season-player id: bio, position, club and previous clubs. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py scb_season_player):

col_nametypedescription
leaguecharacterLeague the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season_player_idcharacterSeason-player id: one player's engagement with one club (kept across seasons while he stays, new after a move). Joins box-score lines, actions, records and scb_season_player.
real_player_idintegerGlobal person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
active_season_player_idcharacterThe player's current season-player id (his latest club engagement). Joins to /season-players/{seasonPlayerId}.
first_namecharacterPlayer's given name.
last_namecharacterPlayer's family name.
birth_datecharacterDate of birth, YYYY-MM-DD.
positioncharacterPosition: POINT_GUARD, SHOOTING_GUARD, SMALL_FORWARD, POWER_FORWARD, CENTER.
shirt_numbercharacterJersey number. A number or a numeric string across rows.
heightdoubleHeight in metres (float32 noise: 1.77 arrives as 1.7699999809265137).
weightintegerWeight in kg; 0 when unknown.
nationalitiescharacterNationalities, ISO 3166-1 alpha-2 codes.
is_all_starlogicalAll-Star selection flag.
is_younglogicalYoung-player flag (German-trained youth rule; inferred).
has_changed_teamslogicalMoved clubs during the season.
bbl_games_playedintegerCareer league games played (BBL host; 0 on DBBL).
team_idcharacterClub id, a string; equal to season_team_id in every sample. Joins to scb_team and scb_season_teams.
team_namecharacterTeam name as listed that season (sponsor names included).
previous_teamscharacterFormer clubs, free text (German names).
season_idscharacterSeasons (start years) with this player or club.

Details

Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in scb_seasons().

 scb_season_player(season_player_id = "56414")