List video views

Retrieves a list of video views that fall within the specified filters and have been completed within a defined timespan. It allows you to analyse viewer interactions with your video content effectively.

How it works

  1. Make a GET request to this endpoint with the desired query parameters.

  2. Specify the timespan for which you want to retrieve the video views using the timespan[] parameter.

  3. Filter the views based on dimensions such as browser, device, video title, viewer ID, etc., using the filterby[] parameter. Get the dimensions by calling list the dimensions endpoint.

  4. Paginate the results using the limit and offset parameters.

  5. Optionally, filter by viewerId, errorCode, orderBy a specific field, and sort in ascending or descending order.

  6. Receive a response containing the list of video views matching the specified criteria.

Each view in the response will include a unique viewId. You can use this viewId to call the get details of video view endpoint to retrieve more detailed information about that specific view.

Example

Suppose you’re managing a video streaming service and need to analyze how the content performs across different devices and browsers. By calling the List Video Views endpoint with filters like browser_name and device_type, you can get insights into which platforms are most popular with the audience. This data will help you optimize content for the most-used platforms and troubleshoot any playback issues on less common devices.

Related guide: Audience metrics, Views dashboard

Language
Credentials
Basic
base64
:
Click Try It! to start a request and see the response here!