대회별 구단 순위 및 주요기록 (Club Record for Meet)
GET
/api/clubRecordForMeet.do
특정 대회 기간 동안 구단별 승점/순위와 함께 슈팅, 패스, 수비, 경합 지표의 전체 합계 및 경기당 평균 데이터를 통합 제공합니다.
요청 파라미터 (Request Parameters)
| 파라미터명 | 타입(Size) | 필수여부 | 설명 |
|---|---|---|---|
| authKey | varchar |
Y | API 인증키 (Header 전송 권장) |
| meet_year | varchar(4) |
Y | 대회년도 (예: 2026) |
| meet_seq | varchar(2) |
Y | 대회순번 (예: 1) |
| game_type | varchar(2) |
N | 경기 구분 (기본값: '0') |
| live_yn | varchar(1) |
N | 실시간 순위 반영 여부 ('Y': 실시간 적용, 'N': 기본값) |
| excludingPO | varchar(1) |
N | K리그2에서 PO 기록 제외 여부 ('Y': 제외, 'N': 포함 - 기본값) |
응답 필드 상세 명세 (Response Fields)
| 필드명 | 데이터 타입 | 설명 및 비고 |
|---|---|---|
| [Common] 공통 응답 필드 (JSON Header) | ||
| meet_year | varchar(4) | 요청한 대회년도 |
| meet_seq | varchar(2) | 요청한 대회순번 |
| apiName | varchar(30) | 호출된 API 명칭 (clubRecordForMeet) |
| resultCode | varchar(3) |
결과 코드 (00: 성공, 그 외 에러는 API 개요 참조) |
| resultMsg | varchar(100) | 결과 메시지 ("success") |
| [Section 1] 구단 기본 정보, 순위 및 승패 통계 | ||
| TEAM_ID / TEAM_NAME | varchar(3) / varchar(15) | 구단 코드 / 구단명 (약칭) |
| RANK / GAIN_POINT | int / int | 대회 순위 / 총 획득 승점 |
| WIN_CNT / TIE_CNT / LOSS_CNT | int | 승리 수 / 무승부 수 / 패배 수 |
| GAP_CNT / GAIN_GOAL / LOSS_GOAL | int | 득실차 / 총 득점 / 총 실점 |
| GAINGOAL_PER_WORKQTY / LOSSGOAL_PER_WORKQTY | numeric(10,5) | 경기당 평균 득점 수 / 경기당 평균 실점 수 |
| WORK_QTY / CONTINUE_WINTYPE | int / varchar(10) | 치른 총 경기 수 / 최근 연속 승패무 기록 (예: '2승', '1패') |
| GAME_TYPE / GAME_TYPE2 | varchar(10) / varchar(10) | 경기 구분 상태명 / 요청된 경기 구분 코드 |
| [Section 2] 주요 기술 지표 누적 합계 (SUM) | ||
| ST_SUM / ST_VALID_SUM | int | 총 슈팅 합계 / 총 유효 슈팅 합계 |
| FO_SUM / CK_SUM / OS_SUM | int | 총 파울 합계 / 총 코너킥 합계 / 총 오프사이드 합계 |
| WARN_SUM / EXIT_SUM | int | 총 경고 합계 / 총 퇴장 합계 |
| PASS_SUM / PASS_SUCCESS_SUM | int | 총 패스 시도 합계 / 총 패스 성공 합계 |
| DRIBBLE_SUM / DRIBBLE_SUCCESS_SUM | int | 총 드리블 시도 합계 / 총 드리블 성공 합계 |
| TACKLE_SUM / TACKLE_SUCCESS_SUM | int | 총 태클 시도 합계 / 총 태클 성공 합계 |
| INTERCEPT_SUM / AIR_CHAG_SUM / AIR_CHAG_SUCCESS_SUM | int | 총 인터셉트 합계 / 총 공중볼 챌린지 시도 / 총 공중볼 챌린지 성공 |
| CROSS_SUM / CROSS_SUCCESS_SUM | int | 총 크로스 시도 합계 / 총 크로스 성공 합계 |
| [Section 3] 경기당 평균 데이터 (AVG) | ||
| ST_AVG / ST_VALID_AVG | numeric(6,2) | 경기당 평균 슈팅 수 / 경기당 평균 유효 슈팅 수 |
| FO_AVG / CK_AVG / OS_AVG | numeric(6,2) | 경기당 평균 파울 수 / 경기당 평균 코너킥 수 / 경기당 평균 오프사이드 수 |
| WARN_AVG / EXIT_AVG | numeric(6,2) | 경기당 평균 경고 수 / 경기당 평균 퇴장 수 |
| PASS_AVG / PASS_SUCCESS_AVG | numeric(6,2) | 경기당 평균 패스 시도 / 경기당 평균 패스 성공 |
| DRIBBLE_AVG / DRIBBLE_SUCCESS_AVG | numeric(6,2) | 경기당 평균 드리블 시도 / 경기당 평균 드리블 성공 |
| TACKLE_AVG / TACKLE_SUCCESS_AVG | numeric(6,2) | 경기당 평균 태클 시도 / 경기당 평균 태클 성공 |
| INTERCEPT_AVG / AIR_CHAG_AVG / AIR_CHAG_SUCCESS_AVG | numeric(6,2) | 경기당 평균 인터셉트 / 경기당 평균 공중볼 시도 / 경기당 평균 공중볼 성공 |
| CROSS_AVG / CROSS_SUCCESS_AVG | numeric(6,2) | 경기당 평균 크로스 시도 / 경기당 평균 크로스 성공 |
| TEAM_SHARE_AVG | numeric(6,2) | 경기당 평균 점유율 (%) |
JSON 응답 샘플 (Club Total Stats)
{
"response": {
"meet_year": "2026",
"apiName": "clubRecordForMeet",
"resultCode": "00",
"meet_seq": "1",
"list": [
{
"TEAM_ID": "K09",
"TEAM_NAME": "서울",
"RANK": 1,
"GAIN_POINT": 19,
"WIN_CNT": 6,
"TIE_CNT": 1,
"LOSS_CNT": 0,
"GAP_CNT": 12,
"GAIN_GOAL": 16,
"LOSS_GOAL": 4,
"GAINGOAL_PER_WORKQTY": 2.28571,
"LOSSGOAL_PER_WORKQTY": 0.57143,
"CONTINUE_WINTYPE": "2승",
"WORK_QTY": 7,
"GAME_TYPE": "",
"GAME_TYPE2": "0",
"ST_SUM": 65,
"ST_VALID_SUM": 45,
"FO_SUM": 93,
"CK_SUM": 33,
"OS_SUM": 4,
"WARN_SUM": 18,
"EXIT_SUM": 0,
"ST_AVG": 9.29,
"ST_VALID_AVG": 6.43,
"FO_AVG": 13.29,
"CK_AVG": 4.71,
"OS_AVG": 0.57,
"WARN_AVG": 2.57,
"EXIT_AVG": 0.00,
"PASS_SUM": 3137,
"PASS_SUCCESS_SUM": 2663,
"DRIBBLE_SUM": 50,
"DRIBBLE_SUCCESS_SUM": 22,
"TACKLE_SUM": 188,
"TACKLE_SUCCESS_SUM": 39,
"INTERCEPT_SUM": 55,
"AIR_CHAG_SUM": 229,
"AIR_CHAG_SUCCESS_SUM": 98,
"CROSS_SUM": 137,
"CROSS_SUCCESS_SUM": 32,
"PASS_AVG": 448.14,
"PASS_SUCCESS_AVG": 380.43,
"DRIBBLE_AVG": 7.14,
"DRIBBLE_SUCCESS_AVG": 3.14,
"TACKLE_AVG": 26.86,
"TACKLE_SUCCESS_AVG": 5.57,
"INTERCEPT_AVG": 7.86,
"AIR_CHAG_AVG": 32.71,
"AIR_CHAG_SUCCESS_AVG": 14.00,
"CROSS_AVG": 19.57,
"CROSS_SUCCESS_AVG": 4.57,
"TEAM_SHARE_AVG": 53.69
},
{
"TEAM_ID": "K01",
"TEAM_NAME": "울산",
"RANK": 2,
"GAIN_POINT": 13,
"WIN_CNT": 4,
"TIE_CNT": 1,
"LOSS_CNT": 2,
"GAP_CNT": 1,
"GAIN_GOAL": 10,
"LOSS_GOAL": 9,
"GAINGOAL_PER_WORKQTY": 1.42857,
"LOSSGOAL_PER_WORKQTY": 1.28571,
"CONTINUE_WINTYPE": "1패",
"WORK_QTY": 7,
"GAME_TYPE": "",
"GAME_TYPE2": "0",
"ST_SUM": 95,
"ST_VALID_SUM": 56,
"FO_SUM": 77,
"CK_SUM": 34,
"OS_SUM": 8,
"WARN_SUM": 12,
"EXIT_SUM": 0,
"ST_AVG": 13.57,
"ST_VALID_AVG": 8.00,
"FO_AVG": 11.00,
"CK_AVG": 4.86,
"OS_AVG": 1.14,
"WARN_AVG": 1.71,
"EXIT_AVG": 0.00,
"PASS_SUM": 3057,
"PASS_SUCCESS_SUM": 2552,
"DRIBBLE_SUM": 54,
"DRIBBLE_SUCCESS_SUM": 18,
"TACKLE_SUM": 219,
"TACKLE_SUCCESS_SUM": 70,
"INTERCEPT_SUM": 54,
"AIR_CHAG_SUM": 186,
"AIR_CHAG_SUCCESS_SUM": 102,
"CROSS_SUM": 140,
"CROSS_SUCCESS_SUM": 32,
"PASS_AVG": 436.71,
"PASS_SUCCESS_AVG": 364.57,
"DRIBBLE_AVG": 7.71,
"DRIBBLE_SUCCESS_AVG": 2.57,
"TACKLE_AVG": 31.29,
"TACKLE_SUCCESS_AVG": 10.00,
"INTERCEPT_AVG": 7.71,
"AIR_CHAG_AVG": 26.57,
"AIR_CHAG_SUCCESS_AVG": 14.57,
"CROSS_AVG": 20.00,
"CROSS_SUCCESS_AVG": 4.57,
"TEAM_SHARE_AVG": 45.95
}
],
"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/clubRecordForMeet.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1&game_type=0&live_yn=N&excludingPO=N";
Request request1 = new Request.Builder().url(url1).get().build();
// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/clubRecordForMeet.do?meet_year=2026&meet_seq=1&game_type=0&live_yn=N&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/clubRecordForMeet.do"
params = {
"meet_year": "2026",
"meet_seq": "1",
"game_type": "0",
"live_yn": "N",
"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/clubRecordForMeet.do';
const params = { meet_year: '2026', meet_seq: '1', game_type: '0', live_yn: 'N', 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' } });