Designing Your Movie Data Application

You have a vision for your app. Here's what you need to know to make your vision a reality.

Your Home Page

The entry to your Rovi Movie app can begin in several ways:

1. A presentation of featured content.
   • Content from your catalog of movies and TV series. You can get Rovi IDs for your catalog with Rovi Catalog Matching.
   • Top movies and TV series in a genre or subgenre as described below.
   • Movies and TV series appropriate for a theme as described below.
   • Movies and TV series appropriate for a mood as described below.
   • Movies and TV series appropriate for a tone as described below.
2. A text search for a movie, TV series, or person working in movies or TV:
   • Search
   • SingleStageSearch
   • Movie/Info (returns only the top search result)
   • Name/Info (returns only the top search result)
3. A search on a field-level characteristic that applies to movies or television:
   • FilterBrowse
   • Descriptor/SignificantMovies

Roadmap to Rovi Movie IDs

In the data returned by most API responses will be IDs of people and movies that you can use as links to additional API requests.

To feature people named in Rovi Movie responses, grab IDs from the following requests and provide links to Name API requests:

• Movie/Info
• Movie/Cast
• Movie/Crew
• Movie/Review
• Movie/Related
• Movie/Synopsis
• MovieRelease/Description
• For a complete list of requests that return name IDs, click here.

To feature movies and TV series, grab movie IDs, Cosmo IDs, or AMG movie IDs from the following responses and provide links to Movie API requests:

• Name/Filmography
• Name/MovieBio
• Movie/Related
• Movie/Review
• Movie/Synopsis
• MovieRelease/Description
• Results from search requests.

Here's a roadmap to building pages from the Rovi IDs returned in responses:

The Top-Level Requests: The Info Requests

Rovi DVDs provides three top-level requests:

• Movie/Info
• MovieRelease/Info
• Name/Info

As shown below in the sample Info response, these Info requests return not only core information, they also return preformatted requests for subsidiary information. And they can also return that subsidiary information. Rovi DVDs gives you the flexibility to get a group of related information with a single Info request or to get just subsidiary information with subsidiary requests.

If you also use Rovi Search or Rovi Recommendations, you'll notice that those requests also return Info responses.

Here are some design considerations when using the Info requests:

• An Info response tells you what subsidiary data is available: if a review or biography is not available, for example, the response will not include the preformatted request for the review or biography. This feature allows your application the following program control options when parsing an Info response:
  • Grab an available request and offer the data as a link.
  • Grab an available request, execute it, and present the data.
  • If a request is unavailable, execute an alternative request.
• You don't have to make separate requests for subsidiary information. An Info response can include subsidiary information in the response. You can, for example, include a review in an Info response by specifying that as part of the Info request. Use this feature in the following cases:
  • To build a page around data and subsidiary data you already know is available.
  • To present whatever data is available using appropriate program controls. Note: some subsidiary requests return huge amounts of data. For these requests, it's better to make a separate call so you can specify parameters that paginate the response data.

A Sample Info Response

Here's a response to a Movie/Info request for the movie Buck. Note that the request, specified below, asks for types to be included, and that the response does include the list of types and reveals that no data is available for moods.

http://api.rovicorp.com/data/v1.1/movie/info?apikey=apikey&sig=sig&movieid=V+++531454&format=json&
include=types.

Page Control: Offset and Count

Some requests return enormous amounts of information. Name/Filmography, a subsidiary request, returns over 175 items for Steven Spielberg.

To control the amount of data you receive in a response, subsidiary requests that return lists of data offer the parameters offset and count to set the starting point and number of items to return. Use these parameters in combination with page forward and page reverse controls.

So How Do I Start?

Let's start with that vision of yours. Here are some ideas for creating compelling content on any page, including a home page.

Present a Search Box

• To return search results as the user types, call SingleStageSearch.
• To have the user enter the full search query, call one of the following:
  • Search
  • Movie/Info (for the top search result only)
  • Name/Info (for the top search result only)
  • Consider also calling Autocomplete to predict search names or titles as the user types.
• Consider allowing the user to select the entitytype they are searching for—credit, movie, or TV series.
• Present a page based on the user's selection.
• Use the IDs in responses to build out your pages, adding links to other pages as shown above in Roadmap to Rovi Movie IDs.

Feature a Movie or TV Series

1. Grab the movie ID or Cosmo ID of the movie or TV series from a response:

2. Call Movie/Info with the include parameter values that return the data you want to present:

3. From the response, grab and use the data you want.
4. Call Similar to add recommendations of similar shows.
5. Use the IDs in responses to build your pages out, adding links to other pages as shown above in Roadmap to Rovi Movie IDs.

Feature Releases on DVDs, Blu-Ray, Etc.

1. Grab the movie ID or Cosmo ID of the movie or TV series from a response:

2. Call Movie/Releases to return releases of that movie or TV series.
3. Select the releases you want to present from the response. Consider filtering on elements such as format, purchaseable, and commentary.
   Would you like responses that cover only releases in you catalog? Please contact us.
4. Call MovieRelease/Info for each release you want to present, with include parameter values that return the data you want to present about each release.

Feature a Person in Movies or Television

1. Grab the ID of the person from a response that returns name IDs. For a complete list of requests that return name IDs, click here.
2. Call Name/Info with the include parameter values that return the data you want to present. Note: these values may return large amounts of data. To control the amount of data returned, make separate requests instead using the offset and count parameters.

3. From the response, grab and use the data you want.
4. Use the IDs in responses to build your pages out, adding links to other pages as shown above in Roadmap to Rovi Movie IDs.

Feature the Top Movies in a Genre or Subgenre

Rovi DVDs categorizes movies under hundreds of genres and subgenres.

1. Grab genre and subgenre IDs from responses to these requests:
   • Movie/Info (genres)
   • Movie/Types (subgenres)
   • MovieRelease/Info (genres)
   • Descriptor/MovieGenres (genres and subgenres)
2. Call Descriptor/SignificantMovies with the genre and subgenre IDs.
3. From the response, grab and use the data you want:
   • Show the movie title, release year, and image related to the movie.
   • With the movie ID, add a Movie/Info link to information about the movie.
   • With the genre IDs, present links to significant movies in other genres.
4. Use the IDs in responses to build your pages out, adding links to other pages as shown above in Roadmap to Rovi Movie IDs.

Feature Movies Around a Mood

1. Get the ID of the mood:
   • Look up the ID of the mood in the Movie Moods table.
   • Grab an ID from the response to a Movie/Moods request or to a Movie/Info request with an include=moods argument.
2. Call FilterBrowse for movies with the following parameters:
   • filter=moodid:D+++257 (for a mood of love of country).
   • An include parameter for the content you want to feature. For example: include=images for links to images.
3. From the response, grab and use the data you want.
4. Use the IDs in responses to build your pages out, adding links to other pages as shown above in Roadmap to Rovi Movie IDs.

Feature Movies Around a Theme

1. Get the ID of the theme:
   • Look up the ID of the theme in the Movie Themes table.
   • Grab an ID from the response to a Movie/Themes request or to a Movie/Info request with an include=themes argument.
2. Call FilterBrowse for movies with the following parameters:
   • filter=themeid:D++1418 (for a theme of eccentric families).
   • An include parameter for the content you want to feature. For example: include=images for links to images.
3. From the response, grab and use the data you want.
4. Use the IDs in responses to build your pages out, adding links to other pages as shown above in Roadmap to Rovi Movie IDs.

Feature Movies Around a Tone

1. Get the ID of the tone:
   • Look up the ID of the tone in the Tones table.
   • Grab an ID from the response to a Movie/Tones request or to a Movie/Info request with an include=tones argument.
2. Call FilterBrowse for movies with the following parameters:
   • filter=toneid:D++1318 (for a gritty tone).
   • An include parameter for the content you want to feature. For example: include=images for links to images.
3. From the response, grab and use the data you want.
4. Use the IDs in responses to build your pages out, adding links to other pages as shown above in Roadmap to Rovi Movie IDs.