경기별 클럽 집계 기록 (Club Match Total Stats)
GET
/api/unOfficialMatchClubRecord.do
특정 경기의 구단별 모든 기술 통계(슈팅 상세, 패스 성공률, 경합, 골킥 등)를 집계하여 제공합니다.
요청 파라미터 (Request Parameters)
| 파라미터명 | 타입(Size) | 필수여부 | 설명 |
|---|---|---|---|
| authKey | varchar |
Y | API 인증키 (Header 전송 권장) |
| meet_year | varchar(4) |
Y | 대회년도 (예: 2026) |
| meet_seq | varchar(2) |
Y | 대회순번 (예: 1) |
| team_id | varchar(3) |
Y | 구단 코드 (예: K01) |
| game_id | varchar(3) |
Y | 경기번호 (예: 1) |
응답 필드 상세 명세 (Response Fields)
| 필드명 | 데이터 타입 | 설명 및 비고 |
|---|---|---|
| [Common] 공통 응답 필드 (JSON Header) | ||
| meet_year | varchar(4) | 요청한 대회년도 |
| meet_seq | varchar(2) | 요청한 대회순번 |
| apiName | varchar(30) | 호출된 API 명칭 (unOfficialMatchClubRecord) |
| resultCode | varchar(3) |
결과 코드 (00: 성공, 그 외 에러는 API 개요 참조) |
| resultMsg | varchar(100) | 결과 메시지 ("success") |
| [Section 1] 경기 및 대진 구단 기본 정보 | ||
| MEET_YEAR / MEET_SEQ / ROUND_ID / GAME_ID | varchar(4) / numeric(2,0) / int / numeric(3,0) | 대회년도 / 대회순번 / 라운드 번호 / 경기번호 |
| H_TEAM_ID / A_TEAM_ID / H_TEAM_NM / A_TEAM_NM | varchar(3) / varchar(15) | 홈 구단 코드 / 어웨이 구단 코드 / 홈 구단명 (약칭) / 어웨이 구단명 (약칭) |
| HOME_TYPE / HOME_TYPE_NM | numeric(4,0) / varchar(40) | Home 구분 코드 / 구분 명칭 (HOME / AWAY / 공통코드:58) |
| [Section 2] 공격 및 슈팅 세부 지표 (Attack Stats) | ||
| GOAL_CNT / ASSIST_CNT | int / numeric | [공식] 총 득점 수 / 총 도움 수 |
| ST_CNT / ST_VALID_CNT | int | [공식] 총 슈팅 수 / 총 유효 슈팅 수 |
| SHOT / SHOT_ON_TARGET / DEFENDER_BLOCKED_SHOT | numeric | [부가] 슈팅 시도 / 유효 슈팅 / 수비 차단 슈팅 수 |
| SHOOTING_OFF / SHOOTING_IN_PA / SHOOTING_OUT_PA / SHOT_ON_TARGET_IN_PA | numeric | [부가] 벗어난 슈팅 / PA 내 슈팅 / PA 외 슈팅 / PA 내 유효 슈팅 수 |
| FREEKICK / FREEKICK_SHOT_ON_TARGET / F_CROSS / F_CROSS_ACC / F_CROSS_ACC_PCNT | numeric | [부가] 프리킥 슈팅 / 프리킥 유효슈팅 / 프리킥 크로스 / 성공 / 성공률(%) |
| OFFSIDE / CORNER / THROW_INS / ATT_AREA_ENTER / FOULED_FINAL_THIRD | numeric | [부가] 오프사이드 / 코너킥 / 스로인 / 공격지역 진입 / 파이널서드 피파울 수 |
| DRIBBLE / DRIBBLE_SUCCESS / DRIBBLE_PCNT | numeric | [부가] 드리블 시도 / 드리블 성공 / 드리블 성공률(%) |
| [Section 3] 패스 및 빌드업 분석 지표 (Pass & Build-up) | ||
| PASS / PASS_ACC / PCNT_ACC_PASS | numeric | 전체 패스 시도 / 패스 성공 / 패스 성공률 (%) |
| EXTRA_ATT_AND_KEYPASS_ACC / EXTRA_ATT_AND_KEYPASS | numeric | 키패스 성공 / 전체 키패스 시도 수 |
| PASS_F_CA_DEG / PASS_F_ACC_CA_DEG / PCNT_PASS_F_ACC_CA_DEG | numeric | 전방 패스 시도 / 성공 / 전방 패스 성공률 (%) |
| PASS_B_CA_DEG / PASS_B_ACC_CA_DEG / PCNT_PASS_B_ACC_CA_DEG | numeric | 후방 패스 시도 / 성공 / 후방 패스 성공률 (%) |
| TRANSVERSE_PASS / TRANSVERSE_PASS_SUCCESS / PCNT_TRANSVERSE_PASS_SUCCESS | numeric | 횡패스 시도 / 성공 / 횡패스 성공률 (%) |
| ATT_AREA_PASS / ATT_AREA_PASS_SUCCESS / PCNT_ATT_AREA_PASS_SUCCESS | numeric | 공격진영 패스 시도 / 성공 / 성공률 (%) |
| DEFS_AREA_PASS / DEFS_AREA_PASS_SUCCESS / PCNT_DEFS_AREA_PASS_SUCCESS | numeric | 수비진영 패스 시도 / 성공 / 성공률 (%) |
| MIDDLE_AREA_PASS / MIDDLE_AREA_PASS_SUCCESS / PCNT_MIDDLE_AREA_PASS_SUCCESS | numeric | 중앙진영 패스 시도 / 성공 / 성공률 (%) |
| SHORT_PASS / SHORT_PASS_SUCCESS / PCNT_SHORT_PASS_SUCCESS | numeric | 단거리 패스 시도 / 성공 / 성공률 (%) |
| MEDIUM_PASS / MEDIUM_PASS_SUCCESS / PCNT_MEDIUM_PASS_SUCCESS | numeric | 중거리 패스 시도 / 성공 / 성공률 (%) |
| LONG_PASS / LONG_PASS_SUCCESS / PCNT_LONG_PASS_SUCCESS | numeric | 장거리 롱패스 시도 / 성공 / 성공률 (%) |
| CROS / CROSS_ACC / CROSS_ACC_PCNT / CONTROL_UNDER_PRESSURE | numeric | 크로스 시도 / 성공 / 크로스 성공률 (%) / 탈압박 수 |
| [Section 4] 수비, 경합 및 클리어링 (Defense & Challenge) | ||
| CHAG / CHAG_WON / CHAG_WON_PCNT | numeric | 지상 챌린지 시도 / 성공 / 경합 성공률 (%) |
| AIR_CHAG / AIR_CHAG_WON / AIR_CHAG_PCNT | numeric | 공중볼 챌린지 시도 / 성공 / 성공률 (%) |
| TACKLE / TACKLE_SUCCESS / TACKLE_PCNT | numeric | 태클 시도 / 태클 성공 / 태클 성공률 (%) |
| KICK_OUT / INTERCEPT / CUT_OFF / BALL_RECOVERIE / BLOCKING_SHOOT / BALL_MISS | numeric | 걷어내기 (클리어) / 인터셉트 / 차단 / 볼 획득 / 슈팅 블락 / 볼 미스 |
| [Section 5] 골키퍼 방어 및 징계/파울 기록 (GK & Discipline) | ||
| GOAL_CONCEDED / CATCH / PUNCH / AIR_CLEARANCES_SUCCESS | numeric | 총 실점 수 / 캐칭 / 펀칭 / 공중볼 처리 성공 수 |
| GOAL_KICK / GOAL_KICK_SUCCESS / PCNT_GOAL_KICK_SUCCESS | numeric | 골킥 시도 수 / 골킥 성공 수 / 골킥 성공률 (%) |
| FOUL / FOUL_OPP / WARN_QTY / EXIT_QTY / FO_QTY / FS_QTY | numeric / int | 파울 수 / 피파울 수 / 경고 수 / 퇴장 수 (공식 및 부가 집계) |
JSON 응답 샘플 (Club Match Stats)
{
"response": {
"meet_year": "2026",
"apiName": "unOfficialMatchClubRecord",
"resultCode": "00",
"meet_seq": "1",
"list": [
{
"MEET_YEAR": "2026",
"MEET_SEQ": 1,
"ROUND_ID": 1,
"GAME_ID": 5,
"H_TEAM_ID": "K04",
"A_TEAM_ID": "K22",
"H_TEAM_NM": "제주",
"A_TEAM_NM": "광주",
"HOME_TYPE": 1,
"HOME_TYPE_NM": "HOME",
"GOAL_CNT": 0,
"ASSIST_CNT": 0,
"ST_CNT": 6,
"ST_VALID_CNT": 2,
"SHOT": 6,
"SHOT_ON_TARGET": 2,
"DEFENDER_BLOCKED_SHOT": 0.0000,
"SHOOTING_OFF": 4.0000,
"SHOOTING_IN_PA": 2.0000,
"SHOOTING_OUT_PA": 4.0000,
"SHOT_ON_TARGET_IN_PA": 3.0000,
"FREEKICK": 4.0000,
"FREEKICK_SHOT_ON_TARGET": 0.0000,
"F_CROSS": 0.0000,
"F_CROSS_ACC": 0.0000,
"F_CROSS_ACC_PCNT": 0.0000,
"OFFSIDE": 2,
"CORNER": 3,
"THROW_INS": 18.0000,
"ATT_AREA_ENTER": 0,
"DRIBBLE": 7,
"DRIBBLE_SUCCESS": 2,
"DRIBBLE_PCNT": 28.5714,
"FOULED_FINAL_THIRD": 6.0000,
"PASS": 310,
"PASS_ACC": 254,
"PCNT_ACC_PASS": 81.935400,
"EXTRA_ATT_AND_KEYPASS_ACC": 0,
"EXTRA_ATT_AND_KEYPASS": 4,
"PASS_F_CA_DEG": 141,
"PASS_F_ACC_CA_DEG": 95,
"PCNT_PASS_F_ACC_CA_DEG": 67.375800,
"PASS_B_CA_DEG": 74,
"PASS_B_ACC_CA_DEG": 69,
"PCNT_PASS_B_ACC_CA_DEG": 93.243200,
"TRANSVERSE_PASS": 95.0000,
"TRANSVERSE_PASS_SUCCESS": 90.0000,
"PCNT_TRANSVERSE_PASS_SUCCESS": 94.736842,
"ATT_AREA_PASS": 60.0000,
"ATT_AREA_PASS_SUCCESS": 52.0000,
"PCNT_ATT_AREA_PASS_SUCCESS": 86.666666,
"DEFS_AREA_PASS": 115.0000,
"DEFS_AREA_PASS_SUCCESS": 90.0000,
"PCNT_DEFS_AREA_PASS_SUCCESS": 78.260869,
"MIDDLE_AREA_PASS": 135.0000,
"MIDDLE_AREA_PASS_SUCCESS": 112.0000,
"PCNT_MIDDLE_AREA_PASS_SUCCESS": 82.962962,
"SHORT_PASS": 138.0000,
"SHORT_PASS_SUCCESS": 116.0000,
"PCNT_SHORT_PASS_SUCCESS": 84.057971,
"MEDIUM_PASS": 120.0000,
"MEDIUM_PASS_SUCCESS": 105.0000,
"PCNT_MEDIUM_PASS_SUCCESS": 87.500000,
"LONG_PASS": 52.0000,
"LONG_PASS_SUCCESS": 33.0000,
"PCNT_LONG_PASS_SUCCESS": 63.461538,
"CROS": 16,
"CROSS_ACC": 1,
"CROSS_ACC_PCNT": 6.250000,
"CONTROL_UNDER_PRESSURE": 0.0000,
"CHAG": 14,
"CHAG_WON": 4,
"CHAG_WON_PCNT": 28.571400,
"AIR_CHAG": 27,
"AIR_CHAG_WON": 14,
"AIR_CHAG_PCNT": 51.851800,
"TACKLE": 21,
"TACKLE_SUCCESS": 3,
"TACKLE_PCNT": 14.285700,
"KICK_OUT": 25.0000,
"INTERCEPT": 13,
"CUT_OFF": 11.0000,
"BALL_RECOVERIE": 47,
"BLOCKING_SHOOT": 8.0000,
"BALL_MISS": 2.0000,
"GOAL_CONCEDED": 0,
"CATCH": 1.0000,
"PUNCH": 1.0000,
"GOAL_KICK": 12.0000,
"GOAL_KICK_SUCCESS": 10.0000,
"PCNT_GOAL_KICK_SUCCESS": 83.333333,
"AIR_CLEARANCES_SUCCESS": 0.0000,
"FOUL": 11,
"FOUL_OPP": 14,
"WARN_QTY": 2,
"EXIT_QTY": 1,
"FO_QTY": 11,
"FS_QTY": 14
}
],
"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/unOfficialMatchClubRecord.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1&team_id=K01&game_id=1";
Request request1 = new Request.Builder().url(url1).get().build();
// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/unOfficialMatchClubRecord.do?meet_year=2026&meet_seq=1&team_id=K01&game_id=1";
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/unOfficialMatchClubRecord.do"
params = {
"meet_year": "2026",
"meet_seq": "1",
"team_id": "K01",
"game_id": "1"
}
# [방법 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/unOfficialMatchClubRecord.do';
const params = { meet_year: '2026', meet_seq: '1', team_id: 'K01', game_id: '1' };
// [방법 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' } });