1. API Integration – Getting Started

IRIS.TV’s API can be used to generate recommendations in continuous play and static display environments. The API has three main calls:

1. Watch
2. Update
3. Next

The Watch Call is made when a viewing experience is initiated. This can either happen when a user clicks on an asset or the first video is played. This call generates a list of recommendations as well as an Experience value, which is used to track all user behavior in the video stream.

The Update Call is made to send any information on viewer behavior to IRIS.TV. These behaviors include: Play, Video Complete, Skip, Pause, Thumbs Up, Thumbs Down.

The Next Call is made to refresh or extend the viewing experience. This should be made in three situations: (1) if a viewer reaches the end of the videos made on the Watch call; (2) if a viewer clicks Thumbs Up on a video; (3) if a viewer clicks Thumbs Down on a video.

All IRIS.TV API calls require an access token created using the OAuth 2 standard.