Skip to content
English
Go to www.iris.tv
  • There are no suggestions because the search field is empty.

For You Recommendation API

The following describes how to set up For You video recommendations via the following API route

Feature:

  1. Ability to request recommendations that are relevant for a specific user that can be used to populate a carousel or build a channel

Requirements:

  1. User_id: The ID of the user
  2. client_token: The client token provided by the IRIS.TV team
  3. access_token: The access token provided by the IRIS.TV team

Formatting the Requests:

The IRIS.TV For You API will generate a list of assets based on the behavior of the user_id passed in the API call.

API Request:

https://api.iris.tv/lists/for_you

Example of the Request:

https://api.iris.tv/lists/for_you?user_id=98qpameo87&client_token=LPUA918&access_token=Q12OT1VP3U38UCTJRF5R

 

Receiving the List of Assets:

The For You Recommendation API will respond with a list of recommendations in following format:

{ "results": <list>, "count": <int>, "next": <str|None>, "prev": <str|None> }

Definition of Parameters:

  • Results: List of assets for the route
  • Count: The number of results
  • Next: Complete URL for the next page of results
  • Prev: Complete URL for the previous page of results
*Note: Next and Previous can be null if none exist.