Python

from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
views_heatmap = client.streaming.statistics.get_views_heatmap(
    date_from="date_from",
    date_to="date_to",
    stream_id="stream_id",
    type="live",
)
print(views_heatmap.data)

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

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

Python

from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
views_heatmap = client.streaming.statistics.get_views_heatmap(
    date_from="date_from",
    date_to="date_to",
    stream_id="stream_id",
    type="live",
)
print(views_heatmap.data)

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

Authorizations

Authorization

string

header

required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

date_from

string

required

Start of time frame. Datetime in ISO 8601 format.

date_to

string

required

End of time frame. Datetime in ISO 8601 format.

type

enum<string>

required

entity's type

Available options:

live,

vod,

playlist

stream_id

string

required

video streaming ID

Response

data

object[]

Show child attributes

Get hosts in built-in player Get stream ffprobe

⌘I

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Resellers

Get heatmap in built-in player

Authorizations

Query Parameters

Response