Blog

Rovi Video (Release 2.3)

Rovi Cloud 2.3 is now available. This release brings you dozens of great, new API requests and improvements in several of our current requests.

Discover APIs:

  • The Discover APIs now support conversation!

All features of the conversation search API can be accessed by submitting text derived from voice to text applications. This API supports sessions that allow the user to interact with the search conversation system iteratively and dynamically.


discover_available_video_by_conversation

discover_all_video_by_conversation

  • In addition to “similarity”, new recommendations are now available, including “watchable” (on now) and “trending” (popular) recommendations.

discover_all_trending_video/content

discover_all_trending_video/movies

discover_all_trending_video/series

discover_all_trending_video/sports

discover_all_video_by_conversation/content

discover_available_watchable_video/content

discover_available_watchable_video/movies

discover_available_watchable_video/series

discover_available_watchable_video/sports

  • Genre browse requests now work with strings.

You can now ask for "horror" movies (instead of "WIKI13451" movies) by encoding the genre names in your code or by allowing users to enter the genre and get the related movies (or other video works) back in a single call. Discover supports a wide range of standard genres, such as “comedy”, “action”, “romance”, “musical”, “scifi”, “war”, “drama” and many more.

  • All searches now support general content, movies, series, and a new specialization: sports! Look for your favorite team or upcoming sporting event using the new sports sub template.

  • Template references in the Discover responses follow a new "ref" style that deviates from the "links" style used elsewhere in the API. The "ref" style was factored to be more concise and clear for the customer. Over the next few months, we will be rolling out the "ref" style to replace the "links" style throughout the API, but Discover will be getting it first.

  • Customer channel lineup is now communicated using the same Service ID as used in the Grid and schedule portion of the API, rather than the secondary Headend ID.

When available, you will receive, in addition to the search results, details about the next airing of the search result within a Service without having to make a subsequent call. This works for both "all" and "available" searches, with the difference being that "available" searches are constrained to results that have upcoming airings, while "all" searches are open ended. Still, by sending a Service ID to an "all" search, you can get back upcoming airing information for any results that happen to be airing without needing to make separate "availability" calls.

  • Searches now return contextual groups in their results.

A group is a set of related video works that can be stepped into to further browse or search. Examples include all of the video works by a celebrity or all of the movies in a series of sequels. This means that you can search on celebrities as well as other grouping concepts like decade, team, award, or genre. Note: when stepping into a group, we recommend clearing the {query} and {page} terms and including the provided {context} as well as the {next} value of the group.

  • The following API from the previous release is no longer necessary now that genre browse just uses strings and has been removed and is no longer supported:

discover_genre_id_by_name

  • The following APIs from the previous release have template name changes and there may also be functionality changes as well

Old template name (Release 2.2)

New template name (Release 2.3)

discover_available_by_genre /content

discover_available_video_by_genre/content

discover_available_by_genre /series

discover_available_video_by_genre/series

discover_available_by_genre /movie

discover_available_video_by_genre/movies



discover_all_by_genre /content

discover_all_video_by_genre/content

discover_all_by_genre /movie

discover_all_video_by_genre/movies

discover_all_by_genre /series

discover_all_video_by_genre/series



discover_available_video_by_search/movie

discover_available_video_by_search/movies



discover_all_video_by_search /movie

discover_all_video_by_search/movies

discover_all_similar_video/movie

discover_all_video_similar_to/content


discover_available_similar_video/movie

discover_available_video_similar_to/content



Note: the new version of the “similar” recommendation template uses the content type of the provided ID to control the content type of the response. In other words, if you provide a movie ID, you will get back movie recommendations (just as before). However, now you can also use a series ID with the “similar” recommendation template to get back similar series recommendations as well.


Metadata API’s:

With this release, you’ll have the capability to do the following:

  • Obtain theatrical releases of a movie by country

  • Obtain a person’s filmography: information about movies and TV programs that a person has contributed to

  • Obtain the original television broadcast date in a country for the release of a movie, episode, or other show

  • Display the best image for a person, grab the ‘media image id’ directly from the data_person template and then call the media_image template with that ID to get the image to display. 

  • We also have a breaking change for data_airing_synopses. We have changed from synopses to synopsis:

		{
		    "id": 1725010050,
		    "links": {
		        "data_airing_synopsis": {
		            "id": 1725010050
		        },
		        "data_airing": {
		            "id": 1725010050
		        }
		    },
		    "synopsis": {
		        "in": "en-us",
		        "length": "long",
		        "synopsis": "The reality show \\"Extreme I Do's.\\""
		    }
		}

By posting on this site, you agree that you are not posting any content to which rights are held by a third party, and you hereby grant to Rovi Corporation and Rovi Corporation’s licensees and assigns a perpetual worldwide royalty free license to use and distribute all content (and all ideas embodied in such content) in all forms in all media and technologies, and without any payment obligation.