Skip to contents

Season player totals of one competition (every player with at least one game).

Endpoint: GET https://api.kbl.or.kr/leagues/{season}/stats/players

Usage

kbl_player_totals(season, division = "kbl", game_code = "01")

Arguments

season

Season END year (2026 = 2025-26; the inaugural 1997 season is 1997, the latest 2027). kbl_runtime maps it to the KBL seasonCode (47 = 2025-26).

division

'kbl' (the KBL itself, the default) or 'd_league' (the KBL D-League reserve league, seasonGrade 2, which has its own season codes; it starts with the 2009 summer edition).

game_code

Competition inside the season, two digits: '01' regular season (default; the first stage of a D-League edition), '03' playoffs, '04' championship final, '07' EASL, '08' D-League stage 2, '10' All-Star, '11'/'13' cups, '14' Open Match Day. Only '01' was probed live.

Value

A hoopR_data tibble: Season player totals of one competition (every player with at least one game). The columns are always these, in this order (sportsdataverse-py kbl_player_totals); an empty valid answer raises hoopR_no_data, a valid body with no rows for this frame is a zero-row tibble:

col_nametypedescription
seasonintegerSeason END year (2026 = 2025-26), derived from season_code through the crosswalk (kbl_codes.SEASONS).
season_codeintegerKBL season code: one sequential number over every season and D-League edition (47 = 2025-26, 48 = the 2025 D-League).
game_codecharacterCompetition inside the season, two digits: 01 regular season, 03 playoffs, 04 final, 07 EASL, 08 D-League stage 2, 10 All-Star, 11/13 cups, 14 Open Match Day.
glkeycharacterCompetition key S{seasonCode}G{gameCode} (e.g. S47G01 = 2025-26 regular season): the id of the season routes.
pcodecharacterKBL player code (six-digit string).
player_namecharacterPlayer name in Korean (foreign players in Hangul transliteration).
player_name_encharacterPlayer name in English / romanized (sometimes Hangul for former players).
team_codecharacterKBL team code (2-digit string, e.g. '50' = Changwon LG). Joins to /common/teamList teamCode, game tcodeH/tcodeA, t in text-cast. Not stable across ownership changes: the Anyang club is '40' (SBS) in 1997-98 and '70' today. D-League sides have their own codes (teamCodeD).
team_namecharacterTeam short name (Korean, e.g. Changwon LG), as it was at the time. English names: /common/teamList teamNameEn / teamNameFullEn, joined on the team code.
back_numcharacterJersey number (string).
poscharacterPosition code (string): C center, FD forward, GD guard, FC forward-center, GF guard-forward; table in the returns md.
player_flagcharacterPlayer type (string): '0' domestic, '1' foreign import, '2' Asian-quota player.
game_countintegerGames played (this season or competition).
start_countintegerMeaning unverified: up to 4 x gameCount in every sampled row, so probably quarters started.
scoreintegerPoints. Season total for the competition (glkey).
fgintegerTwo-point field goals made, dunks included: 201 + 207 rows (score = 2fg + 3threep + ft holds on every sampled box). Season total for the competition (glkey).
fg_aintegerTwo-point field-goal attempts, made + missed, dunks included: 201 + 202 + 207 + 208 rows (checked per team on S47G01N49). Season total for the competition (glkey).
fgtintegerField goals made, two- and three-point (fg + threep). Season total for the competition (glkey).
fgt_aintegerField-goal attempts, two- and three-point (fgA + threepA). Season total for the competition (glkey).
threepintegerThree-point field goals made (action 205). Season total for the competition (glkey).
threep_aintegerThree-point attempts, made + missed (205 + 206). Season total for the competition (glkey).
ftintegerFree throws made (action 203). Season total for the competition (glkey).
ft_aintegerFree-throw attempts, made + missed (203 + 204). Season total for the competition (glkey).
dkintegerDunks made (action 207); included in fg. Season total for the competition (glkey).
dk_aintegerDunk attempts (made + missed, actions 207 + 208). Season total for the competition (glkey).
rbintegerTotal rebounds (offr + defr; team rebounds are teamR). Season total for the competition (glkey).
offrintegerOffensive rebounds (action 209). Season total for the competition (glkey).
defrintegerDefensive rebounds (action 210). Season total for the competition (glkey).
astintegerAssists (action 211). Season total for the competition (glkey).
stlintegerSteals (action 212). Season total for the competition (glkey).
bsintegerBlocked shots (action 213). Season total for the competition (glkey).
tointegerTurnovers (action 214). Season total for the competition (glkey).
foulintegerPersonal fouls (wft + woft). Season total for the competition (glkey).
wftintegerFouls that awarded free throws (action 215). Season total for the competition (glkey).
woftintegerFouls that awarded no free throws (action 216). Season total for the competition (glkey).
ppintegerField goals made in the paint. Season total for the competition (glkey).
pp_aintegerField-goal attempts in the paint. Season total for the competition (glkey).
pscoreintegerPoints in the paint (2 * pp). Season total for the competition (glkey).
sastintegerScreen assists (action 226; tracked in recent seasons only, 0 before). Season total for the competition (glkey).
dflintegerDeflections (action 227; tracked in recent seasons only, 0 before). Season total for the competition (glkey).
gdintegerGood-defense plays (action 221). Season total for the competition (glkey).
idfintegerIllegal-defense violations (action 219; an early-KBL rule, so non-zero only in old seasons). Season total for the competition (glkey).
fbintegerFast breaks credited to the player (action 217 rows that name a player, as in 1997-98); 0 in recent seasons, where fast breaks are team rows (tfb). Season total for the competition (glkey).
efintegerMeaning unverified (0 in every game sample; non-zero in some season totals). Season total for the competition (glkey).
tfintegerProbably technical fouls (unverified; 0 in most rows). Season total for the competition (glkey).
inoutintegerTimes the player entered the game, the start included (checked on the 2025-26 sample game); a team row sums its players. Season total for the competition (glkey).
inout1integerTimes the player was substituted out before the end (checked on the 2025-26 sample game); a team row sums its players. Season total for the competition (glkey).
play_minintegerMinutes of playing time; add playSec seconds. Season total for the competition (glkey).
play_secintegerSeconds part of the playing time (0-59), added to playMin. Season total for the competition (glkey).
fouloutintegerMeaning unverified: values exceed games played (70 for a 40-game player with 74 fouls); possibly fouls drawn, as this route has no fo.
minutes_playeddoublePlaying time in minutes (play_min + play_sec / 60), derived.

Details

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

 kbl_player_totals(season = 2025)