경기별 선수 부가기록 분석 (Official & Addition Player Record)

GET

/api/matchPlayerRecord.do

특정 경기에 출전한 선수별 K리그 공식 실시간 기록 및 전문 분석업체(Bepro11)의 영상 기반 부가 데이터(패스, 챌린지, 공중볼, 피리어드별 징계 스탯 등)를 제공합니다.

요청 파라미터 (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 구단 코드 (예: K09)
game_id varchar(3) Y 경기번호 (예: 1)

응답 필드 상세 명세 (Response Fields)

필드명 데이터 타입 설명 및 비고
[Common] 공통 응답 필드 (JSON Header)
meet_yearvarchar(4)요청한 대회년도
meet_seqvarchar(2)요청한 대회순번
apiNamevarchar(30)호출된 API 명칭 (unOfficialMatchPlayerRecord)
resultCode varchar(3) 결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsgvarchar(100)결과 메시지 ("success")
[Section 1] 경기, 구단 및 선수 인적 정보
MEET_YEAR / MEET_SEQ / GAME_IDvarchar(4) / numeric(2,0) / varchar(3)대회년도 / 대회순번 / 경기번호
TEAM_ID / PLAYER_ID / NAMEvarchar(3) / varchar(8) / varchar(20)구단 코드 / 선수 코드 / 선수 성명
BACK_NO / CAPTAIN_YNint / char(1)등번호 (배번) / 주장 여부 (Y/N)
POSITION_CODE / POSITION_NAMEnumeric(4,0) / varchar(40)포지션 코드 / 포지션 명칭 (공통코드:42)
WORK_TIME / WORK_QTYint / varchar(1)출전 시간(분) / 출전 여부 (1:출전)
[Section 2] 공식 실시간 기록 및 슈팅 부가 분석 스탯
GOAL_QTY / ASSIST_QTY / FS_QTYnumeric[공식] 득점 / 도움 / 피파울 수
ST_QTY / ST_VALID_QTYnumeric[공식] 슈팅 수 / 유효 슈팅 수
SHOT / SHOT_ON_TARGETnumeric(5,0)[부가] 슈팅 시도 / 유효 슈팅
DEFENDER_BLOCKED_SHOT / SHOOTING_OFFnumeric(5,0)[부가] 수비 차단 슈팅 / 벗어난 슈팅
SHOOTING_IN_PA / SHOOTING_OUT_PA / SHOT_ON_TARGET_IN_PAnumeric(5,0)[부가] PA 내 슈팅 / PA 외 슈팅 / PA 내 유효 슈팅
OFFSIDE / FREEKICK / CORNER / THROW_INS / ATT_AREA_ENTERnumeric(5,0)[부가] 오프사이드 / 프리킥 / 코너킥 / 스로인 / 공격지역 진입 횟수
EX_ATT_KEY_PASS / EX_ATT_KEY_PASS_ACC / DRIBBLE / DRIBBLE_SUCCESS / PCNT_SUCCESS_DRIBBLEnumeric(5,0) / numeric(7,4)[부가] 키패스 시도 / 성공 / 드리블 시도 / 성공 / 드리블 성공률(%)
[Section 3] 패스 세부 분석 스탯 (시도 / 성공 / 성공률%)
PASS / PASS_ACC / PCNT_ACC_PASSnumeric(5,0) / numeric(7,4)전체 패스 시도 / 성공 / 성공률(%)
PASS_F_CA_DEG / PASS_F_ACC_CA_DEG / PCNT_PASS_F_CA_DEGnumeric(5,0) / numeric(7,4)전방 패스 시도 / 성공 / 전방 패스 성공률(%)
PASS_B_CA_DEG / PASS_B_ACC_CA_DEG / PCNT_PASS_B_ACC_CA_DEGnumeric(5,0) / numeric후방 패스 시도 / 성공 / 후방 패스 성공률(%)
TRANSVERSE_PASS / TRANSVERSE_PASS_SUCCESS / PCNT_TRANSVERSE_PASS_SUCCESSnumeric(5,0) / numeric횡패스 시도 / 성공 / 횡패스 성공률(%)
ATT_AREA_PASS / ATT_AREA_PASS_SUCCESS / PCNT_ATT_AREA_PASS_SUCCESSnumeric(5,0) / numeric공격진영 패스 시도 / 성공 / 성공률(%)
DEFS_AREA_PASS / DEFS_AREA_PASS_SUCCESS / PCNT_DEFS_AREA_PASS_SUCCESSnumeric(5,0) / numeric수비진영 패스 시도 / 성공 / 성공률(%)
MIDDLE_AREA_PASS / MIDDLE_AREA_PASS_SUCCESS / PCNT_MIDDLE_AREA_PASS_SUCCESSnumeric(5,0) / numeric중앙진영 패스 시도 / 성공 / 성공률(%)
LONG_PASS / LONG_PASS_SUCCESS / PCNT_LONG_PASS_SUCCESSnumeric(5,0) / numeric롱패스 시도 / 성공 / 롱패스 성공률(%)
MEDIUM_PASS / MEDIUM_PASS_SUCCESS / PCNT_MEDIUM_PASS_SUCCESSnumeric(5,0) / numeric중거리패스 시도 / 성공 / 중거리패스 성공률(%)
SHORT_PASS / SHORT_PASS_SUCCESS / PCNT_SHORT_PASS_SUCCESSnumeric(5,0) / numeric단거리패스 시도 / 성공 / 단거리패스 성공률(%)
CROS / CROS_ACC / PCNT_CROS_ACC / CONTROL_UNDER_PRESSUREnumeric(5,0) / numeric크로스 시도 / 성공 / 성공률(%) / 탈압박 횟수
[Section 4] 수비, 챌린지(경합), 태클 및 피리어드별 징계 기록
WARN_QTY / EXIT_QTYnumeric[공식 합계] 총 경고 수 / 총 퇴장 수
B_WARN_QTY / A_WARN_QTY / EB_WARN_QTY / EA_WARN_QTYnumeric[전후반/연장] 전반 경고 / 후반 경고 / 연장전반 경고 / 연장후반 경고
B_EXIT_QTY / A_EXIT_QTY / EB_EXIT_QTY / EA_EXIT_QTYnumeric[전후반/연장] 전반 퇴장 / 후반 퇴장 / 연장전반 퇴장 / 연장후반 퇴장
FO_QTY / FOUL / FOUL_SUFFEREDnumeric[공식] 파울 / [부가] 파울 / 피파울
CHALG / CHALG_WON / PCNT_CHALG_WONnumeric(5,0) / numeric지상 챌린지 시도 / 성공 / 성공률(%)
AIR_CHALG / AIR_CHALG_WON / AIR_CHALLENGE_PCNTnumeric(5,0) / numeric공중볼 챌린지 시도 / 성공 / 성공률(%)
TACKLE / TACKLE_SUCCESS / PCNT_TACKLE_WONnumeric(5,0) / numeric태클 시도 / 성공 / 성공률(%)
KICK_OUT / INTERCEPT / CUT_OFF / BALL_RECOVERIE / BLOCKING_SHOOT / BALL_MISSnumeric(5,0)걷어내기 (클리어링) / 인터셉트 / 차단 / 볼 획득 / 슈팅 블락 / 볼 미스
[Section 5] 골키퍼(GK) 전용 부가 스탯 (PDAT_TB_UOPL_REC02)
GOAL_CONCEDED / SHOT_SAVEDnumeric(5,0)GK 실점 / GK 막은 슈팅 (선방)
CATCH / PUNCH / DROPSnumeric(5,0)GK 캐치 / 펀칭 / 볼 드롭 횟수
GOAL_KICK / GOAL_KICK_SUCCESSnumeric(5,0)GK 골킥 시도 수 / 골킥 성공 수

JSON 응답 샘플 (2026 실전 데이터) 

{
    "response": {
        "meet_year": "2026",
        "apiName": "unOfficialMatchPlayerRecord",
        "resultCode": "00",
        "meet_seq": "1",
        "list": [
            {
                "MEET_YEAR": "2026",
                "MEET_SEQ": 1,
                "GAME_ID": "1",
                "TEAM_ID": "K09",
                "PLAYER_ID": "20180034",
                "NAME": "송민규",
                "BACK_NO": 34,
                "CAPTAIN_YN": "N",
                "POSITION_CODE": 3,
                "POSITION_NAME": "MF",
                "WORK_TIME": 62,
                "WORK_QTY": "1",
                "GOAL_QTY": 0,
                "ST_QTY": 2,
                "ST_VALID_QTY": 1,
                "ASSIST_QTY": 0,
                "FS_QTY": 2,
                "SHOT": 2,
                "SHOT_ON_TARGET": 1,
                "DEFENDER_BLOCKED_SHOT": 0,
                "SHOOTING_OFF": 1,
                "SHOOTING_IN_PA": 2,
                "SHOOTING_OUT_PA": 0,
                "SHOT_ON_TARGET_IN_PA": 1,
                "OFFSIDE": 0,
                "FREEKICK": 0,
                "CORNER": 0,
                "THROW_INS": 0,
                "ATT_AREA_ENTER": 4,
                "EX_ATT_KEY_PASS_ACC": 1,
                "EX_ATT_KEY_PASS": 1,
                "DRIBBLE": 3,
                "DRIBBLE_SUCCESS": 2,
                "PCNT_SUCCESS_DRIBBLE": 66.67,
                "PASS": 28,
                "PASS_ACC": 22,
                "PCNT_ACC_PASS": 78.57,
                "PASS_F_CA_DEG": 10,
                "PASS_F_ACC_CA_DEG": 7,
                "PCNT_PASS_F_CA_DEG": 70.0,
                "PASS_B_CA_DEG": 5,
                "PASS_B_ACC_CA_DEG": 5,
                "PCNT_PASS_B_ACC_CA_DEG": 100.0,
                "TRANSVERSE_PASS": 13,
                "TRANSVERSE_PASS_SUCCESS": 10,
                "PCNT_TRANSVERSE_PASS_SUCCESS": 76.92,
                "ATT_AREA_PASS": 12,
                "ATT_AREA_PASS_SUCCESS": 8,
                "PCNT_ATT_AREA_PASS_SUCCESS": 66.67,
                "DEFS_AREA_PASS": 2,
                "DEFS_AREA_PASS_SUCCESS": 2,
                "PCNT_DEFS_AREA_PASS_SUCCESS": 100.0,
                "MIDDLE_AREA_PASS": 14,
                "MIDDLE_AREA_PASS_SUCCESS": 12,
                "PCNT_MIDDLE_AREA_PASS_SUCCESS": 85.71,
                "LONG_PASS": 1,
                "LONG_PASS_SUCCESS": 1,
                "PCNT_LONG_PASS_SUCCESS": 100.0,
                "MEDIUM_PASS": 12,
                "MEDIUM_PASS_SUCCESS": 10,
                "PCNT_MEDIUM_PASS_SUCCESS": 83.33,
                "SHORT_PASS": 15,
                "SHORT_PASS_SUCCESS": 11,
                "PCNT_SHORT_PASS_SUCCESS": 73.33,
                "CROS": 2,
                "CROS_ACC": 1,
                "PCNT_CROS_ACC": 50.0,
                "CONTROL_UNDER_PRESSURE": 3,
                "WARN_QTY": 0,
                "EXIT_QTY": 0,
                "B_WARN_QTY": 0,
                "B_EXIT_QTY": 0,
                "A_WARN_QTY": 0,
                "A_EXIT_QTY": 0,
                "EB_WARN_QTY": 0,
                "EB_EXIT_QTY": 0,
                "EA_WARN_QTY": 0,
                "EA_EXIT_QTY": 0,
                "FO_QTY": 1,
                "CHALG": 8,
                "CHALG_WON": 5,
                "PCNT_CHALG_WON": 62.5,
                "AIR_CHALG": 2,
                "AIR_CHALG_WON": 1,
                "AIR_CHALLENGE_PCNT": 50.0,
                "TACKLE": 2,
                "TACKLE_SUCCESS": 2,
                "PCNT_TACKLE_WON": 100.0,
                "KICK_OUT": 1,
                "INTERCEPT": 2,
                "CUT_OFF": 1,
                "BALL_RECOVERIE": 4,
                "BLOCKING_SHOOT": 0,
                "BALL_MISS": 1,
                "FOUL": 1,
                "FOUL_SUFFERED": 2,
                "GOAL_CONCEDED": 0,
                "SHOT_SAVED": 0,
                "CATCH": 0,
                "PUNCH": 0,
                "DROPS": 0,
                "GOAL_KICK": 0,
                "GOAL_KICK_SUCCESS": 0
            }
        ],
        "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/matchPlayerRecord.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1&team_id=K09&game_id=1";
Request request1 = new Request.Builder().url(url1).get().build();

// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/matchPlayerRecord.do?meet_year=2026&meet_seq=1&team_id=K09&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/matchPlayerRecord.do"
params = { 
    "meet_year": "2026", 
    "meet_seq": "1", 
    "team_id": "K09",
    "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/matchPlayerRecord.do';
const params = { meet_year: '2026', meet_seq: '1', team_id: 'K09', 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' } });