실시간 시청자 수 조회

Classic/VPC 환경에서 이용 가능합니다.

플레이어에서 측정되는 실시간 시청자 수를 1분 단위로 1시간 데이터를 차트 형식으로 조회합니다. 현재 시간으로부터 60분(1시간) 데이터가 기준입니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

요청 헤더

Video Player Enhancement API에서 공통으로 사용하는 헤더에 대한 정보는 Video Player Enhancement 요청 헤더를 참조해 주십시오.

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://ma-dashboard-api.vpe.naverncp.com/v1/charts/currentViewers?device=PC,Mobile&videoType=VOD,LIVE' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project id}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

응답 상태 코드

Video Player Enhancement API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Video Player Enhancement 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
	"code": 200,
	"message": "currentViewers (1m)",
	"result": [
		{
			"currentViewerCnt": 0,
			"logDate": "2025-10-09 16:23:00"
		},
		{
			"currentViewerCnt": 0,
			"logDate": "2025-10-09 16:22:00"
		},
		{
			"currentViewerCnt": 0,
			"logDate": "2025-10-09 16:21:00"
		},
        ...
		{
			"currentViewerCnt": 0,
			"logDate": "2025-10-09 15:25:00"
		},
		{
			"currentViewerCnt": 0,
			"logDate": "2025-10-09 15:24:00"
		},
		{
			"currentViewerCnt": 0,
			"logDate": "2025-10-09 15:23:00"
		}
	]
}