---
title: "Fetch viewer analytics data for the most viewed VOD streams"
method: GET
path: "/analytics/viewers/vod_streams"
tags: ["analytics_viewers"]
---

# Fetch viewer analytics data for the most viewed VOD streams

`GET /analytics/viewers/vod_streams`

(Available from version 1.11) This operation returns viewer data for the top 100 VOD 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 VOD stream viewer data is returned.

If the time range between **from** and **to** query parameters is:
    
<ul><li>Less than 60 minutes, the cache time between responses is 10 seconds.</li> <li>More than 60 minutes, the cache time between responses is 60 seconds.</li>

## Query parameters

- `from` string, date-time
- `to` string, date-time

## Response `200`

Success

- AnalyticsViewersVodStreams
  - `vod_streams` object[], required
    - `id` string, int32 — The unique alphanumeric string that identifies the VOD stream.
    - `viewers` integer — The total number of unique viewers to download at least one chunk of the stream. A unique viewer is a single IP address; multiple users that share the same IP address are counted once.
  - `limits` object — The time frame represented in the response.
    - `from` string, date-time — The start of the range of time represented in the response.
    - `to` string, date-time — The end of the range of time represented in the response.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `410` — Gone
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation.md) · [All operations](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wowza/wowza-video-rest-api-reference-documentation/versions/157b6f741f2a/schema)