ユニークユーザー数の照会

Prev Next

Classic/VPC環境で利用できます。

プレイヤーを通じて再生を試みたユーザーの合計をチャート形式で照会します。照会開始点と終了点の間隔に応じてデータ間隔が異なります。

開始点と終了点の間隔 インターバル
1日以下 5分単位
2日以上 1日単位

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET /v1/charts/uniqUserCnt

リクエストヘッダ

Video Player Enhancement APIで共通して使用されるヘッダの詳細は、Video Player Enhancementのリクエストヘッダをご参照ください。

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
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.naverncp.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のレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
	"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"
		}
	]
}