K리그 API 명세서

GET

/api/audienceInfo01.do

특정 기간 및 리그별 각 경기의 유료 관중수, 원정팀 관중수 및 중립지역 여부 등 관중 관련 상세 통계 데이터를 제공합니다.

요청 파라미터 (Request Parameters)

파라미터명	타입(Size)	필수여부	설명
authKey	`varchar`	Y	API 인증키 (Header 전송 권장)
league_gubun	`varchar(1)`	N	대회구분 (1: K리그1, 2: K리그2, 3: 플레이오프, 4: 리그컵 / 미입력 또는 0: 전체)
meet_year	`varchar(4)`	N	대회년도 (예: 2026)
team_id	`varchar(3)`	N	구단 코드 (예: K01)
sdate	`varchar(10)`	Y	조회 기준 시작일 (YYYY/MM/DD)
edate	`varchar(10)`	Y	조회 기준 종료일 (YYYY/MM/DD)

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

필드명	데이터 타입	설명 및 비고
[Common] 공통 응답 필드 (JSON Header)
apiName	`varchar(30)`	호출된 API 명칭 (audienceInfo01)
resultCode	`varchar(3)`	결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsg	`varchar(100)`	결과 메시지 ("success")
[Section 1] 대회 및 경기 마스터 정보
LEAGUE_NAME	`varchar(30)`	대회 구분 명칭 (K리그1, K리그2, 플레이오프, 리그컵)
MEET_YEAR / MEET_SEQ / GAME_ID	`varchar(4)` / `numeric(3,0)` / `numeric(3,0)`	대회년도 / 대회순번 / 경기번호
MEET_NAME / GAME_DATE	`varchar(50)` / `varchar(10)`	대회 공식 명칭 / 경기일자 (YYYY/MM/DD)
FIELD_ID / FIELD_NAME	`numeric(4,0)` / `varchar(20)`	경기장 코드 / 경기장 명칭
[Section 2] 대진 팀 정보 및 스코어
HOME_TEAM_ID / HOME_TEAM_NAME / HOME_GAIN_GOAL	`varchar(3)` / `varchar(15)` / `int`	홈 구단 코드 / 홈 구단명 (약칭) / 홈팀 총득점
AWAY_TEAM_ID / AWAY_TEAM_NAME / AWAY_GAIN_GOAL	`varchar(3)` / `varchar(15)` / `int`	어웨이 구단 코드 / 어웨이 구단명 (약칭) / 어웨이팀 총득점
[Section 3] 관중수 및 통계 정보
AUDIENCE_QTY	`int`	관중수 (유료 관중 합계 수)
AUDIENCE_AWAY_QTY	`int`	원정팀 관중 수
WEEKEND / NEUTRAL_YN	`varchar(2)` / `varchar(1)`	주말 여부 ('주말' 또는 공백) / 중립 지역 여부 ('Y' / 'N')
RANK	`int`	조회 기준 관중수 순위

JSON 응답 샘플 (Audience Stats Data)

{
    "response": {
        "apiName": "audienceInfo01",
        "resultCode": "00",
        "list": [
            {
                "LEAGUE_NAME": "K리그1",
                "MEET_YEAR": "2026",
                "MEET_SEQ": 1,
                "MEET_NAME": "하나은행 K리그1 2026",
                "GAME_ID": 12,
                "GAME_DATE": "2026/04/12",
                "FIELD_ID": 101,
                "FIELD_NAME": "울산문수",
                "HOME_TEAM_ID": "K01",
                "HOME_TEAM_NAME": "울산",
                "HOME_GAIN_GOAL": 2,
                "AWAY_TEAM_ID": "K09",
                "AWAY_TEAM_NAME": "서울",
                "AWAY_GAIN_GOAL": 1,
                "AUDIENCE_QTY": 28453,
                "AUDIENCE_AWAY_QTY": 1500,
                "WEEKEND": "주말",
                "NEUTRAL_YN": "N",
                "RANK": 1
            }
        ],
        "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/audienceInfo01.do?authKey=YOUR_API_KEY&league_gubun=1&meet_year=2026&team_id=K01&sdate=2026/01/01&edate=2026/12/31";
Request request1 = new Request.Builder().url(url1).get().build();

// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/audienceInfo01.do?league_gubun=1&meet_year=2026&team_id=K01&sdate=2026/01/01&edate=2026/12/31";
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/audienceInfo01.do"
params = { 
    "league_gubun": "1", 
    "meet_year": "2026", 
    "team_id": "K01",
    "sdate": "2026/01/01",
    "edate": "2026/12/31"
}

# [방법 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/audienceInfo01.do';
const params = { 
    league_gubun: '1', 
    meet_year: '2026', 
    team_id: 'K01', 
    sdate: '2026/01/01', 
    edate: '2026/12/31' 
};

// [방법 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' } });