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

# Fetch popularity analytics data for a VOD stream

`GET /analytics/popularity/vod_streams/{id}`

(Available from version 1.11) This operation returns the popularity data for a specific VOD stream. Popularity data provides insight into how many times  your video is displayed to a possible viewer and how many times it's played. 

If you don't send from and to query parameters, the last hour's worth of data is returned. See the **trend** field in the response for information about sample intervals.

Use the include query parameter to specify whether you want to return trend data. See the **trend** field in the response for information about sample intervals.

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>

## Path parameters

- `id` string, required

## Query parameters

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

## Response `200`

Success

- AnalyticsPopularityVodStream
  - `vod_stream` object
    - `id` string, int32 — The unique alphanumeric string that identifies the VOD stream.
    - `plays` integer — The total number of plays for a VOD stream. A play is registered when the stream begins to play.
    - `displays` integer — The total number of displays for a VOD stream. A display is registered when the player is completely loaded and ready to play the VOD stream.
    - `trend` object — An array of popularity trend data. The granularity of sampled data changes based on the from and to query values you use: 1. Requests made for data _within_ the most recent 3 days returns sample intervals by the hour. You can return sample intervals by the minute by specifying a specific hour range. 2. Requests made for data _beyond_ the most recent 3 days can only return sample intervals by the hour or day. The minute data is not retained beyond the 3rd day. <blockquote>Note: Data from the most recent hour data might not be included in the result of a time range that extends beyond the most recent 3 days. </blockquote> <strong>Default</strong>: Last hour
      - `plays` integer — The total number of plays for a VOD stream at the time the trend data was sampled. A play is registered when the stream begins to play.
      - `displays` integer — The total number of displays for a VOD stream at the time the trend data was sampled. A display is registered when the player is completely loaded and ready to play the VOD stream.
      - `sampled_at` string, date-time — The date and time the trend data was sampled.
    - `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/revisions/157b6f741f2a/schema)