---
title: "Fetch total viewers analytics data for a VOD stream"
method: GET
path: "/analytics/viewers/vod_streams/{id}/total"
tags: ["analytics_viewers"]
---

# Fetch total viewers analytics data for a VOD stream

`GET /analytics/viewers/vod_streams/{id}/total`

(Available from version 2.0) This operation returns the total viewers data for a specific VOD stream.

 **Querying data**


Use the **include** query parameter to specify what data you want to return, including: countries, renditions, and devices.

If you don't send the **include** query parameter, the total number of viewers is returned.

## Path parameters

- `id` string, required

## Query parameters

- `include` string
- `time_zone` string

## Response `200`

Success

- AnalyticsViewersVodStreamTotal
  - `vod_stream` object
    - `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.
    - `countries` object — An array of viewer countries.
      - `code` string — A country code where the stream was requested.
      - `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.
    - `renditions` object — An array of viewer renditions.
      - `name` integer — The rendition of the stream played. A rendition name is the smaller number of the resolution. The resolution is [width]x[height] in which the stream was played. Renditions names have to be unique. If you've created two renditions that have the same height and width, Wowza Video increments the value of the height and uses that as the rendition name. Example: Two renditions of 1280x720 will result in rendition names of 720 and 721.
      - `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.
    - `devices` object — An array of viewer devices.
      - `name` string — A device where the stream was played.
      - `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.
    - `time_zone` string — The time zone in which the data is returned. The default time zone in which the data is returned is **Etc/UTC**.
    - `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)