K리그 API 명세서

GET

/api/leagueInfo.do

특정 대회년도에 개최되는 K리그 모든 리그의 기본 정보를 리스트로 반환합니다.

요청 파라미터 (Request Parameters)

파라미터명	타입(Size)	필수여부	설명
authKey	`varchar`	Y	API 인증키
meet_year	`varchar(4)`	Y	조회 대상 대회년도 (예: 2026)

응답 필드 명세 (Response Fields)

필드명	데이터 타입	설명 및 비고
[Common] 공통 응답 필드 (JSON Header)
meet_year	`varchar(4)`	요청한 시즌 연도
apiName	`varchar(30)`	호출된 API 명칭 (leagueInfo)
resultCode	`varchar(3)`	결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsg	`varchar(100)`	결과 메시지
[List] 상세 데이터 항목 (Result Array)
MEET_YEAR	`varchar(4)`	대회년도
MEET_SEQ	`numeric(2, 0)`	대회순번 (리그별 고유 번호)
LEAGUE_ID	`numeric(4, 0)`	리그구분 코드 (2:K리그1, 3:K리그2 등 / 공통코드:84)
MEET_NAME	`varchar(50)`	대회 공식 명칭
GAME_QTY	`int`	해당 리그 총 경기 수
TEAM_QTY	`int`	참가 팀 수
MEET_TYPE	`numeric(4, 0)`	대회 유형 코드 (공통코드:43)
MEET_TYPE_NAME	`varchar(40)`	대회 유형 명칭 (정규리그, 플레이오프 등)
START_DATE	`varchar(10)`	리그 시작일 (YYYY/MM/DD)
END_DATE	`varchar(10)`	리그 종료일 (YYYY/MM/DD)
MEET_YN	`char(1)`	리그 마감 여부 (Y/N)

JSON 응답 샘플 (2026 시즌 기준)

{
    "response": {
        "meet_year": "2026",
        "apiName": "leagueInfo",
        "resultCode": "00",
        "list": [
            {
                "MEET_YEAR": "2026",
                "MEET_SEQ": 1,
                "LEAGUE_ID": 2,
                "LEAGUE_NAME": "K리그1",
                "MEET_NAME": "하나은행 K리그1 2026",
                "GAME_QTY": 228,
                "TEAM_QTY": 12,
                "MEET_TYPE_NAME": "정규리그",
                "START_DATE": "2026/02/28",
                "MEET_YN": "N"
            }
        ],
        "resultMsg": "success"
    }
}

데이터 연동 시 주의사항 (Time Guide)

추가시간 표출 등은 반드시 제공되는 OFFICIAL_TIME 데이터를 사용하십시오. 자세한 내용은 [API 개요 > 경기 시간 가이드]를 확인하십시오.

호출 샘플 소스 (Sample Code)

Auth: Header or QueryString

인증 로드맵: 현재 authKey 기반 인증을 지원하며, 2027년부터 표준 Bearer Token 인증 체계로 통합 확장될 예정입니다.

OkHttpClient client = new OkHttpClient();

// [방법 1] Query String 방식
String url1 = "https://api.kleague.com/api/leagueInfo.do?authKey=YOUR_API_KEY&meet_year=2026";
Request request1 = new Request.Builder().url(url1).get().build();

// [방법 2] Header 방식 (현재 권장)
Request request2 = new Request.Builder()
  .url("https://api.kleague.com/api/leagueInfo.do?meet_year=2026")
  .addHeader("authKey", "YOUR_API_KEY") 
  .build();

// [방법 3] Bearer Token 방식 (2027년 지원 예정)
Request request3 = new Request.Builder()
  .url("https://api.kleague.com/api/leagueInfo.do?meet_year=2026")
  .addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN") 
  .build();

import requests

# [방법 2] Header 인증 방식 (권장)
url = "https://api.kleague.com/api/leagueInfo.do"
headers = { "authKey": "YOUR_API_KEY" }
params = { "meet_year": "2026" }

response = requests.get(url, headers=headers, params=params)
if response.status_code == 200:
    print(response.json())

// Axios 기반 Header 방식 호출 예시
axios.get('https://api.kleague.com/api/leagueInfo.do', {
    params: { meet_year: '2026' },
    headers: { 'authKey': 'YOUR_API_KEY' }
}).then(res => {
    console.log("리그 정보 데이터:", res.data);
});