get
https://stage.openapi.sauce.im/sauce-live/stats/vod//broadcasts//members/download
VOD 방송 한 건의 회원별 시청 지표를 CSV 파일로 만들어 다운로드 URL 을 발급합니다.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
- 집계 구간은 방송 등록 일시 ~ 요청 시점, 즉 방송의 전체 시청 기록입니다.
- CSV 의 방송일시는 공개(편성) 시작 시각을 KST(yyyy-MM-dd HH:mm)로 표기하며, 값이 없으면 빈 칸입니다.
- 요청 시점에 CSV 파일을 생성해 업로드한 뒤 다운로드 URL 을 돌려줍니다(작업 등록·폴링 방식이 아님). 시청 회원이 많으면 응답이 오래 걸릴 수 있습니다.
- downloadUrl 은 인증 헤더 없이 GET 으로 내려받는 임시 URL 이며 expiresAt 이후에는 사용할 수 없습니다(현재 설정상 발급 후 최대 1시간).
- 호출할 때마다 생성 시각이 붙은 새 파일이 만들어지며 이전 파일을 덮어쓰지 않습니다.
- CSV 컬럼(16개, 순서 고정): 회원 ID, PV, 시청 시간, 상품 클릭수, 채팅수, 좋아요 수, 배너 클릭수, 슬롯 배너 클릭수, 방송 공유 클릭수, 쿠폰 클릭수, 이벤트 참여수, 리워드 참여수, 방송ID, 방송일시, 방송타이틀, 방송카테고리(중분류). 마지막 4개 방송 정보 컬럼은 모든 행이 같은 값입니다.
- 파일 형식: UTF-8(BOM 포함), 첫 줄 헤더, 회원 1명당 1줄, 줄바꿈 CRLF. 시청 기록이 없으면 헤더만 있는 파일입니다.
- 성공 응답은 다른 통계 API 와 같은
{"data": {...}}형태입니다. - 이 API 의 오류 응답 본문에는 traceId 가 없고(추적은 응답 헤더
X-Request-Id로 하세요) timestamp 가 밀리초 형식(예: 2026-10-28T01:23:45.202Z)입니다. 단, 없는 경로·버전 헤더 불일치(404 C003)와 허용되지 않는 메서드(405 C002)는 통계 API 와 같은 형식입니다.
오류
- 400 C001 — partnerId 형식 오류(4~20자, 영문·숫자 포함), broadcastId 형식 오류(5자 이상, 영문·숫자·-·_), VOD 경로에 Live 방송 ID(lk) 사용, 아직 시작하지 않은 방송
- 404 B001 — 해당 파트너에 broadcastId 방송이 없음(다른 파트너 방송도 404)
인증·권한·서버 오류 등 공통 오류는 오류 코드를 참고하세요.