---
title: "유니크 사용자 수 조회"
slug: "vpe-api-uniqusercnt"
updated: 2026-10-22T10:47:44Z
published: 2026-10-22T10:47:44Z
canonical: "api-gov.ncloud-docs.com/vpe-api-uniqusercnt"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 유니크 사용자 수 조회

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

플레이어를 통해 재생을 시도한 사용자의 합계를 차트 형식으로 조회합니다. 조회 시작 시점과 종료 시점 간의 간격에 따라 데이터 인터벌이 달라집니다.

| 시작 시점과 종료 시점 간격 | 인터벌 |
| --- | --- |
| 1일 이하 | 5분 단위 |
| 2일 이상 | 1일 단위 |

## 요청

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

| 메서드 | URI |
| --- | --- |
| GET | /v1/charts/uniqUserCnt |

### 요청 헤더

Video Player Enhancement API에서 공통으로 사용하는 헤더에 대한 정보는 [Video Player Enhancement 요청 헤더](/docs/vpe-api-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 쿼리 파라미터

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `device` | String | Optional | 플레이어 재생 환경 - `PC,Mobile` (기본값)\| `PC` \| `Mobile` |
| `videoType` | String | Optional | 재생 소스 구분 - `VOD,LIVE` (기본값) \| `VOD` \| `LIVE` - `VOD,LIVE`: VOD 비디오, LIVE 스트림 - `VOD`: VOD 비디오 - `LIVE`: LIVE 스트림 |
| `startDate` | Date | Optional | 조회 시작 일시 - 날짜 형식(UTC) |
| `endDate` | Date | Optional | 조회 종료 일시 - 날짜 형식(UTC) |

### 요청 예시

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

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

## 응답

응답 형식을 설명합니다.

### 응답 바디

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `code` | String | - | 응답 코드 |
| `message` | String | - | 응답 메시지 |
| `result` | Object | - | 응답 결과 |
| `result.uniqUsers` | Integer | - | 유니크 사용자 수 |
| `result.logDate` | Date | - | 일시 |

### 응답 상태 코드

Video Player Enhancement API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Video Player Enhancement 응답 상태 코드](/docs/vpe-api-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

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

```
{
	"code": 200,
	"message": "uniqUserCnt (1d)",
	"result": [
		{
			"uniqUsers": 1,
			"logDate": "2025-10-10 00:00:00"
		},
		{
			"uniqUsers": 2,
			"logDate": "2025-10-09 00:00:00"
		},
		{
			"uniqUsers": 1,
			"logDate": "2025-10-08 00:00:00"
		},
		{
			"uniqUsers": 1,
			"logDate": "2025-10-07 00:00:00"
		},
		{
			"uniqUsers": 0,
			"logDate": "2025-10-06 00:00:00"
		},
		{
			"uniqUsers": 0,
			"logDate": "2025-10-05 00:00:00"
		},
		{
			"uniqUsers": 2,
			"logDate": "2025-10-04 00:00:00"
		},
		{
			"uniqUsers": 2,
			"logDate": "2025-10-03 00:00:00"
		},
		{
			"uniqUsers": 4,
			"logDate": "2025-10-02 00:00:00"
		},
		{
			"uniqUsers": 2,
			"logDate": "2025-10-01 00:00:00"
		}
	]
}
```