GET views/list
Returns a collection of the view activities of videos on the authorized user’s account.
Resource URL
Resource Information
Required scope
|
insights |
Required role
|
Media manager |
Response formats
|
JSON, XML |
Requires authentication?
|
Yes |
Parameters
since
optional
|
Returns results with an ID greater than (that is, more recent than) the specified ID. |
until
optional
|
Returns results with an ID less than (that is, older than) the specified ID. |
count
optional
|
Specifies the number of records to retrieve. Must be less than or equal to 1000; defaults to 20. |
video_ids
optional
|
Specifies a comma-separated list of the video ID(s) for the resource(s) that are being retrieved. |
person_references
optional
|
Specifies a comma-separated list of the person reference(s) for the resource(s) that are being retrieved. (Custom Data Integration Guide) |
Example Request
Example Result
{ "views":{ "view":[ { "id":"55ec5bb4c621f6cde268576c", "video":{ "id":"0541aa577e2e59aa", "title":"New ZiMovi Promo June 2015 FINAL", "page":"https:\/\/zimovi.com\/success\/", "domain":"zimovi.com", "is_embed":true }, "progress":{ "length":78.27, "last_view":"2015-09-12T19:13:57+00:00", "view_count":5 }, "device":{ "platform":"Macintosh", "browser":"Firefox", "version":"40.0" }, "person":{ "is_user":true, "user_id":"876f802ab546b8c7", "name":"Alex Zang", "email":"alexzang@gmail.com", "ip":"86.153.203.242", "country":"GB", "geolocation":{ "type":"Point", "coordinates":[ 53.3416, -1.5214 ] } } }, { "id":"55ec0fcdc621f6cde268575e", "video":{ "id":"0541aa577e2e59aa", "title":"New ZiMovi Promo June 2015 FINAL", "page":"https:\/\/www.zimovi.com\/success\/", "domain":"www.zimovi.com", "is_embed":true }, "progress":{ "length":0.07, "last_view":"2015-09-06T10:02:00+00:00", "view_count":0 }, "device":{ "platform":"Windows", "browser":"MSIE", "version":"11.0" }, "person":{ "is_user":false, "ip":"92.11.123.104", "country":"GB", "geolocation":null } }, { "id":"55e9b849c621f6cde2685707", "video":{ "id":"ac790aac7f051e83", "title":"New ZiMovi Promo Animation - Draft", "page":"https:\/\/www.zimovi.com\/success\/features\/", "domain":"www.zimovi.com", "is_embed":true }, "progress":{ "length":52.66, "last_view":"2015-09-04T15:25:42+00:00", "view_count":1 }, "device":{ "platform":"Windows", "browser":"MSIE", "version":"11.0" }, "person":{ "is_user":false, "ip":"176.35.89.3", "country":"GB", "geolocation":null } } ] }, "metadata":{ "total":3, "count":20, "since":"55e95593c621f6cde26856dd", "until":"55eea1f1c621f6cde268581b" } }