Get recent session list

Available in Classic and VPC

Get the most recent 100 sessions for a user using the player. The data interval varies depending on the time span between the start and end points of the query.

Time span between start time and end time	Interval
1 day or less	5-minute interval
2 days or more	1-day interval

Request

This section describes the request format. The method and URI are as follows:

Method	URI
GET	/v1/sessionRecent

Request headers

For information about the headers common to all Video Player Enhancement APIs, see Video Player Enhancement request headers.

Request query parameters

You can use the following query parameters with your request:

Field	Type	Required	Description
`device`	String	Optional	Player playback environment `PC,Mobile` (default) \| `PC` \| `Mobile`
`videoType`	String	Optional	Playback source type `VOD,LIVE` (default) \| `VOD` \| `LIVE` `VOD,LIVE`: VOD video, LIVE stream `VOD`: VOD video `LIVE`: LIVE stream
`startDate`	Date	Optional	Query start date and time Date format (UTC)
`endDate`	Date	Optional	Query end date and time Date format (UTC)
`limit`	Integer	Optional	Number of sessions N-100

Request example

The request example is as follows:

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

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`code`	String	-	Response code
`message`	String	-	Response message
`result`	Array	-	Session information

`result`

The following describes result.

Field	Type	Required	Description
`no`	Integer	-	Number
`logDate`	Date	-	Session creation date and time
`uuid`	String	-	Unique user ID UUID format
`origin`	String	-	Calling domain
`os`	String	-	Operating system information
`device`	String	-	Player playback environment `PC,Mobile` \| `PC` \| `Mobile`
`totalStartTime`	Integer	-	Time taken until playback completion report (second)
`rebufferingTime`	Integer	-	Buffering time (second)
`playingTime`	Integer	-	Playback time (second)
`isError`	Boolean	-	Error status `true` \| `false` `true`: Error `false`: Not an error
`sessionLog`	Array	-	Session log (player action cycle log)

`sessionLog`

The following describes sessionLog.

Field	Type	Required	Description
`logDate`	Date	-	Session creation date and time
`uuid`	String	-	Unique user ID UUID format
`videoTime`	String	-	Play time
`actionType`	String	-	Action type: Event information corresponding to Media Analytics usage `player_start` \| `startup` \| `playing` \| `paused` \| `seeking` \| `rebuffering` \| `prev_tarck` \| `next_track` \| `ended` \| `error` `player_start`: Player started (player ready to play after VPE authentication succeeded) `startup`: Playback successful (user successfully played the first screen of the video after attempting to play it) `playing`: Playback time (reports events every 60 seconds; reports immediately if another event occurs before 60 seconds) `paused`: Stop button clicked `seeking`: Buffering occurred when navigating videos or changing resolution `rebuffering`: Buffering occurred due to insufficient data for the video being played (excluded for `seeking`) `prev_tarck`: Previous video button clicked `next_track`: Next video button clicked `ended`: Video watched to the end (When set to repeat playback, `seeking` occurs at 0 seconds, preventing `ended` from triggering.) `error`: Error occurred
`actionDuration`	Integer		Time taken to complete (second)

Response status codes

For information about the HTTP status codes common to all Video Player Enhancement APIs, see Common Video Player Enhancement response status codes.

Response example

The response example is as follows:

{
	"code": 200,
	"message": "sessionRecent (1d)",
	"result": [
		{
			"logDate": "2025-10-10 09:54:38",
			"no": "14611077",
			"uuid": "ad5aea06-fb78-41c7-b2ad-716b685e32db",
			"origin": "https://mediaplus-demo.web.app",
			"os": "Mac OS / 10.15.7 ↑",
			"device": "PC",
			"totalStartTime": 2.4,
			"rebufferingTime": 0.195,
			"playingTime": 244.624,
			"isError": false,
			"sessionLog": [
				{
					"logDate": "2025-10-10 09:49:46",
					"videoTime": "00:00:00",
					"actionType": "player_start",
					"actionDuration": 5,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:49:46",
					"videoTime": "00:00:00",
					"actionType": "startup",
					"actionDuration": 352,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:50:16",
					"videoTime": "00:00:30",
					"actionType": "playing",
					"actionDuration": 30057,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
                ...
				{
					"logDate": "2025-10-10 09:54:23",
					"videoTime": "00:00:00",
					"actionType": "startup",
					"actionDuration": 239,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:54:38",
					"videoTime": "00:00:15",
					"actionType": "playing",
					"actionDuration": 14978,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:54:38",
					"videoTime": "00:00:15",
					"actionType": "ended",
					"actionDuration": 0,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				}
			]
		}
	]
}