Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
Video Analytics

Get video views

GET
/v1_1/{cloud_name}/video/analytics/views

Retrieves analytics data for video views. Results can be filtered using expressions based on various criteria such as video public ID, view duration, viewer information, and more.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your product environment.

Query Parameters

expression?string

A set of conditions used to limit the results to rows that match those conditions. For example: ?expression=video_public_id=skate

max_results?integer

The maximum number of results to return. Default is 10.

Range1 <= value <= 500
Default10
sort_by?string

Specifies the expression field by which to sort the results. Prepend values with a '-' to reverse the order.

Default"-view_ended_at"

Value in

  • "view_ended_at"
  • "video_duration"
  • "view_watch_time"
  • "-view_ended_at"
  • "-video_duration"
  • "-view_watch_time"
next_cursor?string

The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1_1/my_cloud/video/analytics/views"
{  "request_id": "1d39ccc69109b1cefac697957bda7952",  "next_cursor": "2a54714067686dc630b44e3b863163dc",  "data": [    {      "video_public_id": "dog",      "video_duration": 100,      "video_transformation": "w_100,h_100",      "video_extension": "mp4",      "viewer_application_name": "Chrome",      "viewer_location_country_code": "US",      "viewer_os_identifier": "Linux",      "view_watch_time": 313,      "view_ended_at": "2025-05-13T09:59:21.000Z"    }  ]}

Retrieves comprehensive usage metrics and account statistics GET

A report on the status of product environment usage, including storage, credits, bandwidth, requests, number of resources, and add-on usage. No date parameter needed to get current usage statistics.

Add related assets by asset ID POST

Relates an asset to other assets by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. This is a bidirectional process, meaning that the asset will also be added as a related_asset to all the other assets specified. The relation is also a one to many relationship, where the asset is related to all the assets specified, but those assets aren't also related to each other.