Retrieves overall values for a specified metric, providing summary statistics that help you understand the performance of your content. The response includes key metrics such as totalWatchTime
, uniqueViews
, totalPlayTime
and totalViews
.
How it works
-
Before using this endpoint, you can call the list dimensions endpoint to retrieve all available dimensions that can be used in your query.
-
Make a
GET
request to this endpoint with the requiredmetricId
and other query parameters. -
Receive a response containing the overall values for the specified metric, which may vary based on the applied filters.
Key fields in response
-
value: The specific metric value calculated based on the applied filters.
-
totalWatchTime: Total time watched across all views, represented in milliseconds.
-
uniqueViews: The count of unique viewers who interacted with the content.
-
totalViews: The total number of views recorded.
-
totalPlayTime: Total time spent playing the video, represented in milliseconds.
-
globalValue: A global metric value that reflects the overall performance of the specified metric across the entire dataset for the given timespan. This value is not affected by specific filters.
Related guide: Understand data definitions