선수 및 코칭스태프 정보 (Player Info)

GET

/api/playerInfo.do

K리그 구단별 선수 및 코칭스태프(감독, 코치, 기술진 등)의 상세 프로필과 계약 정보를 조회합니다.

요청 파라미터 (Request Parameters)

파라미터명 타입(Size) 필수여부 설명
authKey varchar Y 발급받은 API 인증키
last_update varchar(10) N 최종 업데이트일 (YYYY/MM/DD / 기본값: 1900/01/01)
team_id varchar(3) N 구단 코드 (예: K01)
act_type varchar(1) N 활동구분 (1:현역(기본값), 2:은퇴, 3:해외, 4:대기 등 / 공통코드:37)

응답 필드 상세 (Response Fields)

필드명 데이터 타입 설명 및 비고
[Common] 공통 응답 필드 (JSON Header)
apiNamevarchar(30)호출된 API 명칭 (playerInfo)
resultCode varchar(3) 결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsgvarchar(100)결과 메시지 ("success")
[Profile] 인적 사항 및 소속 정보
PLAYER_IDvarchar(8)관계자 고유 코드 (선수/스태프)
CORP_CDvarchar(3)소속 구단 코드 (예: K01)
TEAM_S_NAMEvarchar(15)소속 구단 약칭
POS_CD / POS_NAMEnumeric(4, 0) / varchar(40)관계자 구분 코드 / 명칭 (선수, 코칭스태프 등 / 공통코드:87)
JOB_CD / JOB_NAMEnumeric(4, 0) / varchar(40)직책 코드 / 명칭 (감독, 코치 등 / 공통코드:12)
NAME / NAME_CHINvarchar(20) / varchar(10)성명 (한글) / 성명 (한자)
NAME_ENG_F / NAME_ENG_Svarchar(50) / varchar(40)영문 성명 (풀네임) / 영문 성명 (숏네임)
PLAYER_NAME_ENGvarchar(50)영문 성명 (표출용)
COUNTRY_CD / COUNTRY_NAMEnumeric(4, 0) / varchar(40)국적 코드 / 명칭 (공통코드:24)
BIRTH_TYPE / BIRTH_TYPE_NAMEnumeric(4, 0) / varchar(40)생일 구분 코드 / 명칭 (양력/음력 등 / 공통코드:55)
BIRTH_DATEvarchar(10)생년월일 (YYYY/MM/DD)
BIRTH_PLACE / BIRTH_PLACE_NAMEnumeric(4, 0) / varchar(40)출신도 코드 / 명칭 (공통코드:28)
[Physical] 신체 조건 및 선수 정보
BACK_NOint등번호 (선수)
POSITION_CODE / POSITION_NAMEnumeric(4, 0) / varchar(40)포지션 코드 / 명칭 (FW, MF, DF, GK / 공통코드:42)
ETC_POSITIONvarchar(10)기타 포지션 (MF, DF 등)
HEIGHT / WEIGHTnumeric(3, 0)신장 (cm) / 체중 (kg)
RUN_TIMEnumeric(3, 1)주력 (초)
BLOOD_TYPE_NAMEvarchar(40)혈액형 (공통코드:53)
JACKET_SIZE / TROUSER_SIZEnumeric(4, 0)상의 / 하의 사이즈 코드 (공통코드:62)
SHOES_SIZE / RUN_SHOES_SIZEvarchar(3)축구화 / 운동화 사이즈
[History] 학력, 병역 및 이력 정보
DRAFT_NOvarchar(15)드래프트 번호
AGENT_IDvarchar(15)대리인 (에이전트 ID)
ARMY_TYPE / ARMY_NAMEnumeric(4, 0) / varchar(40)병역 관계 코드 / 명칭 (공통코드:11)
MIDDLESCHOOL / HIGHSCHOOL / UNIVERSITYSCHOOLvarchar(50)출신 중학교 / 고등학교 / 대학교 명칭
GROUP_TYPE / GROUP_TYPE_NAMEnumeric(4, 0) / varchar(40)최종 학력 구분 코드 / 명칭 (공통코드:3)
GROUP_CODE / GROUP_CODE_NAMEnumeric(4, 0) / varchar(50)최종 출신 학교 코드 / 명칭
GRADUATE_TYPE / GRADUATE_NAMEnumeric(4, 0) / varchar(40)졸업 구분 코드 / 명칭 (공통코드:27)
[Contract] 활동 상태 및 계약 정보
ACT_TYPE / ACT_TYPE_NAMEnumeric(4, 0) / varchar(40)활동 구분 코드 / 명칭 (현역 등 / 공통코드:37)
ACT_STATE / ACT_STATE_NAMEnumeric(4, 0) / varchar(40)공시 구분 코드 / 명칭 (선수등록 등 / 공통코드:5)
AFC_YNvarchar(1)아시안쿼터 여부 ('1': 해당, '0': 미해당)
P_COACH_YNvarchar(1)플레잉코치 여부 ('Y' / 'N')
CONTACT_SDATE / CONTACT_EDATEvarchar(10)계약 시작일 / 종료일 (YYYY/MM/DD)
LASTUPDATEvarchar(10)정보 최종 업데이트 일시 (YYYY/MM/DD)

JSON 응답 샘플 (울산 HD 코치 및 선수) 

{
    "response": {
        "apiName": "playerInfo",
        "resultCode": "00",
        "list": [
            {
                "PLAYER_ID": "20260053",
                "CORP_CD": "K01",
                "TEAM_S_NAME": "울산",
                "POS_CD": 3,
                "POS_NAME": "코칭 스태프",
                "JOB_CD": 8,
                "JOB_NAME": "코치",
                "NAME": "이길동",
                "NAME_CHIN": "",
                "NAME_ENG_F": "GilDong Lee",
                "NAME_ENG_S": "",
                "PLAYER_NAME_ENG": "GilDong Lee",
                "COUNTRY_CD": 2,
                "COUNTRY_NAME": "일본",
                "RUN_TIME": 0.0,
                "DRAFT_NO": "",
                "BACK_NO": 0,
                "POSITION_CODE": 0,
                "ETC_POSITION": "",
                "AGENT_ID": "",
                "BIRTH_TYPE": 1,
                "BIRTH_TYPE_NAME": "양력",
                "BIRTH_DATE": "1973/10/10",
                "ARMY_TYPE": 0,
                "BIRTH_PLACE": 0,
                "GROUP_TYPE": 0,
                "GROUP_CODE": 0,
                "GRADUATE_TYPE": 0,
                "JACKET_SIZE": 0,
                "TROUSER_SIZE": 0,
                "SHOES_SIZE": "",
                "RUN_SHOES_SIZE": "",
                "ACT_TYPE": 1,
                "ACT_TYPE_NAME": "현역",
                "AFC_YN": "0",
                "CONTACT_SDATE": "2026/01/01",
                "CONTACT_EDATE": "2026/12/31",
                "P_COACH_YN": "N",
                "LASTUPDATE": "2026/02/10"
            },
            {
                "PLAYER_ID": "20050095",
                "CORP_CD": "K01",
                "TEAM_S_NAME": "울산",
                "POS_CD": 1,
                "POS_NAME": "선수",
                "JOB_CD": 0,
                "JOB_NAME": "",
                "NAME": "홍길동",
                "NAME_CHIN": "",
                "NAME_ENG_F": "GilDong Hong",
                "NAME_ENG_S": "",
                "PLAYER_NAME_ENG": "GilDong Hong",
                "COUNTRY_CD": 1,
                "COUNTRY_NAME": "한국",
                "RUN_TIME": 12.0,
                "DRAFT_NO": "",
                "BACK_NO": 5,
                "POSITION_CODE": 2,
                "POSITION_NAME": "DF",
                "ETC_POSITION": "",
                "AGENT_ID": "",
                "BIRTH_TYPE": 1,
                "BIRTH_TYPE_NAME": "양력",
                "BIRTH_DATE": "2000/12/31",
                "ARMY_TYPE": 1,
                "ARMY_NAME": "면제",
                "BIRTH_PLACE": 2013,
                "GROUP_TYPE": 5,
                "GROUP_NAME": "대학교",
                "GROUP_CODE": 4,
                "GRADUATE_TYPE": 2,
                "GRADUATE_NAME": "졸업",
                "JACKET_SIZE": 0,
                "TROUSER_SIZE": 0,
                "SHOES_SIZE": "",
                "RUN_SHOES_SIZE": "",
                "ACT_TYPE": 1,
                "ACT_TYPE_NAME": "현역",
                "ACT_STATE": 1,
                "ACT_STATE_NAME": "선수등록",
                "AFC_YN": "0",
                "CONTACT_SDATE": "2026/01/01",
                "CONTACT_EDATE": "2026/12/31",
                "P_COACH_YN": "N",
                "MIDDLESCHOOL": "왜관중",
                "HIGHSCHOOL": "대구공고",
                "UNIVERSITYSCHOOL": "중앙대",
                "GROUP_TYPE_NAME": "대학교",
                "GROUP_CODE_NAME": "중앙대",
                "LASTUPDATE": "2026/02/10"
            }
        ],
        "resultMsg": "success"
    }
}

호출 샘플 소스 (Sample Code)

Auth: Header or QueryString
인증 로드맵: 현재 authKey 기반 인증을 지원하며, 2027년부터 표준 Bearer Token 인증 체계로 통합 확장될 예정입니다. 
OkHttpClient client = new OkHttpClient();

// [방법 1] Query String 방식 (모든 파라미터 URL 포함)
String url1 = "https://api.kleague.com/api/playerInfo.do?authKey=YOUR_API_KEY&team_id=K01&act_type=1&last_update=2026/01/01";
Request request1 = new Request.Builder().url(url1).get().build();

// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/playerInfo.do?team_id=K01&act_type=1&last_update=2026/01/01";
Request request2 = new Request.Builder()
  .url(url2)
  .addHeader("authKey", "YOUR_API_KEY") 
  .build();

// [방법 3] Bearer Token 방식 (2027년 지원 예정)
Request request3 = new Request.Builder()
  .url(url2)
  .addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN") 
  .build();
import requests

url = "https://api.kleague.com/api/playerInfo.do"
params = { 
    "team_id": "K01", 
    "act_type": "1",
    "last_update": "2026/01/01" 
}

# [방법 1] Query String 방식
response1 = requests.get(url, params={**params, "authKey": "YOUR_API_KEY"})

# [방법 2] Header 인증 방식 (현재 추천)
headers2 = { "authKey": "YOUR_API_KEY" }
response2 = requests.get(url, headers=headers2, params=params)

# [방법 3] Bearer Token 방식 (2027년 도입 예정)
# headers3 = { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
# response3 = requests.get(url, headers=headers3, params=params)
const url = 'https://api.kleague.com/api/playerInfo.do';
const params = { 
    team_id: 'K01', 
    act_type: '1', 
    last_update: '2026/01/01' 
};

// [방법 1] Query String 방식
axios.get(url, { params: { ...params, authKey: 'YOUR_API_KEY' } });

// [방법 2] Header 방식 (현재 권장)
axios.get(url, {
    params: params,
    headers: { 'authKey': 'YOUR_API_KEY' }
});

// [방법 3] Bearer 방식 (2027년 로드맵 대비)
// axios.get(url, { params: params, headers: { 'Authorization': 'Bearer YOUR_TOKEN' } });