Skip to contents

The site's player directory (current and former players) with their current or last team.

Endpoint: GET https://api.kbl.or.kr/players

Usage

kbl_players()

Value

A hoopR_data tibble: The site's player directory (current and former players) with their current or last team. The columns are always these, in this order (sportsdataverse-py kbl_players); an empty valid answer raises hoopR_no_data, a valid body with no rows for this frame is a zero-row tibble:

col_nametypedescription
pcodecharacterKBL player code (6-digit string). Joins to pcode on every route and to playerNo in /league/round-mvp.
player_namecharacterPlayer name in Korean (foreign players in Hangul transliteration).
player_name_encharacterPlayer name in English / romanized (sometimes Hangul for former players).
team_codecharacterTeam code of the player's current or last team. KBL 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_namecharacterShort name (Korean) of the player's current or last team.
team_name_encharacterCurrent team short name in English (e.g. 'JUNG KWAN JANG').
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.
last_careercharacterMeaning unverified: a season-code-like number, 'A' or ”.

Details

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

Examples

# \donttest{
  try(kbl_players())
#> ── KBL Players from api.kbl.or.kr ─────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:31:01 UTC
#> # A tibble: 1,497 × 10
#>    pcode  player_name player_name_en   team_code team_name team_name_en back_num
#>    <chr>  <chr>       <chr>            <chr>     <chr>     <chr>        <chr>   
#>  1 290801 CJ 레슬리   CJ 레슬리        70        안양 KGC  JUNG KWAN J… "15"    
#>  2 235041 G.J 헌터    Gray Hunter      35        수원삼성  SAMSUNG      "7"     
#>  3 210070 R.F. 바셋   R.F. Bassette    60        전주KCC   KCC          "5"     
#>  4 290237 가넷 톰슨   Garnett Thompson 30        대구오리온스…… KBL          "5"     
#>  5 650016 가이 루커   Guy Terrance. R… 70        안양KT&G  JUNG KWAN J… "22"    
#>  6 290414 강권희      강권희           06        부산KT    KT           "35"    
#>  7 225032 강기중      Kang Ki Joong    16        원주동부  DB           "2"     
#>  8 245042 강대협      Kang Dae Hyup    65        인천전자랜드…… KBL          "10"    
#>  9 250058 강동희      Kang Dong Hee    16        원주동부  DB           ""      
#> 10 291192 강바일      KANG B I         35        서울 삼성 SAMSUNG      "19"    
#> # ℹ 1,487 more rows
#> # ℹ 3 more variables: pos <chr>, player_flag <chr>, last_career <chr>
# }