Recommendations
From Medioh Wiki
medioh.tv exposes an API for obtaining both recommendations for individual videos and personalized recommendations based on a set of weighted videos. The URL for video recommendations is present for all videos returned from Medioh API results in the <medioh:recommendations> tag. You can also access it directly at:
http://medioh.tv/videos/<video_id>/recommendations.rss
...where <video_id> is a valid video ID in the Medioh guide. An example of RSS results can be found here, Recommendation RSS Example
Alternatively, a JSON representation is available at:
http://medioh.tv/videos/<video_id>/recommendations.json
An example of JSON results can be found here, Recommendation JSON Example
Personalized recommendations are generated through the following URL:
http://medioh.tv/recommendations.rss?weights=<video1_id>:<score1>,<video2_id>:<score2>,...
...where <video1_id> is a valid video ID in the Medioh guide, and score is a floating point value in the range -1 to 1. Positive values represent a positive ranking, negative values represent a negative ranking. One of the simplest approaches is specifying 1.0 for all videos a given user has watched.
Alternatively, a JSON representation is available at:
http://medioh.tv/recommendations.json?weights=<video1_id>:<score1>,<video2_id>:<score2>,...
The recommendations API will automatically exclude all videos used as input. Additionally, the following parameters may be specified:
Contents |
key
Your API key, provided by us. An API key is only required for personalized recommendations. Video recommendations are accessible without it. If you don’t already have one, please visit http://medioh.com/api to obtain one.
example: http://medioh.tv/recommendations.rss?key=12345
page
Retrieve results for the given page number. The first page is 1.
page 1: http://medioh.tv/recommendations.rss?key=12345&page=1
page 2: http://medioh.tv/recommendations.rss?key=12345&page=2
per_page
Return the specified number of results per page. The maximum is 20.
5 results: http://medioh.tv/recommendations.rss?key=12345&per_page=5
100 results: http://medioh.tv/recommendations.rss?key=12345&per_page=100
explicit
If this is set to “true” / “false”, only content marked as explicit / non-explicit is returned.
no content marked explicit: http://medioh.tv/recommendations.rss?key=12345&explicit=false
only content marked explicit: http://medioh.tv/recommendations.rss?key=12345&explicit=true
video_format
A comma separated list of video codecs (i.e. FOURCC codes) that results should include. Videos which do not match the specified codecs will be omitted. For a complete list, see Video Codecs
only AVC videos: http://medioh.tv/recommendations.rss?key=12345&video_format=avc1
both AVC and MP4 videos: http://medioh.tv/recommendations.rss?key=12345&video_format=avc1,mp4v
