Python

from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
unique_viewers_cdn = client.streaming.statistics.get_unique_viewers_cdn(
    date_from="date_from",
    date_to="date_to",
)
print(unique_viewers_cdn.data)

{
  "data": [
    {
      "uniqs": 100,
      "type": "vod"
    },
    {
      "uniqs": 300,
      "type": "live"
    }
  ]
}

Streaming Statistics

Get unique viewers via CDN

Сounts the number of unique viewers of a video entity over CDN. It doesn’t matter what player you used.

All unique viewers for the specified period of time are counted.

How does it work?

Calculating the number of unique viewers for a Live stream or VOD over CDN involves aggregating and analyzing various metrics to ensure each individual viewer is counted only once, regardless of how many times they connect or disconnect during the stream.

This method provides statistics for any video viewing by unique users, regardless of viewing method and a player you used. Thus, this is the most important difference from viewing through the built-in player:

In method /statistics/uniqs viewers of the built-in player are tracked only.
But this method tracks all viewers from everywhere.

This method is a combination of two other Live and VOD detailed methods. If you need detailed information, then see the methods: /statistics/stream/viewers and /statistics/vod/viewers.

Data Processing and Deduplication

We us IP Address & User-Agent combination. Each unique combination of IP address and User-Agent string might be considered a unique viewer.

This approach allows to accurately estimate the number of unique viewers. However, this is not foolproof due to NAT (Network Address Translation) and shared networks. Thus if your users fall under such restrictions, then the number of unique viewers may be higher than calculated.

Why is there no “Unique Views” method?

Based on CDN data, we can calculate the number of unique viewers only. Thus only your player will be able to count the number of unique views (clicks on the Play button) within the player session (i.e. how many times 1 unique viewer clicked the Play button within a unique player’s session).

GET

streaming

statistics

cdn

uniqs

Python

from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
unique_viewers_cdn = client.streaming.statistics.get_unique_viewers_cdn(
    date_from="date_from",
    date_to="date_to",
)
print(unique_viewers_cdn.data)

{
  "data": [
    {
      "uniqs": 100,
      "type": "vod"
    },
    {
      "uniqs": 300,
      "type": "live"
    }
  ]
}

Authorizations

Authorization

string

header

required

Query Parameters

date_from

string

required

date_to

string

required

type

enum<string>

Available options:

live,

vod,

playlist

string

Response

data

object[]

Show child attributes

Change restream Get views in built-in player

⌘I

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Resellers

Get unique viewers via CDN

Authorizations

Query Parameters

Response