GET views/list

Home / REST APIs / GET views/list

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"
      }
}
Contact Us

We're not around right now. But you can send us an email and we'll get back to you, asap.

Not readable? Change text. captcha txt