Fetch viewer analytics data for the most viewed live streams

GET {{baseUrl}}/analytics/viewers/live_streams

(Available from version 1.11) This operation returns viewer data for the top 100 live streams in an account.

Querying data

To get viewer data for the top 100 streams that ran previously, send from and to values.

If you do not send from and to values, the last five minutes' worth of live stream viewer data is returned.

Request Params

The start of the range of time you want to view. Specify YYYY-DD-MMT HH:MM:SSZ where HH is a 24-hour clock in UTC. The range queried doesn't include minutes and seconds. If you include minutes and seconds, Wowza Video rounds up to the nearest hour when it is more than 30 minutes. If it is less than 30 minutes, Wowza Video rounds it down to the nearest hour. The maximum difference between from and to is 90 days. If you set the from query parameter without setting the to query parameter, the data returned will reflect 30 days starting at the from date, or data up to to the current day, whichever is shorter.

Example: 2023-01-14T10:31:54.486Z | | to | string | | Use this parameter, along with from, to return historic viewer data.

The end of the range of time you want to view. Specify YYYY-DD-MMT HH:MM:SSZ where HH is a 24-hour clock in UTC. The range queried doesn't include minutes and seconds. If you include minutes and seconds, Wowza Video rounds up to the nearest hour when it is more than 30 minutes. If it is less than 30 minutes, Wowza Video rounds it down to the nearest hour. The maximum difference between from and to is 90 days. If you set the to query parameter without setting the from query parameter, the data returned will be from the past 30 days or from your last invoice date, whichever is shorter.

Example: 2023-02-14T10:31:54.486Z |

HEADERS

RESPONSES

status: OK

{"live_streams":[{"id":"4Jjzstdt","viewers":3},{"id":"fFWxVsyj","viewers":4}],"limits":{"from":"2023-04-14T10:31:54.486Z","to":"2023-07-13T10:31:54.486Z"}}