See how many minutes people watched to a specific alias on a given timestamp
This API endpoint can be used to request to amount of minutes watched to an alias within a given timeframe. You should pass a start and end query parameter to indicate the range. Both should be in the ISO 8601 format: an example timestamp could look like "2022-08-23T10:00:00.000Z".
As a result, THEOlive will sent you the amount of minutes viewed per timestamp, grouped by hour. An example response for start=2022-08-23T10:00:00.000Z and end=2022-08-23T12:00:00.000Z could look like:
[
{
"timestamp": "2022-08-23T10:00:00.000Z",
"amount": 190178
},
{
"timestamp": "2022-08-23T11:00:00.000Z",
"amount": 167811
},
{
"timestamp": "2022-08-23T12:00:00.000Z",
"amount": 13438
},
]
This means that in the timeframe 2022-08-23T10:00:00.000Z till 2022-08-23T11:00:00.000Z, 190178 minutes of your stream were viewed.
Important to note: all dates, both the query parameters as the ones returned as result are in UTC! You should do the conversion to your own time zone yourself afterwards.