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
-
Make a GET request to the /viewlist endpoint with the desired query parameters.
-
Specify the timespan for which you want to retrieve the video views using the timespan[] parameter.
-
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.
-
Paginate the results using the limit and offset parameters.
-
Optionally, filter by viewer ID, error code, order by a specific field, and sort in ascending or descending order.
-
Receive a response containing the list of video views matching the specified criteria, including a unique viewId for each view.
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.
Use Case: 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 "operatingSystem" and "application," you can gain 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.