방송에 대한 통계 정보를 가져온다. 누적 시청자는 방송이 종료된 후에 조회 가능하며, interval을 사용하여 누적 시청자 추이 간격을 조절할 수 있다.
HTTP 요청
GET /api/2/applications/{app_key}/videos/{video_key}/stats
경로 변수
키 | 타입 | 필수여부 | 설명 |
---|
app_key | string | true | 애플리케이션의 키 |
video_key | string | true | 비디오의 키 |
요청 파라미터
키 | 타입 | 필수여부 | 설명 |
---|
interval | string | true | 누적 시청자 추이 간격(분). 기본값은 10 |
응답 본문
방송 통계 객체
키 | 타입 | 설명 |
---|
total_watcher_count | long | 누적 시청자 수 |
live_watcher_count | long | 라이브 시청자 수 |
max_watcher_count | long | 최대 시청자 수 |
total_message_count | long | 전체 채팅 메시지 개수 |
like_count | long | 좋아요 수 |
heart_count | long | 하트 수 |
avg_live_watch_time | long | 평균 시청 시간 (초) |
total_watcher_trend | Array | 누적 시청자 추이 객체 Array |
vod | Object | VOD 시청 통계. 기본 통계 객체 |
preview | Object | Preview 시청 통계. 기본 통계 객체 |
기본 통계 객체
키 | 타입 | 설명 |
---|
view_count | long | 조회 수 |
avg_watch_count | long | 평균 시청 시간 (초) |
누적 시청자 추이 객체
키 | 타입 | 설명 |
---|
time | long | 방송 시작 후 시간 (분) |
total_watcher_count | long | 누적 시청자 수 |
요청 예
응답 예
Http Status | 설명 |
---|
200 | {"total_watcher_count": 0, "max_watcher_count":0, "total_message_count": 0, "avg_live_watch_time": 0, "like_count": 0, "total_watcher_trend":[], "vod":{"view_count": 0,"avg_watch_time": 0 }, "preview":{ "view_count": 0, "avg_watch_time": 0} |
400 | {"code": 40000, "message": "Invalid user_id: valid value of 'user_id' is range 1 to 80."} |