Returns titles of movies that are related to a movie specified in the request. Movies returned are related in one or more of the following ways:
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.
movie/related? | movie=movie movieid=movieid cosmoid=cosmoid |
&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 television series. Cosmo is a database of television information.
Condition: The request must contain just one of these parameters:
|
movie | Conditional | Keywords from the title of the movie or TV series. This searches for the most popular title with that combination of words. Replace spaces with plus (+) or percent20 (%20) symbols.
Condition: The request must contain just one of these parameters:
|
movieid | Conditional | AMG ID of a movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. When using an AMG Video ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: V+++295550. Your application can grab movie IDs from responses to the following requests:
Condition: The request must contain just one of these parameters:
|
country | No | Country of the language of the response. 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). |
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 object that are recognized by the API. |
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. |
Response | Type | Description |
---|---|---|
influenced | MovieAbstract [ ] | Movies that the movie in the request influenced. |
isFeaturedIn | MovieAbstract [ ] | Movies that feature the movie in the request. |
isFollowedBy | MovieAbstract [ ] | The movie that follows the movie in the request. |
isInfluencedBy | MovieAbstract [ ] | Movies that influenced the movie in the request. |
isPartOfSeries | MovieAbstract [ ] | The film series the movie in the request belongs to. |
isReeditedBy | MovieAbstract [ ] | Movies that are a re-edit of the movie in the request. |
isRelatedTo | MovieAbstract [ ] | Movies related to the movie in the request. |
isSpoofedIn | MovieAbstract [ ] | Movies that spoof the movie in the request. |
isSpoofOf | MovieAbstract [ ] | Movies spoofed by the movie in the request. |
isVersionOf | MovieAbstract [ ] | Movies that are a version of the movie in the request. |
precededBy | MovieAbstract [ ] | The movie that preceded the movie in the request. |
similarTo | MovieAbstract [ ] | Movies that are similar to the movie in the request. |