구단 정보 조회 (Club Info)
GET
/api/clubInfo.do
K리그에 소속된 전체 구단(현재 및 과거)의 기본 정보 및 연고지, 감독 정보를 조회합니다.
요청 파라미터 (Request Parameters)
| 파라미터명 | 타입(Size) | 필수여부 | 설명 |
|---|---|---|---|
| authKey | varchar |
Y | API 인증키 |
응답 필드 명세 (Response Fields)
| 필드명 | 데이터 타입 | 설명 및 비고 |
|---|---|---|
| [Common] 공통 응답 필드 (JSON Header) | ||
| apiName | varchar(30) | 호출된 API 명칭 (clubInfo) |
| resultCode | varchar(3) |
결과 코드 (00: 성공, 그 외 에러는 API 개요 참조) |
| resultMsg | varchar(100) | 결과 메시지 ("success") |
| [List] 구단 상세 정보 항목 (Result Array) | ||
| TEAM_ID | varchar(3) | 구단 코드 (예: K25, K23 등) |
| TEAM_ENG_NAME | varchar(30) | 구단 영문 명칭 |
| TEAM_ENG_F_NAME | varchar(50) | 구단 공식 영문 전체 명칭 |
| TEAM_S_NAME | varchar(15) | 구단 국문 약칭 |
| TEAM_NAME | varchar(20) | 구단 국문 명칭 |
| TEAM_F_NAME | varchar(50) | 구단 공식 전체 명칭 |
| START_DATE | varchar(10) | 창립일 (YYYY/MM/DD) |
| END_DATE | varchar(10) | 해체일 (활동 중인 경우 빈값) |
| RELATION_AREA | numeric(4, 0) | 연고지 코드 (공통코드:25) |
| RELATION_AREA_NAME | varchar(40) | 연고지 명칭 |
| MANAGER_ID | varchar(8) | 현재 감독 선수코드 |
| MANAGER_NAME | varchar(20) | 현재 감독명 |
| HOMEPAGE | varchar(50) | 구단 공식 홈페이지 주소 |
| LEAGUE_ID | numeric(4, 0) | 소속 리그 코드 (공통코드:84) |
| LEAGUE_NAME | varchar(40) | 소속 리그 명칭 |
| R_LEAGUE_YN | char(1) | R리그 운영 여부 (Y/N) |
| U18_LEAGUE_YN | char(1) | U18리그 운영 여부 (Y/N) |
| BUSINESS_ID | varchar(10) | 사업자 등록번호 |
JSON 응답 샘플 (실제 데이터 추출)
{
"response": {
"apiName": "clubInfo",
"resultCode": "00",
"list": [
{
"TEAM_ID": "K21",
"TEAM_ENG_NAME": "GANGWON",
"TEAM_ENG_F_NAME": "GANGWON FC",
"TEAM_S_NAME": "강원",
"TEAM_NAME": "강원FC",
"TEAM_F_NAME": "강원FC",
"START_DATE": "2008/12/18",
"END_DATE": "",
"RELATION_AREA": 18,
"RELATION_AREA_NAME": "강원도",
"MANAGER_ID": "20030069",
"MANAGER_NAME": "정경호",
"HOMEPAGE": "https://www.gangwon-fc.com",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "Y",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K22",
"TEAM_ENG_NAME": "GWANGJU",
"TEAM_ENG_F_NAME": "GWANGJU FC",
"TEAM_S_NAME": "광주",
"TEAM_NAME": "광주FC",
"TEAM_F_NAME": "광주FC",
"START_DATE": "2010/12/07",
"END_DATE": "",
"RELATION_AREA": 12,
"RELATION_AREA_NAME": "광주광역시",
"MANAGER_ID": "20050037",
"MANAGER_NAME": "이정규",
"HOMEPAGE": "https://www.gwangjufc.com/",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "N",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K35",
"TEAM_ENG_NAME": "GIMCHEON",
"TEAM_ENG_F_NAME": "Gimcheon Sangmu Football Club",
"TEAM_S_NAME": "김천",
"TEAM_NAME": "김천 상무",
"TEAM_F_NAME": "김천 상무 프로축구단",
"START_DATE": "2021/01/01",
"END_DATE": "",
"RELATION_AREA": 24,
"RELATION_AREA_NAME": "김천시(경북)",
"MANAGER_ID": "20030015",
"MANAGER_NAME": "주승진",
"HOMEPAGE": "https://gimcheonfc.com/",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "N",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K10",
"TEAM_ENG_NAME": "DAEJEON HANA",
"TEAM_ENG_F_NAME": "DAEJEON HANA CITIZEN FC",
"TEAM_S_NAME": "대전",
"TEAM_NAME": "대전 하나 시티즌",
"TEAM_F_NAME": "대전 하나 시티즌",
"START_DATE": "1997/01/01",
"END_DATE": "",
"RELATION_AREA": 1,
"RELATION_AREA_NAME": "대전광역시",
"MANAGER_ID": "19970094",
"MANAGER_NAME": "황선홍",
"HOMEPAGE": "https://www.dhcfc.kr/",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "Y",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K26",
"TEAM_ENG_NAME": "BUCHEON",
"TEAM_ENG_F_NAME": "BUCHEON FC 1995",
"TEAM_S_NAME": "부천",
"TEAM_NAME": "부천FC1995",
"TEAM_F_NAME": "부천 FC 1995",
"START_DATE": "2007/01/01",
"END_DATE": "",
"RELATION_AREA": 10,
"RELATION_AREA_NAME": "부천시(경기)",
"MANAGER_ID": "19970108",
"MANAGER_NAME": "이영민",
"HOMEPAGE": "https://www.bfc1995.com",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "Y",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K09",
"TEAM_ENG_NAME": "SEOUL",
"TEAM_ENG_F_NAME": "FC SEOUL",
"TEAM_S_NAME": "서울",
"TEAM_NAME": "FC서울",
"TEAM_F_NAME": "FC서울",
"START_DATE": "1983/12/22",
"END_DATE": "",
"RELATION_AREA": 15,
"RELATION_AREA_NAME": "서울특별시",
"MANAGER_ID": "19970114",
"MANAGER_NAME": "김기동",
"HOMEPAGE": "https://www.fcseoul.com/",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "Y",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K27",
"TEAM_ENG_NAME": "ANYANG",
"TEAM_ENG_F_NAME": "FC ANYANG",
"TEAM_S_NAME": "안양",
"TEAM_NAME": "FC안양",
"TEAM_F_NAME": "FC안양",
"START_DATE": "2013/02/02",
"END_DATE": "",
"RELATION_AREA": 7,
"RELATION_AREA_NAME": "안양시(경기)",
"MANAGER_ID": "19970193",
"MANAGER_NAME": "유병훈",
"HOMEPAGE": "https://www.fc-anyang.com",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "N",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K01",
"TEAM_ENG_NAME": "ULSAN",
"TEAM_ENG_F_NAME": "ULSAN HD FOOTBALL CLUB",
"TEAM_S_NAME": "울산",
"TEAM_NAME": "울산 HD",
"TEAM_F_NAME": "울산 HD FC",
"START_DATE": "1983/12/06",
"END_DATE": "",
"RELATION_AREA": 9,
"RELATION_AREA_NAME": "울산광역시",
"MANAGER_ID": "19970010",
"MANAGER_NAME": "김현석",
"HOMEPAGE": "https://www.uhdfc.com/fc/greetings.php",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "Y",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K18",
"TEAM_ENG_NAME": "INCHEON",
"TEAM_ENG_F_NAME": "INCHEON UNITED FC",
"TEAM_S_NAME": "인천",
"TEAM_NAME": "인천 Utd",
"TEAM_F_NAME": "인천 유나이티드",
"START_DATE": "2003/12/31",
"END_DATE": "",
"RELATION_AREA": 13,
"RELATION_AREA_NAME": "인천광역시",
"MANAGER_ID": "19970118",
"MANAGER_NAME": "윤정환",
"HOMEPAGE": "https://www.incheonutd.com",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "Y",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K05",
"TEAM_ENG_NAME": "JEONBUK",
"TEAM_ENG_F_NAME": "JEONBUK HYUNDAI MOTORS FC",
"TEAM_S_NAME": "전북",
"TEAM_NAME": "전북 현대",
"TEAM_F_NAME": "전북 현대 모터스",
"START_DATE": "1994/12/12",
"END_DATE": "",
"RELATION_AREA": 14,
"RELATION_AREA_NAME": "전라북도",
"MANAGER_ID": "20140216",
"MANAGER_NAME": "정정용",
"HOMEPAGE": "https://www.hyundai-motorsfc.com",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "N",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K04",
"TEAM_ENG_NAME": "JEJU",
"TEAM_ENG_F_NAME": "JEJU SK FC",
"TEAM_S_NAME": "제주",
"TEAM_NAME": "제주SK FC",
"TEAM_F_NAME": "제주SK FC",
"START_DATE": "1982/12/17",
"END_DATE": "",
"RELATION_AREA": 17,
"RELATION_AREA_NAME": "제주특별자치도",
"MANAGER_ID": "20260258",
"MANAGER_NAME": "세르지우 코스타",
"HOMEPAGE": "https://www.jejuskfc.com/",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "Y",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
},
{
"TEAM_ID": "K03",
"TEAM_ENG_NAME": "POHANG",
"TEAM_ENG_F_NAME": "FC POHANG STEELERS",
"TEAM_S_NAME": "포항",
"TEAM_NAME": "포항 스틸러스",
"TEAM_F_NAME": "포항 스틸러스",
"START_DATE": "1973/04/01",
"END_DATE": "",
"RELATION_AREA": 3,
"RELATION_AREA_NAME": "포항시(경북)",
"MANAGER_ID": "19970093",
"MANAGER_NAME": "박태하",
"HOMEPAGE": "https://www.steelers.co.kr",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"R_LEAGUE_YN": "N",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": "1051917549"
},
{
"TEAM_ID": "K20",
"TEAM_ENG_NAME": "GYEONGNAM",
"TEAM_ENG_F_NAME": "GYEONGNAM FC",
"TEAM_S_NAME": "경남",
"TEAM_NAME": "경남FC",
"TEAM_F_NAME": "경남FC",
"START_DATE": "2006/01/01",
"END_DATE": "",
"RELATION_AREA": 16,
"RELATION_AREA_NAME": "경상남도",
"MANAGER_ID": "20020048",
"MANAGER_NAME": "배성재",
"HOMEPAGE": "http://www.gyeongnamfc.com",
"LEAGUE_ID": 3,
"LEAGUE_NAME": "K리그2",
"R_LEAGUE_YN": "N",
"U18_LEAGUE_YN": "N",
"BUSINESS_ID": ""
}
],
"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/clubInfo.do?authKey=YOUR_API_KEY";
Request request1 = new Request.Builder().url(url1).get().build();
// [방법 2] Header 방식 (현재 권장)
Request request2 = new Request.Builder()
.url("https://api.kleague.com/api/clubInfo.do")
.addHeader("authKey", "YOUR_API_KEY")
.build();
// [방법 3] Bearer Token 방식 (2027년 지원 예정)
Request request3 = new Request.Builder()
.url("https://api.kleague.com/api/clubInfo.do")
.addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN")
.build();
import requests
# [방법 1] Query String 방식 (URL 직접 호출)
url1 = "https://api.kleague.com/api/clubInfo.do?authKey=YOUR_API_KEY"
response1 = requests.get(url1)
# [방법 2] Header 인증 방식 (현재 권장)
url2 = "https://api.kleague.com/api/clubInfo.do"
headers2 = { "authKey": "YOUR_API_KEY" }
response2 = requests.get(url2, headers=headers2)
# [방법 3] Bearer Token 인증 (2027년 도입 예정)
# headers3 = { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
# response3 = requests.get(url2, headers=headers3)
// [방법 1] Query String 방식
const url1 = "https://api.kleague.com/api/clubInfo.do?authKey=YOUR_API_KEY";
axios.get(url1);
// [방법 2] Header 방식 (현재 권장)
axios.get('https://api.kleague.com/api/clubInfo.do', {
headers: { 'authKey': 'YOUR_API_KEY' }
});
// [방법 3] Bearer 방식 (2027년 확장 대응)
// axios.get(url, { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } });