기본 용어

용어	설명
채널(FC)	파트너사가 직접 설정한 유입 경로입니다. 예: 마케팅 랜딩 페이지, 캠페인 링크. 응답의 `fc` 값은 파트너사가 설정한 채널 값 그대로입니다. 채널(FC) 설정 가이드
리퍼러(Referrer)	외부 사이트를 거쳐 플레이어로 들어온 경로입니다. 응답의 `referrer` 값이며, 참고용 데이터로 보세요.
LIVE / PRE_LIVE	`LIVE` 는 라이브 진행·송출된 방송, `PRE_LIVE` 는 아직 시작 전인 예정(예고) 방송입니다. 알림받기 지표는 `PRE_LIVE` 에서만 값이 있습니다.
Live / VOD	Live 는 실시간 방송(방송 ID `lk…`), VOD 는 다시보기·캐치업(방송 ID `vc…`, `vk…`)입니다. 경로의 `/live/`, `/vod/` 와 방송 ID 종류가 맞아야 합니다.
UV / PV	UV 는 중복을 뺀 시청자 수, PV 는 조회 수입니다.
시청 시간	`playtime`, `averagePlaytime` 은 모두 초 단위입니다.

응답 필드

75개 필드

필드	타입	설명
`ageCode`	array	연령대별 UV 배열 [{key, uv}]. key: 10, 20, 30, 40, 50, 60(연령대), etc(기타). key 오름차순.
`alarmClickAverageCount`	number	방송당 평균 알림받기(신청) 클릭수(소수 첫째 자리 반올림). 기간 내 방송이 없거나 PRE_LIVE 가 아니면 0
`alarmClickCount`	integer	알림받기(신청) 클릭수. 방송 등록 ~ 실제 방송 시작 전(시작 전이면 조회 시점까지) 누적, 쇼룸 + 라이브 예고 화면 합산. broadcastStatus=PRE_LIVE 가 아니면 0
`alarmClickTotalCount`	integer	기간 내 방송의 알림받기(신청) 클릭수 합계. broadcastStatus=PRE_LIVE 가 아니면 0
`alarmRegisterAverageCount`	number	방송당 평균 알림 등록 유지 수(소수 첫째 자리 반올림). 기간 내 방송이 없거나 PRE_LIVE 가 아니면 0
`alarmRegisterCount`	integer	조회 시점에 알림 등록을 유지 중인 수. broadcastStatus=PRE_LIVE 가 아니면 0
`alarmRegisterTotalCount`	integer	기간 내 방송의 알림 등록 유지 수 합계(조회 시점 기준). PRE_LIVE 가 아니면 0
`averageBannerClickCount`	integer	방송당 평균 배너 클릭 수
`averageChatCount`	integer	방송당 평균 채팅 수
`averageCouponClickCount`	integer	방송당 평균 쿠폰 클릭 수
`averageDailyBroadcastCount`	number	일평균 방송 수. 방송 수 ÷ 조회 일수(1일 미만은 1일로 올림), 소수 첫째 자리 내림
`averageEventParticipationCount`	integer	방송당 평균 이벤트 참여 수
`averageLikeCount`	integer	방송당 평균 좋아요 수
`averagePlaytime`	integer	평균 시청 시간(초), 소수점 이하 버림. 방송 단위 응답(방송 목록·방송 요약·방송 시계열·채널별·유입 경로별, 시계열의 `broadcastList` 항목)은 총 시청 시간 ÷ UV, 기간 요약과 기간 시계열은 총 시청 시간 ÷ 방송 수입니다. 어드민 통계와 같은 기준입니다.
`averageProductClickCount`	integer	방송당 평균 상품 클릭 수
`averageProductOrderAmount`	integer	방송당 평균 상품 주문 금액(원, KRW)
`averageProductOrderCancelCount`	integer	방송당 평균 상품 주문 취소 건수
`averageProductOrderCount`	integer	방송당 평균 상품 주문 건수
`averageProductOrderQuantity`	integer	방송당 평균 상품 주문 수량
`averagePurchaseVerifyingCount`	integer	방송당 평균 구매 인증 수(집계 기준은 추후 안내)
`averagePV`	integer	방송당 평균 조회수(PV)
`averageQuizNewCount`	integer	방송당 평균 신규 퀴즈 수(집계 기준은 추후 안내)
`averageRewardNewCount`	integer	방송당 평균 신규 리워드 수(집계 기준은 추후 안내)
`averageShareClickCount`	integer	방송당 평균 공유 클릭 수
`averageSlotBannerClickCount`	integer	방송당 평균 슬롯 배너 클릭 수
`averageUV`	integer	방송당 평균 시청자 수(UV)
`bannerClickCount`	integer	배너 클릭 수
`broadcastCount`	integer	기간 내 방송 수
`broadcastId`	string	방송 ID
`broadcastList`	array	해당 버킷에 속한 방송 목록(항목 구조는 방송 목록 조회와 같음)
`broadcastName`	string	방송명
`broadcastStartDt`	string (date-time, UTC Z)	방송 시작 시각. ISO-8601 UTC(Z). 값이 없으면 `null`
`broadcastThumbnailUrl`	string	방송 썸네일 URL
`chatCount`	integer	채팅 수
`couponClickCount`	integer	쿠폰 클릭 수
`data`	object \| array	응답 본문. 요약·분포 묶음은 객체, 목록·시계열·채널별·유입 경로별·OS 별 결과는 배열입니다
`downloadUrl`	string	CSV 다운로드 URL(서명된 임시 URL). 인증 헤더 없이 GET
`eventParticipationCount`	integer	이벤트 참여 수
`expiresAt`	string (date-time, UTC Z)	downloadUrl 만료 시각. ISO-8601 UTC, 밀리초 3자리(예: 2026-10-28T02:33:45.202Z)
`externalProductId`	string	외부 쇼핑몰(파트너) 상품 ID
`fc`	string	채널(FC) 값. 파트너사가 설정한 채널 값이 그대로 내려갑니다
`genderCode`	array	성별 UV 배열 [{key, uv}]. key: w(여성), m(남성), e(기타). key 오름차순.
`interval`	string	버킷 단위(ISO-8601 duration). `PT1M`, `PT10M`, `PT1H`, `P1D` 중 하나이며 API 마다 다릅니다
`key`	string	분포 `[{key, uv}]` 에서는 코드 값이며, 코드표 밖의 값이 올 수 있으니 모르는 값은 '기타'로 처리하세요. 채널별·유입 경로별 시계열에서는 해당 `fc`·`referrer` 값이며 `null` 일 수 있습니다
`likeCount`	integer	좋아요 수
`memberTypeCode`	array	회원유형별 UV 배열 [{key, uv}]. key: 0=비회원, 1=회원, 2=관리자. key 오름차순.
`meta`	object	시계열 응답에만 있으며 `interval` 하나만 담습니다. 그 외 응답에는 `meta` 키가 없습니다
`os`	array	OS별 UV 배열 [{key, uv}]. key: Android, iOS, Mac OS, Windows, Etc. key 오름차순.
`pastTime`	string	방송 시작으로부터 경과 시간. HH:mm 형식이며 24시간을 넘으면 시간이 24 이상(예: 25:10)
`playtime`	integer	총 시청 시간(초)
`price`	string	정가(서버 원본 값 문자열)
`priceTypeCode`	string	가격 유형 코드(서버 원본 값). 코드표는 추후 안내
`productClickCount`	integer	상품 클릭 수
`productClickRatio`	number	상품 클릭률(%). 해당 상품 클릭 수 × 100 ÷ 방송 전체 상품 클릭 수
`productId`	string	상품 ID
`productName`	string	상품명
`productOrderAmount`	integer	상품 주문 금액(원, KRW)
`productOrderCancelCount`	integer	상품 주문 취소 건수
`productOrderCount`	integer	상품 주문 건수
`productOrderQuantity`	integer	상품 주문 수량
`programmingStartDt`	string (date-time, UTC Z)	라이브는 편성(예정) 시작 시각, VOD(캐치업 포함)는 공개 시각. ISO-8601 UTC(Z). 값이 없으면 `null`
`purchaseVerifyingCount`	integer	구매 인증 수(집계 기준은 추후 안내)
`pv`	integer	조회수(PV)
`quizNewCount`	integer	신규 퀴즈 수(집계 기준은 추후 안내)
`referrer`	string	유입경로(referrer) 구분 값(서버 원본 값). 값 목록은 추후 안내
`regDt`	string (date-time, UTC Z)	등록 일시. ISO-8601 UTC(Z). 정확한 기준은 추후 안내
`representativeProductThumbnailUrl`	string	대표 상품 썸네일 URL
`rewardNewCount`	integer	신규 리워드 수(집계 기준은 추후 안내)
`sellingPrice`	number	최종 판매가(할인 적용)
`shareClickCount`	integer	공유 클릭 수
`slotBannerClickCount`	integer	슬롯 배너 클릭 수
`statsDateTime`	string (date-time, UTC Z)	버킷 시작 시각. ISO-8601 UTC(Z). 기간 시계열은 `meta.interval`(일 버킷은 KST 자정 T15:00:00Z, 시간 버킷은 정시), 라이브 방송 시계열은 요청한 단위(1분·10분·1시간), 채널별·유입 경로별 시계열은 1분 단위입니다
`user`	object	시청자 분포(회원유형·OS·연령·성별 UV)
`uv`	integer	시청자 수(UV). 분포 `[{key, uv}]` 의 `uv` 는 값이 없으면 `null` 일 수 있습니다(보통은 0)
`values`	array	1분 단위 지표 목록(statsDateTime 오름차순)