---
title: "Live 회원별 시청 데이터 다운로드"
method: GET
path: "/sauce-live/stats/live/{partnerId}/broadcasts/{broadcastId}/members/download"
---

# Live 회원별 시청 데이터 다운로드

`GET /sauce-live/stats/live/{partnerId}/broadcasts/{broadcastId}/members/download`

## Request

- Base URL: `https://stage.openapi.sauce.im`
- URL: `https://stage.openapi.sauce.im/sauce-live/stats/live/{partnerId}/broadcasts/{broadcastId}/members/download`
- Auth: HTTP bearer

Live 방송 한 건의 회원별 시청 지표를 CSV 파일로 만들어 다운로드 URL 을 발급합니다.

## Path parameters

- `partnerId` string, required
- `broadcastId` string, required

## Headers

- `x-api-version` string, required
- `X-Request-Id` string

## Response `200`

성공

- object
  - `data` object: 다운로드 정보
    - `broadcastId` string: 요청한 방송 ID(여러 방송을 연속 호출할 때 요청·응답 매칭용)
    - `downloadUrl` string: CSV 다운로드 URL(서명된 임시 URL). 인증 헤더 없이 GET
    - `expiresAt` string, date-time: downloadUrl 만료 시각. ISO-8601 UTC, 밀리초 3자리(예: 2026-10-28T02:33:45.202Z)

## Other responses

- `400`: Bad Request — 요청 값 오류. C001: partnerId 형식 오류(4~20자, 영문·숫자 포함), broadcastId 형식 오류(5자 이상, 영문·숫자·-·_), Live 경로에 VOD 방송 ID 사용, 아직 시작하지 않은 방송
- `401`: Unauthorized — 토큰 없음(G001), 토큰 오류(G002), 토큰 만료(G003), 폐기된 토큰(G004)
- `403`: Forbidden — 이 API 권한 없음(G005), 경로의 partnerId 가 토큰의 파트너와 다름(U008)
- `404`: Not Found — /sauce-live/stats/ 아래의 없는 경로 또는 x-api-version 헤더 누락·불일치(C003), 해당 파트너에 방송이 없음(B001)
- `405`: Method Not Allowed — GET 이 아닌 메서드(C002). 응답 헤더 Allow: GET
- `429`: Too Many Requests — 파트너별 호출 한도(초당 20회) 초과. 본문 없이 응답합니다. `Retry-After` 초만큼 기다린 뒤 재시도합니다.
- `500`: Internal Server Error — 서버 오류(C004). 이 API 의 오류 본문에는 traceId 가 없고 timestamp 가 밀리초입니다. 응답 헤더 X-Request-Id 로 문의
- `502`: API 서버에 연결하지 못함(G013)
- `503`: Service Unavailable — 요청이 몰려 처리 대기열이 가득 참(G011) 또는 인증 시스템 일시 장애(G009). 잠시 후 재시도
- `504`: API 서버가 60초 안에 응답하지 못함(G012)

---

[API](https://skmtc.dev/sauce/apis/saucelive-open-api.md) - [All operations](https://skmtc.dev/sauce/apis/saucelive-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sauce/apis/saucelive-open-api/revisions/ce228e9cc5c6?raw)