Returns movies, series, seasons, and programs that have a relationship with a movie, series, season, or program specified in the request.
The show in the request . . .
|
|
|
|
. . . the movies, series, seasons, and programs in the response.
This request may return a large amount of data. To speed data transmission, request a compressed response by including Accept-Encoding: gzip,deflate in the HTTP header.
video/related? | video=video cosmoid=cosmoid iguideid=iguideid |
&apikey=apikey&sig=sig [&format=format] [&country=country] [&language=language] |
Click to re-sort
Parameter | Required | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apikey | Yes | Access code that authorizes your request for data from Rovi. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sig | Yes | A calculated authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three strings:
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. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
cosmoid | Conditional | Cosmo database ID for a movie or a television series, season, or program. Cosmo is a database of television information. You can grab Cosmo IDs from responses to the following requests:
Condition: The request must contain just one of these parameters:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
iguideid | Conditional | A 24-bit program ID for a television program used by the i‑Guide™ interactive digital cable TV program guide. You can get i‑Guide IDs from i‑Guide and from responses to the following requests:
Condition: The request must contain just one of these parameters:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
video | Conditional | Title of a movie, television program, or television series, or keywords from the title. This searches for the most popular title with that combination of words. Replace any spaces with plus (+) or percent20 (%20) symbols. Note: This parameter currently returns only US-English results. Support for other countries and languages will be added in the future. Condition: The request must contain just one of these parameters:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
country | No | Country for the language that is specified as the language parameter, stated as a two-character ISO 3166 country code. Default is US (United States). Valid country codes are:
* Includes Wales, Scotland, and Northern Ireland. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
format | No | Format of the returned data: json or xml. The default is JSON. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
language | No | Language of program titles, keywords, and descriptions, stated as a two-character ISO 639 language code. Valid language codes are:
Default is en (English). If a program description is not available in the language requested, a description in another language is provided if available. The language chosen is determined by the rules shown in the Language Fallback Sequence table. |
Response | Type | Description |
---|---|---|
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 | List of the parameters included in the request. |
parentIds | parentIds | All of the IDs for the requested movie or program that are recognized by the Video Service. |
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 that is shown in the code field. |
The Video Service returns only categories that have content and lists items in each category in order of release year.
Response | Type | Description |
---|---|---|
featuredIn | VideoAbstract [ ] | Shows that feature the movie or program in the request. |
features | VideoAbstract [ ] | Shows that the movie or program in the request feature. |
followedBy | VideoAbstract [ ] | The show that follows the movie or program in the request. |
includes | VideoAbstract [ ] | Seasons or shows that are in the series specified in the request. |
influenced | VideoAbstract [ ] | Shows that the movie or program in the request influenced. |
influencedBy | VideoAbstract [ ] | Shows that influenced the movie or program in the request. |
partOfSeries | VideoAbstract [ ] | The series the movie or program in the request is part of. |
precededBy | VideoAbstract [ ] | The show that preceded the movie or program in the request. |
reeditedBy | VideoAbstract [ ] | Shows that are a re-edit of the movie or program in the request. |
reeditedFrom | VideoAbstract [ ] | The show that the movie or program in the request is a re-edit of. |
relatedTo | VideoAbstract [ ] | Shows related to the movie or program in the request. |
remadeAs | VideoAbstract [ ] | Shows that remade the movie or program in the request. |
similarTo | VideoAbstract [ ] | Shows that are similar to the movie or program in the request. |
spinOffOf | VideoAbstract [ ] | The show that the movie or program in the request has been spun off from. |
spoofedIn | VideoAbstract [ ] | Shows that spoof the movie or program in the request. |
spoofOf | VideoAbstract [ ] | Shows that the movie or program in the request spoof. |
versionOf | VideoAbstract [ ] | Shows that the movie or program in the request is a version of. |