규칙 내용 위반 시 파라미터 searchStartDt(포함) ~ searchEndDt(미포함)400 C001최대 기간 31일 400 OA002시작 시각 현재보다 미래이면 안 됨 400 C001일 단위 API 두 값 모두 KST 자정(UTC T15:00:00Z) 400 OA001
KST 요청 값(UTC) 시작(포함) 2026-10-13 00:00 2026-10-12T15:00:00Z종료(미포함) 2026-10-20 00:00 2026-10-19T15:00:00Z
KST 자정은 UTC 로 전날 15:00 입니다. 날짜만 알면 아래처럼 바꿀 수 있습니다.
조회하려는 기간 (KST) searchStartDt searchEndDt 10월 13일 하루 2026-10-12T15:00:00Z2026-10-13T15:00:00Z10월 13일 ~ 19일 (7일) 2026-10-12T15:00:00Z2026-10-19T15:00:00Z10월 한 달 (31일) 2026-09-30T15:00:00Z2026-10-31T15:00:00Z
종료 시각은 마지막 날의 다음 날 자정 입니다(미포함).
Java Kotlin Python Node
import java.time.*;
ZoneId KST = ZoneId.of("Asia/Seoul");
// KST 날짜 [from, to) → UTC 문자열
String start = LocalDate.of(2026, 10, 13).atStartOfDay(KST).toInstant().toString(); // 2026-10-12T15:00:00Z
String end = LocalDate.of(2026, 10, 20).atStartOfDay(KST).toInstant().toString(); // 2026-10-19T15:00:00Z
// 어제 하루
LocalDate today = LocalDate.now(KST);
String yStart = today.minusDays(1).atStartOfDay(KST).toInstant().toString();
String yEnd = today.atStartOfDay(KST).toInstant().toString();import java.time.*
val KST: ZoneId = ZoneId.of("Asia/Seoul")
fun kstMidnightUtc(date: LocalDate): String =
date.atStartOfDay(KST).toInstant().toString()
val start = kstMidnightUtc(LocalDate.of(2026, 10, 13)) // 2026-10-12T15:00:00Z
val end = kstMidnightUtc(LocalDate.of(2026, 10, 20)) // 2026-10-19T15:00:00Z
// 어제 하루
val today = LocalDate.now(KST)
val yStart = kstMidnightUtc(today.minusDays(1))
val yEnd = kstMidnightUtc(today)from datetime import date, datetime, timedelta, timezone
from zoneinfo import ZoneInfo
KST = ZoneInfo("Asia/Seoul")
def kst_midnight_utc(d: date) -> str:
dt = datetime(d.year, d.month, d.day, tzinfo=KST).astimezone(timezone.utc)
return dt.strftime("%Y-%m-%dT%H:%M:%SZ")
start = kst_midnight_utc(date(2026, 10, 13)) # 2026-10-12T15:00:00Z
end = kst_midnight_utc(date(2026, 10, 20)) # 2026-10-19T15:00:00Z
# 어제 하루
today = datetime.now(KST).date()
y_start, y_end = kst_midnight_utc(today - timedelta(days=1)), kst_midnight_utc(today)// KST 는 서머타임이 없어 항상 UTC+9 입니다.
function kstMidnightUtc(y, m, d) {
return new Date(Date.UTC(y, m - 1, d) - 9 * 3600 * 1000)
.toISOString().replace('.000Z', 'Z');
}
const start = kstMidnightUtc(2026, 10, 13); // 2026-10-12T15:00:00Z
const end = kstMidnightUtc(2026, 10, 20); // 2026-10-19T15:00:00Z각 API 페이지 상단의 기간 규칙으로 확인할 수 있습니다.
기간 규칙 뜻 API 수 기간: KST 자정 필요 두 값 모두 KST 자정(T15:00:00Z) 31 기간: PRE_LIVE 일 때 KST 자정 broadcastStatus=PRE_LIVE 일 때만 KST 자정 1 기간: 일=KST 자정 · 시간=정시 일 단위 버킷이면 KST 자정, 시간 단위면 정시 2 기간: 정렬 불필요 아무 UTC 시각이나 가능. 그 구간에 시작한 방송을 집계 17 기간: 기간 없음 방송 단위 API. 방송 시작~종료가 집계 구간 15
기간 시계열은 서버가 단위를 정합니다. KST 하루 안이면 PT1H(시간), 그보다 길면 P1D(일)입니다.
정해진 단위는 응답 meta.interval 에 담깁니다.
라이브 방송 시계열만 1m/10m/1h 중에서 직접 고릅니다. 라이브 방송의 채널별·유입 경로별 시계열은 1분 단위로 고정입니다.
연령·성별·OS·회원 유형 분포는 배열로 내려갑니다. 모르는 key 는 "기타"로 처리하세요.
필드 key ageCode10~60, etcgenderCodew 여성, m 남성, e 기타osAndroid, iOS, Mac OS, Windows, EtcmemberTypeCode0 비회원, 1 회원, 2 관리자
code HTTP 언제 OA001400 일 단위 API 인데 기간이 KST 자정(또는 시간 단위 API 인데 정시)에 맞지 않음 OA002400 조회 기간이 31일 초과
