Returns the current top movies and TV shows in a movie genre or subgenre. The list changes over time and, by design, is limited to a maximum of 100 per genre or subgenre.
descriptor/significantmovies?apikey=apikey&sig=sig&genreids=genreids [&format=format] [&offset=offset] [&count=count] [&country=country] [&language=language]
Click to re-sort
|apikey||Yes||Access code that authorizes your request for data from Rovi.|
|genreids||Yes|| Genre ID or subgenre ID. You can get IDs of movie genres and subgenres from Descriptor/Genres or Descriptor/MovieGenres.
Replace any spaces in an ID with plus (+) or percent20 (%20) symbols. To specify multiple IDs, use a comma-separated list, like this: genreids=D+++646,D+++647.
|sig||Yes|| A calculated, 32-hex-digit authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three ASCII strings:
Express the alpha hex digits as lower case.
Perform the calculation at the time of each request to be sure it's within a five-minute window of the server time. If you're testing the call in a browser, use our online signature generator to perform the calculation.
|count||No||Number of items to be returned. The default is zero, which returns all items after the offset.|
|country||No||Country the language parameter applies to. The current release of the API supports only US.|
|format||No||Format of the returned data: json or xml. The default is JSON.|
|language||No||Language of the response data. This request supports only en (English).|
|offset||No|| Number of items at the start of the available data to skip. The default is zero.
Use count and offset to paginate the data that is available to be returned.
|build||string||The software release level of the API.|
|code||integer||HTTP status code. See the status field for the text part of the code.|
|duration||integer||Server processing time in milliseconds. The difference between startTime and endTime.|
|endTime||string||When the server sent the response (UTC time).|
|messages||Message [ ]||Elements of a multiple HTTP response status message.|
|parameters||parameters||The parameters that were included in the request.|
|serverName||string||Name of the server that processed the request.|
|startTime||string||When the server received the request (UTC time).|
|status||string||Text part of the HTTP status code, which is shown in the code field.|
|view||view||Summary of items returned in a list of items.|
|movies||SignificantMovie [ ]||Top movies and TV shows in the genres or subgenres specified in the request.|