---
title: "Fetch popularity analytics data for a live stream or real-time stream"
method: GET
path: "/analytics/popularity/live_streams/{id}"
tags: ["analytics_popularity"]
---

# Fetch popularity analytics data for a live stream or real-time stream

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

(Available from version 1.11) This operation returns the popularity data for a specific live stream or real-time stream. Popularity data provides insight into how many times your stream 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. 

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

- AnalyticsPopularityLiveStream
  - `live_stream` object
    - `id` string, int32 — The unique alphanumeric string that identifies the live stream or real-time stream.
    - `plays` integer — The total number of plays for a stream. A play is registered when the stream begins to play.
    - `displays` integer — The total number of displays for a stream. A display is registered when the player is completely loaded and ready to play the 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 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 stream at the time the trend data was sampled. A display is registered when the player is completely loaded and ready to play the 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)