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