api.video
  1. Analytics
api.video
  • Account
    • Show account
      GET
  • Analytics
    • List live stream player sessions
      GET
    • List player session events
      GET
    • List video player sessions
      GET
  • Authentication
    • Authenticate
      POST
    • Refresh token
      POST
  • Live
    • List all live streams
      GET
    • Create live stream
      POST
    • Delete a live stream
      DELETE
    • Show live stream
      GET
    • Update a live stream
      PATCH
    • Delete a thumbnail
      DELETE
    • Upload a thumbnail
      POST
  • Players
    • List all players
      GET
    • Create a player
      POST
    • Delete a player
      DELETE
    • Show a player
      GET
    • Update a player
      PATCH
    • Delete logo
      DELETE
    • Upload a logo
      POST
  • Videos - Delegated upload
    • Upload with an upload token
      POST
    • List all active upload tokens.
      GET
    • Generate an upload token
      POST
    • Delete an upload token
      DELETE
    • Show upload token
      GET
  • Videos
    • List all videos
    • Create a video
    • Delete a video
    • Show a video
    • Update a video
    • Upload a video
    • Show video status
    • Pick a thumbnail
    • Upload a thumbnail
  • Captions
    • List video captions
    • Delete a caption
    • Show a caption
    • Update caption
    • Upload a caption
  • Chapters
    • List video chapters
    • Delete a chapter
    • Show a chapter
    • Upload a chapter
  • Webhooks
    • List all webhooks
    • Create Webhook
    • Delete a Webhook
    • Show Webhook details
  1. Analytics

List player session events

GET
/analytics/sessions/{sessionId}/events
Analytics
Useful to track and measure video's engagement.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://ws.api.video/analytics/sessions/psEmFwGQUAXR2lFHj5nDOpy/events'
Response Response Example
200 - response
{
  "data": [
    {
      "at": 0,
      "emittedAt": "2020-09-15T09:47:42.000Z",
      "type": "ready"
    },
    {
      "at": 0,
      "emittedAt": "2020-09-15T21:35:57.000Z",
      "type": "play"
    },
    {
      "at": 7,
      "emittedAt": "2020-09-15T21:36:05.000Z",
      "type": "pause"
    },
    {
      "at": 21,
      "emittedAt": "2020-09-15T21:36:19.000Z",
      "type": "resume"
    },
    {
      "emittedAt": "2020-09-15T21:36:19.000Z",
      "from": 7,
      "to": 21,
      "type": "seek.forward"
    },
    {
      "at": 30,
      "emittedAt": "2020-09-15T21:36:28.000Z",
      "type": "end"
    },
    {
      "at": 0,
      "emittedAt": "2020-09-15T21:36:29.000Z",
      "type": "play"
    },
    {
      "emittedAt": "2020-09-15T21:36:29.000Z",
      "from": 30,
      "to": 0,
      "type": "seek.backward"
    },
    {
      "at": 21,
      "emittedAt": "2020-09-15T21:36:29.000Z",
      "type": "pause"
    },
    {
      "at": 21,
      "emittedAt": "2020-09-15T21:36:30.000Z",
      "type": "resume"
    },
    {
      "emittedAt": "2020-09-15T21:36:30.000Z",
      "from": 0,
      "to": 21,
      "type": "seek.forward"
    },
    {
      "at": 20,
      "emittedAt": "2020-09-15T21:36:33.000Z",
      "type": "pause"
    },
    {
      "at": 20,
      "emittedAt": "2020-09-15T21:36:33.000Z",
      "type": "resume"
    },
    {
      "emittedAt": "2020-09-15T21:36:33.000Z",
      "from": 24,
      "to": 20,
      "type": "seek.backward"
    },
    {
      "at": 17,
      "emittedAt": "2020-09-15T21:36:39.000Z",
      "type": "pause"
    },
    {
      "at": 17,
      "emittedAt": "2020-09-15T21:36:39.000Z",
      "type": "resume"
    },
    {
      "emittedAt": "2020-09-15T21:36:39.000Z",
      "from": 17,
      "to": 17,
      "type": "seek.forward"
    },
    {
      "at": 19,
      "emittedAt": "2020-09-15T21:36:41.000Z",
      "type": "pause"
    },
    {
      "at": 0,
      "emittedAt": "2020-09-17T09:20:47.000Z",
      "type": "ready"
    },
    {
      "at": 0,
      "emittedAt": "2020-09-17T09:41:01.000Z",
      "type": "ready"
    },
    {
      "at": 0,
      "emittedAt": "2020-09-17T09:41:08.000Z",
      "type": "ready"
    },
    {
      "at": 0,
      "emittedAt": "2020-09-17T09:41:10.000Z",
      "type": "play"
    },
    {
      "at": 1,
      "emittedAt": "2020-09-17T09:41:12.000Z",
      "type": "pause"
    },
    {
      "at": 1,
      "emittedAt": "2020-09-17T09:41:13.000Z",
      "type": "resume"
    },
    {
      "at": 3,
      "emittedAt": "2020-09-17T09:41:15.000Z",
      "type": "pause"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "currentPageItems": 25,
    "itemsTotal": 30,
    "links": [
      {
        "rel": "self",
        "uri": "/analytics/sessions/ps5ltuhfsTOeh6bP03Tq5OWc/events?currentPage=1&pageSize=25"
      },
      {
        "rel": "first",
        "uri": "/analytics/sessions/ps5ltuhfsTOeh6bP03Tq5OWc/events?currentPage=1&pageSize=25"
      },
      {
        "rel": "next",
        "uri": "/analytics/sessions/ps5ltuhfsTOeh6bP03Tq5OWc/events?currentPage=2&pageSize=25"
      },
      {
        "rel": "last",
        "uri": "/analytics/sessions/ps5ltuhfsTOeh6bP03Tq5OWc/events?currentPage=2&pageSize=25"
      }
    ],
    "pageSize": 25,
    "pagesTotal": 2
  }
}

Request

Path Params
sessionId
string 
required
A unique identifier you can use to reference and track a session with.
Example:
psEmFwGQUAXR2lFHj5nDOpy
Query Params
currentPage
integer 
optional
Choose the number of search results to return per page. Minimum value: 1
Example:
2
pageSize
integer 
optional
Results per page. Allowed values 1-100, default is 25.
Example:
30

Responses

🟢200Success
application/json
Body
data
array[object (Player Session Event) {5}] 
optional
at
integer 
optional
emittedAt
string <date-time>
optional
When an event occurred, presented in ISO-8601 format.
Example:
2019-06-24T11:45:01.109Z
from
integer 
optional
to
integer 
optional
type
string 
optional
Possible values are: ready, play, pause, resume, seek.backward, seek.forward, end
Example:
play
pagination
object (Pagination) 
optional
Example:
{"currentPage":3,"currentPageItems":20,"itemsTotal":123,"links":{"first":{"rel":"first","uri":"/videos/search?currentPage=1&pageSize=20"},"last":{"rel":"last","uri":"/videos/search?currentPage=6&pageSize=20"},"next":{"rel":"next","uri":"/videos/search?currentPage=4&pageSize=20"},"previous":{"rel":"previous","uri":"/videos/search?currentPage=2&pageSize=20"}},"pageSize":20,"pagesTotal":7}
currentPage
integer 
read-onlyoptional
The current page index.
currentPageItems
integer 
read-onlyoptional
The number of items on the current page.
itemsTotal
integer 
read-onlyoptional
Total number of items that exist.
links
array[object (PaginationLink) {2}] 
required
pageSize
integer 
read-onlyoptional
Maximum number of item per page.
pagesTotal
integer 
read-onlyoptional
Number of items listed in the current page.
🟠404Not Found
Modified at 2023-08-15 05:52:15
Previous
List live stream player sessions
Next
List video player sessions
Built with