GET views/list
Returns a collection of the view activities of videos on the authorized user’s account.
Resource URL
https://zimovi.com/api/views/list.json (or .xml)
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
GET https://zimovi.com/api/views/list.json?video_ids=0541aa577e2e59aa,ac790aac7f051e83&since=55e95593c621f6cde26856dd&until=55eea1f1c621f6cde268581b
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"
}
}