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 this 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
andoffset
parameters. -
Optionally, filter by
viewerId
,errorCode
,orderBy
a specific field, and sort in ascending or descending order. -
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