선수 기록 순위 (Player Rank Stats)
GET
/api/playerRank.do
시즌별/대회별 선수의 종합 기록(출장, 득점, 도움 등) 및 항목별 순위/비율 데이터를 제공합니다.
요청 파라미터 (Request Parameters)
| 파라미터명 | 타입(Size) | 필수여부 | 설명 |
|---|---|---|---|
| authKey | varchar |
Y | API 인증키 (Header 전송 권장) |
| meet_year | varchar(4) |
Y | 대회년도 (예: 2026) |
| meet_seq | varchar(2) |
Y | 대회순번 (예: 1) |
| seasonYN | varchar(1) |
N | 시즌 통합 조회 여부 ('Y': 시즌 전체 합산 1행 표출 / 'N': 이적 시 소속팀별 분리 표출 / 기본값 'Y') |
| excludingPO | varchar(1) |
N | K리그2 플레이오프(PO) 기록 제외 여부 ('Y': 제외, 'N': 포함 - 기본값) |
시즌 기록 합산(seasonYN) 및 구단 정보 표출 안내:
-
seasonYN = 'Y'(시즌 통합 조회 - 기본값):
시즌 중 이적 선수의 기록을 단일 행으로 합산하여 제공합니다.- 현재 시즌 조회 시: 선수 프로필 마스터 기준 `현 소속팀` 명칭 표출
- 과거 시즌 조회 시: 해당 시즌 `최종 출전 당시 소속팀` 명칭 표출
-
seasonYN = 'N'(팀별 분리 조회):
시즌 중 이적한 경우, 이적 전/후 각 소속팀별 출전 기록이 개별 행으로 분리되어 해당 당시 팀명으로 표출됩니다.
응답 필드 상세 명세 (Response Fields)
| 필드명 | 데이터 타입 | 설명 및 비고 |
|---|---|---|
| [Common] 공통 응답 필드 (JSON Header) | ||
| meet_year | varchar(4) | 요청한 대회년도 |
| meet_seq | varchar(2) | 요청한 대회순번 |
| apiName | varchar(30) | 호출된 API 명칭 (playerRank) |
| resultCode | varchar(3) |
결과 코드 (00: 성공, 그 외 에러는 API 개요 참조) |
| resultMsg | varchar(100) | 결과 메시지 ("success") |
| [Section 1] 선수 및 소속 기본 정보 | ||
| MEET_YEAR / MEET_SEQ | varchar(4) / numeric(2,0) | 대회년도 / 대회순번 |
| TEAM_ID / TEAM_NAME / TEAM_NAME_ENG | varchar(3) / varchar(15) / varchar(30) | 구단 코드 / 구단명 (약칭) / 구단 영문명 ※ 현재 시즌: 현 소속팀 표출 / 과거 시즌: 해당 시즌 출전 당시 최근 소속팀 표출 |
| PLAYER_ID / PLAYER_NAME | varchar(8) / varchar(20) | 선수 코드 / 선수 성명 |
| [Section 2] 출장 및 세부 기술 수치 누적 기록 (Count Stats) | ||
| WORK_QTY / WORK_TIME | int | 출장 경기 수 / 총 출장 시간 (분) |
| GOAL_QTY / ASSIST_QTY / ATTACK_POINT | int | 총 득점 수 / 총 도움 수 / 총 공격포인트 합계 (득점 + 도움) |
| GOAL_PER_WORK / GOAL_PER_ST | numeric(10,5) | 출전당 평균 득점 비율 / 슈팅당 평균 득점 비율 |
| ST_QTY / ST_VALID_QTY | int | 총 슈팅 수 / 총 유효 슈팅 수 |
| CK_QTY / FO_QTY / FS_QTY / OS_QTY | int | 코너킥 수 / 파울 수 (모든 파울) / 피파울 수 / 오프사이드 수 |
| PK_Y_QTY / PK_N_QTY / PK_QTY | int | PK 득점 성공 수 / PK 실축 수 / PK 시도 수 |
| CHANGE_QTY / CHANGE_I_QTY / CHANGE_O_QTY | int | 총 교체 수 / 교체 IN 수 / 교체 OUT 수 |
| WARN_QTY / EXIT_QTY / SELF_GOAL_QTY | int | 경고 수 / 퇴장 수 / 자책골 수 |
| GK_QTY / LOSS_QTY | int | 골킥 시도 수 / 총 실점 수 (골키퍼 전용) |
| TK_L_MISS / TK_R_MISS / TK_L_GOAL / TK_R_GOAL | int | 승부차기 좌측 실축 / 우측 실축 / 좌측 성공 / 우측 성공 수 |
| MOM_QTY / BEST11_QTY / PLAYER_POINT | int / numeric(10,5) | MOM 선정 횟수 / BEST11 선정 횟수 / 평균 평점 |
| [Section 3] 전체 선수 대비 순위 및 비율 정보 (Rating) | ||
| WORK_QTY_RATING / GOAL_QTY_RATING | int | 출전 경기수 순위 / 득점 순위 |
| GOAL_PER_WORK_RATING / GOAL_PER_ST_RATING | int | 출전당 득점 비율 순위 / 슈팅당 득점 비율 순위 |
| ASSIST_QTY_RATING / ATTACK_POINT_RATING | int | 도움 순위 / 공격포인트 순위 |
| ST_QTY_RATING / CK_QTY_RATING / PK_QTY_RATING | int | 슈팅 순위 / 코너킥 순위 / PK 순위 |
| OS_QTY_RATING / FO_QTY_RATING / FS_QTY_RATING | int | 오프사이드 순위 / 파울 순위 / 피파울 순위 |
| WARN_QTY_RATING / EXIT_QTY_RATING | int | 경고 순위 / 퇴장 순위 |
| CHANGE_QTY_RATING / CHANGE_I_QTY_RATING / CHANGE_O_QTY_RATING | int | 교체 순위 / 교체 IN 순위 / 교체 OUT 순위 |
| GK_QTY_RATING / LOSS_QTY_RATING | int | 골킥 순위 / 실점 순위 |
| MOM_QTY_RATING / BEST11_QTY_RATING | int | MOM 선정 순위 / BEST11 선정 순위 |
JSON 응답 샘플 (Player Rank Stats)
{
"response": {
"meet_year": "2026",
"apiName": "playerRank",
"resultCode": "00",
"meet_seq": "1",
"list": [
{
"MEET_YEAR": "2026",
"MEET_SEQ": 1,
"TEAM_ID": "K05",
"TEAM_NAME": "전북",
"TEAM_NAME_ENG": "JEONBUK",
"PLAYER_ID": "20260058",
"PLAYER_NAME": "김주형",
"WORK_QTY": 0,
"GOAL_QTY": 0,
"GOAL_PER_WORK": 0.00000,
"GOAL_PER_ST": 0.00000,
"ASSIST_QTY": 0,
"ATTACK_POINT": 0,
"GK_QTY": 0,
"CK_QTY": 0,
"FO_QTY": 0,
"OS_QTY": 0,
"ST_QTY": 0,
"CHANGE_I_QTY": 0,
"CHANGE_O_QTY": 0,
"CHANGE_QTY": 0,
"PK_Y_QTY": 0,
"PK_N_QTY": 0,
"PK_QTY": 0,
"LOSS_QTY": 0,
"WARN_QTY": 0,
"EXIT_QTY": 0,
"SELF_GOAL_QTY": 0,
"WORK_TIME": 0,
"TK_L_MISS": 0,
"TK_R_MISS": 0,
"TK_L_GOAL": 0,
"TK_R_GOAL": 0,
"ST_VALID_QTY": 0,
"FS_QTY": 0,
"PLAYER_POINT": 0.00000,
"MOM_QTY": 0,
"BEST11_QTY": 0,
"WORK_QTY_RATING": 340,
"GOAL_QTY_RATING": 132,
"GOAL_PER_WORK_RATING": 132,
"GOAL_PER_ST_RATING": 132,
"LOSS_QTY_RATING": 21,
"ATTACK_POINT_RATING": 180,
"ST_QTY_RATING": 266,
"ASSIST_QTY_RATING": 123,
"CK_QTY_RATING": 92,
"PK_QTY_RATING": 20,
"OS_QTY_RATING": 139,
"FO_QTY_RATING": 298,
"WARN_QTY_RATING": 223,
"EXIT_QTY_RATING": 19,
"CHANGE_QTY_RATING": 321,
"CHANGE_I_QTY_RATING": 287,
"CHANGE_O_QTY_RATING": 262,
"GK_QTY_RATING": 1,
"MOM_QTY_RATING": 90,
"BEST11_QTY_RATING": 128
}
],
"resultMsg": "success"
}
}
호출 샘플 소스 (Sample Code)
Auth: Header or QueryString
인증 로드맵: 현재
authKey 기반 인증을 지원하며, 2027년부터 표준 Bearer Token 인증 체계로 통합 확장될 예정입니다.
OkHttpClient client = new OkHttpClient();
// [방법 1] Query String 방식
String url1 = "https://api.kleague.com/api/playerRank.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1&seasonYN=Y&excludingPO=N";
Request request1 = new Request.Builder().url(url1).get().build();
// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/playerRank.do?meet_year=2026&meet_seq=1&seasonYN=Y&excludingPO=N";
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/playerRank.do"
params = {
"meet_year": "2026",
"meet_seq": "1",
"seasonYN": "Y",
"excludingPO": "N"
}
# [방법 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/playerRank.do';
const params = { meet_year: '2026', meet_seq: '1', seasonYN: 'Y', excludingPO: 'N' };
// [방법 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' } });