Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Streaming Statistics

Get heatmap in built-in player

Shows information about what part of the video your viewers watched in the built-in player.

This way you can find out how many viewers started watching the video, and where they stopped watching instead of watching the entire video to the end.

Has different format of response depends on query param "type".

Note. This method operates only on data collected by the built-in HTML player. It will not show statistics if you are using another player or viewing in native OS players through direct .m3u8/.mpd/.mp4 links. For such cases, use calculations through CDN (look at method /statistics/cdn/uniqs) or statistics of the players you have chosen.

get/streaming/statistics/heatmap

Query parameters

date_fromstring required

Start of time frame. Datetime in ISO 8601 format.

date_tostring required

End of time frame. Datetime in ISO 8601 format.

type'live' | 'vod' | 'playlist' required

entity's type

stream_idstring required

video streaming ID

Response

OK

Example response

{
  "data": [
    {
      "viewers": 100500,
      "seconds": 500
    },
    {
      "viewers": 3000,
      "seconds": 1000
    }
  ]
}