---
title: "채널별 시청자 조회"
method: GET
path: "/sauce-live/stats/vod/{partnerId}/audience/fc"
---

# 채널별 시청자 조회

`GET /sauce-live/stats/vod/{partnerId}/audience/fc`

## Request

- Base URL: `https://stage.openapi.sauce.im`
- URL: `https://stage.openapi.sauce.im/sauce-live/stats/vod/{partnerId}/audience/fc`
- Auth: HTTP bearer

조회 기간의 VOD 방송 시청자 분포(회원유형·OS·연령·성별)를 채널(fc)별로 조회합니다.

## Path parameters

- `partnerId` string, required

## Query parameters

- `searchStartDt` string, date-time, required
- `searchEndDt` string, date-time, required

## Headers

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

## Response `200`

성공

- object
  - `data` object[]: 채널별 시청자 분포 목록
    - `fc` string, nullable: 채널(FC) 값. 파트너사가 설정한 채널 값이 그대로 내려갑니다
    - `user` object: 시청자 분포(회원유형·OS·연령·성별 UV)
      - `memberTypeCode` object[]: 회원유형별 UV 배열 [{key, uv}]. key: 0=비회원, 1=회원, 2=관리자. key 오름차순.
        - `key` string: 코드 값(서버 원본 값). 코드표 밖의 값이 올 수 있으니 모르는 값은 '기타'로 처리하세요.
        - `uv` integer, nullable: 해당 key 의 시청자 수(UV). 값이 없으면 null
      - `os` object[]: OS별 UV 배열 [{key, uv}]. key: Android, iOS, Mac OS, Windows, Etc. key 오름차순.
        - `key` string: 코드 값(서버 원본 값). 코드표 밖의 값이 올 수 있으니 모르는 값은 '기타'로 처리하세요.
        - `uv` integer, nullable: 해당 key 의 시청자 수(UV). 값이 없으면 null
      - `ageCode` object[]: 연령대별 UV 배열 [{key, uv}]. key: 10, 20, 30, 40, 50, 60(연령대), etc(기타). key 오름차순.
        - `key` string: 코드 값(서버 원본 값). 코드표 밖의 값이 올 수 있으니 모르는 값은 '기타'로 처리하세요.
        - `uv` integer, nullable: 해당 key 의 시청자 수(UV). 값이 없으면 null
      - `genderCode` object[]: 성별 UV 배열 [{key, uv}]. key: w(여성), m(남성), e(기타). key 오름차순.
        - `key` string: 코드 값(서버 원본 값). 코드표 밖의 값이 올 수 있으니 모르는 값은 '기타'로 처리하세요.
        - `uv` integer, nullable: 해당 key 의 시청자 수(UV). 값이 없으면 null

## Other responses

- `400`: Bad Request — 요청 값 오류. C001: 필수 파라미터 누락, 날짜 형식 오류(Z 아님·소수 초), searchStartDt ≥ searchEndDt, 시작 시각이 미래, partnerId 형식 오류 / OA001: searchStartDt/searchEndDt 가 KST 자정(T15:00:00Z) 경계에 맞지 않음 / OA002: 조회 기간이 31일 초과
- `401`: Unauthorized — 토큰 없음(G001), 토큰 오류(G002), 토큰 만료(G003), 폐기된 토큰(G004)
- `403`: Forbidden — 이 API 권한 없음(G005), 경로의 partnerId 가 토큰의 파트너와 다름(U008)
- `404`: Not Found — /sauce-live/stats/ 아래의 없는 경로 또는 x-api-version 헤더 누락·불일치(C003)
- `405`: Method Not Allowed — GET 이 아닌 메서드(C002). 응답 헤더 Allow: GET
- `429`: Too Many Requests — 파트너별 호출 한도(초당 20회) 초과. 본문 없이 응답합니다. `Retry-After` 초만큼 기다린 뒤 재시도합니다.
- `500`: Internal Server Error — 서버 오류(C004). traceId 와 함께 문의
- `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)