I/O Docs: Interactive API Documentation

Test our API services using these I/O Docs. For detailed information about any call or parameter, please see our [complete documentation](/docs). Note: For I/O Docs to work properly, you need to be logged into your developer account. You can sign in by clicking the link on the top right of this page.

Predicts search words or phrases for select areas of Rovi Cloud Services and returns results in order of popularity.

World-class metadata provides rich information about TV, music, and movies.

International television listings plus program and celebrity data and images.

OAuth 2.0 Flow:

Existing Client Credentials:

API Key:

Shared Secret:

App/Key: Manually provide key information

Client ID:

Client Secret:

Client ID:

Client Secret:

Username:

Password:

Client ID:

Client Secret:

Authorization Code:

Access Token:

Username:

Password:

Autocomplete API

List Methods

Expand Methods

GET Autocomplete :endpoint/autocomplete

Predicts search words or phrases for select areas of Rovi Cloud Services and returns results in order of popularity. Fields in bold are required.

Parameter	Type	Description
:endpoint	string	Database to search.
entitytype	string	Type of content to search for in the database selected.
query	string	The search characters.
clu	string	For an endpoint of video, the service ID of a television service that has upcoming movies or TV series you want to match against. For example 360861. You can get service IDs from the TV Listings API with a Services request.
filter	string	If you specify the clu parameter, this parameter filters out content that is not found on the television service channel lineup. Specified with a value of availability, like this: filter=availability.
country	string	Country of the language of the response. The current release of the API only supports US.
language	string	Language of the response data. This request only supports en (English).
size	integer	The number of items you want to be returned.
format	string	Format of the returned data.

Search

List Methods

Expand Methods

GET Search search/v2.1/:endpoint/search

Searches titles or names in Rovi Cloud Services and returns results in order of popularity and similarity to the search query. Fields in bold are required.

Parameter	Type	Description
:endpoint	string	Database to search.
entitytype	string	Type of content to search for.
query	string	The search string.
clu	string	For an "endpoint" of 'video,' the service ID of the television service that will be broadcasting the movie or TV show. For example, 360861. You can get service IDs from the TV Listings API with a Services request.
start	string	If you specify "clu", you can specify here the start of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and earliest time is the time of the request.
end	string	If you specify "clu", you can specify here the end of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and latest time is two weeks after the time of the request.
rep	integer	If you specify "clu", you can specify here the maximum number of broadcasts to be returned for each movie or program. Default is 1. Results are returned in an 'availabilities' object.
facet	string	Whether to return a count of found items by entity type or by genre. Default is no count.
filter	string	Returns only results with fields that meet your criteria. For example: 'decade:1990s,toneid:D++1292' (replace plus signs with spaces). For a list of possible filters and values, see the documentation page for Search.
include	string	Additional data to include in each result. For example: 'moods,themes'. For a list of possible values, see the documentation page for Search.
size	integer	Number of items you want to be returned. Default is 20.
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "size" parameters to paginate available results.
language	string	Language of response data. This request currently supports only 'en' (English).
country	string	Country of the response language. This request currently supports only 'US' (United States).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Single-Stage Search search/v2.1/:endpoint/singlestagesearch

Returns search results for titles or names as a user is typing, sorted in order of popularity and the priorities specified in the request filters. Fields in bold are required.

Parameter	Type	Description
:endpoint	string	Database to search.
entitytype	string	Type of content to search for.
query	string	The search string.
clu	string	For an "endpoint" of 'video,' the service ID of the television service that will be broadcasting the movie or TV show. For example, 360861. You can get service IDs from the TV Listings API with a Services request.
start	string	If you specify "clu", you can specify here the start of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and earliest time is the time of the request.
end	string	If you specify "clu", you can specify here the end of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and latest time is two weeks after the time of the request.
rep	integer	If you specify "clu", you can specify here the maximum number of broadcasts to be returned for each movie or program. Default is 1. Results are returned in an 'availabilities' object.
facet	string	Whether to return a count of found items by entity type or by genre. Default is no count.
filter	string	Returns only results with fields that meet your criteria. For example: 'decade:1990s,toneid:D++1292'. For a list of possible filters and values, see the documentation page for Single-Stage Search.
include	string	Additional data to include in each result. For example: 'moods,themes'. For a list of possible values, see the documentation page for Single-Stage Search.
size	integer	Number of items you want to be returned. Default is 20.
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "size" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET FilterBrowse search/v2.1/:endpoint/filterbrowse

Locates content in Rovi Cloud Services based on field-level criteria and returns results listed in order of relevance. Fields in bold are required.

Parameter	Type	Description
:endpoint	string	Database to search.
entitytype	string	Type of content to search for.
facet	string	Whether to return a count of found items by entity type or by genre. Default is no count.
filter	string	Returns only results with fields that meet your criteria. For example: 'decade:1990s,toneid:D++1292' (replace plus signs with spaces). For a list of possible filters and values, see the documentation page for FilterBrowse.
clu	string	For an "endpoint" of 'video,' the service ID of the television service that will be broadcasting the movie or TV show. For example, 360861. You can get service IDs from the TV Listings API with a Services request.
start	string	If you specify "clu", you can specify here the start of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and earliest time is the time of the request.
end	string	If you specify "clu", you can specify here the end of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and latest time is two weeks after the time of the request.
rep	integer	If you specify "clu", you can specify here the maximum number of broadcasts to be returned for each movie or program. Default is 1. Results are returned in an 'availabilities' object.
include	string	Additional data to include in each result. For example: 'moods,themes'. For a list of possible values, see the documentation page for FilterBrowse.
size	integer	Number of items you want to be returned. Default is 20.
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "size" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

Recommendations

List Methods

Expand Methods

GET Similar recs/v2.1/:endpoint/similar

Returns similar items in order of similarity and popularity. Please specify a value for albumid, trackid, amgvideoid, cosmoprogramid, or nameid. Fields in bold are required.

Parameter	Type	Description
:endpoint	string	Database to search.
entitytype	string	Type of content to search for.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184. For a request with an album ID, specify an "endpoint" of 'music' and an "entitytype" of 'album'.
trackid	string	Rovi Music ID for a song, consisting of the prefix MT followed by a ten-digit number. For example: MT0009472348. For a request with a track ID, specify an "endpoint" of 'music' and an "entitytype" of 'song'.
amgvideoid	string	AMG database ID for a movie or TV series, consisting of a ten-character string that starts with V and is followed by 9 digits with leading spaces. For example: V+++352199 (replace plus signs with spaces). For a request with an amgvideo ID, specify an "endpoint" of 'amgvideo' and an "entitytype" of 'movie' or 'tvseries'.
cosmoprogramid	string	Cosmo database ID for the movie or television series. For example: 7903. For a request with a Cosmo ID, specify an "endpoint" of video and an "entitytype" of 'movie' or 'tvseries'.
nameid	string	Rovi Music ID for a person or group, consisting of the prefix MN followed by a ten-digit number. For example: MN0000187478. For a request with a name ID, specify an "endpoint" of 'music' and an "entitytype" of 'artist'.
filter	string	Returns only results with fields that meet your criteria. For example: 'releaseyear>:2009,ratingid:3'. For a list of possible filters and values, see the documentation page for Recommendations Similar.
clu	string	For an "endpoint" of 'video,' the service ID of the television service that will be broadcasting the movie or TV show. For example, 360861. You can get service IDs from the TV Listings API with a Services request.
start	string	If you specify "clu", you can specify here the start of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and earliest time is the time of the request.
end	string	If you specify "clu", you can specify here the end of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and latest time is two weeks after the time of the request.
rep	integer	If you specify "clu", you can specify here the maximum number of broadcasts to be returned for each movie or program. Default is 1. Results are returned in an 'availabilities' object.
size	integer	Number of items you want to be returned. Default is 20.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

Video

List Methods

Expand Methods

GET Info data/v1.1/video/info

Returns information about a movie, TV series, or TV program. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
serviceid	string	Database ID of a television service for an area. For example: 360861. Returns a URL to a schedule of upcoming broadcasts of the program, if available. If you also specify 'schedule' in "include", the schedule returns. You can get service IDs from the TV Listings API with a Services request.
inprogress	boolean	If you specify "serviceid" for a schedule of upcoming broadcasts of the program, you can specify here whether shows that are in progress at "starttime" are included in the schedule.
sourceid	string	If you specify "serviceid" for a schedule of broadcasts of the program, you can limit here the channel sources, and thus the channels. For example: 5,436,429,696,873,994,1274,9426,14633,14635,27080,34396. You can get channel source IDs from the TV Listings API with GridSchedule.
sourceexclude	string	If you specify "sourceid" to select the television sources to be returned, you can specify here attributes of the channels in the source ID list that you want to eliminate from the channels returned: HD, PPV, Music.
sourceinclude	string	If you specify "sourceid" to select the television sources to be returned, you can specify here an attribute of the channels in the source ID list that you want to include in the list of channels returned: HD, PPV, Music.
starttime	string	If you specify "serviceid" for a schedule of broadcasts of the program, you can specify here the start of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and earliest time is the time of the request.
duration	integer	If you specify "serviceid" for a schedule of upcoming broadcasts of the program, you can specify here the number of minutes the schedule will cover.
titletype	integer	If you specify "serviceid" for a schedule of upcoming broadcasts of the program, you can specify here the type of program title to return as described in the TitleType table. For details, see the documentation of Video/Info
include	string	Additional data to include in each result. For example: 'moods,themes'. For a list of possible values, see the documentation page for Video/Info.
formatid	string	If you specify 'images' in the "include" parameter, you can specify here the size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagesize	string	If you specify 'images' in the "include" parameter, you can specify here the image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagesort	string	If you specify 'images' in the "include" parameter, you can specify here the sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width.
imagetypeid	string	If you specify 'images' in the "include" parameter, you can specify here the image type of returned images. Select the IDs you want from the Image Type IDs table. Specify multiple image type IDs in a comma-separated list, like this: 4,6. To change the order in which image types are returned, use the imagesort parameter with the imageorder value. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagecount	integer	If you specify 'images' in the "include" parameter, you can specify here the number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	If you specify 'images' in the "include" parameter, you can specify here the number of images at the start of the response to skip. The default is zero.
country	string	Country for the language that is specified for the "language" parameter, stated as a two-character ISO 3166 country code.
language	string	Language of program titles, keywords, and synopses, stated as a two-character ISO 639 language code.
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Episode Info data/v1.1/video/season/:season/episode/:episode/info

Returns information about an episode in a television series. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
:season	integer	Season number of the television series.
:episode	integer	Episode number of the season.
video	string	Title of the television series or keywords from the title.
cosmoid	integer	Cosmo database ID for the television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
serviceid	string	Database ID of a television service for an area. For example: 360861. Returns a URL to a schedule of upcoming broadcasts of the program, if available. If you also specify 'schedule' in "include", the schedule returns. You can get service IDs from the TV Listings API with a Services request.
inprogress	boolean	If you specify "serviceid" for a schedule of upcoming broadcasts of the program, you can specify here whether shows that are in progress at "starttime" are included in the schedule.
sourceid	string	If you specify "serviceid" for a schedule of broadcasts of the program, you can limit here the channel sources, and thus the channels. For example: 5,436,429,696,873,994,1274,9426,14633,14635,27080,34396. You can get channel source IDs from the TV Listings API with GridSchedule.
sourceexclude	string	If you specify "sourceid" to select the television sources to be returned, you can specify here attributes of the channels in the source ID list that you want to eliminate from the channels returned: HD, PPV, Music.
sourceinclude	string	If you specify "sourceid" to select the television sources to be returned, you can specify here an attribute of the channels in the source ID list that you want to include in the list of channels returned: HD, PPV, Music.
starttime	string	If you specify "serviceid" for a schedule of broadcasts of the program, you can specify here the start of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and earliest time is the time of the request.
duration	integer	If you specify "serviceid" for a schedule of upcoming broadcasts of the program, you can specify here the number of minutes the schedule will cover.
titletype	integer	If you specify "serviceid" for a schedule of upcoming broadcasts of the program, you can specify here the type of program title to return as described in the TitleType table.
include	string	Additional data to include in each result. For example: 'moods,themes'. For a list of possible values, see the documentation page for Video/Season/Episode/Info.
formatid	string	If you specify 'images' in the "include" parameter, you can specify here the size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagesize	string	If you specify 'images' in the "include" parameter, you can specify here the image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagesort	string	If you specify 'images' in the "include" parameter, you can specify here the sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width.
imagetypeid	string	If you specify 'images' in the "include" parameter, you can specify here the image type of returned images. Select the IDs you want from the Image Type IDs table. Specify multiple image type IDs in a comma-separated list, like this: 4,6. To change the order in which image types are returned, use the "imagesort" parameter with the 'imageorder' value. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagecount	integer	If you specify 'images' in the "include" parameter, you can specify here the number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	If you specify 'images' in the "include" parameter, you can specify here the number of images at the start of the response to skip. The default is zero.
country	string	Country for the language that is specified for the "language" parameter, stated as a two-character ISO 3166 country code.
language	string	Language of program titles, keywords, and descriptions, stated as a two-character ISO 639 language code.
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET AssociatedAlbums data/v1.1/video/associatedalbums

Returns a list of albums associated with a movie, series, or program. Note: Access to this data is governed by subscription level. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	The ID for the television program used by the i-Guide™ interactive digital cable TV program guide.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country for the language that is specified for the "language" parameter, stated as a two-character ISO 3166 country code.
language	string	Language of program titles, keywords, and descriptions, stated as a two-character ISO 639 language code.
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET AssociatedTracks data/v1.1/video/associatedtracks

Returns a list of songs associated with a movie, series, or program. Note: Access to this data is governed by subscription level. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	The ID for the television program used by the i-Guide™ interactive digital cable TV program guide.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country for the language that is specified for the "language" parameter, stated as a two-character ISO 3166 country code.
language	string	Language of program titles, keywords, and descriptions, stated as a two-character ISO 639 language code.
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Awards data/v1.1/video/awards

Returns awards a program has been nominated for or won. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country for the language that is specified for the "language" parameter, stated as a two-character ISO 3166 country code.
language	string	Language of program titles, keywords, and descriptions, stated as a two-character ISO 639 language code.
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Cast data/v1.1/video/cast

Returns information about cast members with links to images. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	ID for the television program used by the i-Guide™ interactive TV program guide.
filteradultcontents	boolean	Whether to filter out cast members who are tagged as Adult.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States}.
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Clip data/v1.1/video/clip

Returns data you can use to construct links to trailers and video clips. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Crew data/v1.1/video/crew

Returns information about crew members with links to images. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
filteradultcontents	boolean	Whether to filter out cast members who are tagged as Adult.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States}.
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Event data/v1.1/video/event

Returns information about a televised sporting event. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 14363849. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
country	string	Country of the language of the response. This request currently supports only 'US' (United States}.
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Images data/v1.1/video/images

Returns links to movie and television program images. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
formatid	string	Size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagesize	string	Image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagesort	string	Sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width.
imagetypeid	string	Image type of returned images. Select the IDs you want from the Image Type IDs table. Specify multiple image type IDs in a comma-separated list, like this: 4,6. To change the order in which image types are returned, use the imagesort parameter with the imageorder value. Note: Returned images meet a combination of all specified filters (formatid, imagesize, and imagetypeid).
imagecount	integer	Number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	Number of images at the start of the response to skip. The default is zero. Use the "imagecount" and "imageoffset" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Keywords data/v1.1/video/keywords

Returns keywords and characteristics that apply to a movie, TV series, or TV program. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	ID for the television program used by the i-Guide™ interactive TV program guide.
country	string	Country for the language that is specified for the "language" parameter, stated as a two-character ISO 3166 country code.
language	string	Language of program titles, keywords, and descriptions, stated as a two-character ISO 639 language code.
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Moods data/v1.1/video/moods

Returns terms that describe expressive characteristics of a movie or television program, along with weightings that reflect the relative strength of each term. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States}.
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET ParentalRatings data/v1.1/video/parentalratings

Returns the parental ratings for a movie or television program. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Related data/v1.1/video/related

Returns movies, series, seasons, and programs that have a relationship with a movie, series, season, or program specified in the request. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
country	string	Country for the language that is specified for the "language" parameter, stated as a two-character ISO 3166 country code.
language	string	Language of program titles, keywords, and descriptions, stated as a two-character ISO 639 language code.
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Review data/v1.1/video/review

Returns a professional review of a movie or program. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 62991. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Schedule data/v1.1/video/schedule

Returns a list of recent and upcoming television broadcasts of a movie or program. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
serviceid	string	Database ID of a television service for an area. For example: 360861. You can get service IDs from the TV Listings API with a Services request.
inprogress	boolean	Whether shows that are in progress at starttime are included in the schedule.
sourceid	string	The channel sources, and thus the channels, to be returned. For example: 5,436,429,696,873,994,1274,9426,14633,14635,27080,34396. You can get channel source IDs from the TV Listings API with GridSchedule.
sourceexclude	string	If you specify "sourceid" to select the television sources to be returned, you can specify here attributes of the channels in the source ID list that you want to eliminate from the channels returned: HD, PPV, Music.
sourceinclude	string	If you specify "sourceid" to select the television sources to be returned, you can specify here an attribute of the channels in the source ID list that you want to include in the list of channels returned: HD, PPV, Music.
starttime	string	Start of the schedule in UTC time in YYYYMMDDhhmmssZ format. For example 20120315140000Z. Default and earliest time is the time of the request.
duration	integer	Number of minutes the schedule will cover, from 1 to 20160. Default is 20160 (14 days).
titletype	integer	Type of program title to return as described in the TitleType table.
copytexttype	string	Type of description you want returned for the movie, program, or TV series. For a short description, for example, choose 5. For a long description, choose 1. See the video/schedule documentation for other values.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country for the language that is specified for the "language" parameter, stated as a two-character ISO 3166 country code.
language	string	Language of program titles, keywords, and descriptions, stated as a two-character ISO 639 language code.
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Season Info data/v1.1/video/season/:season/info

Returns information about a season of a TV series. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
:season	integer	Season number of the television series.
video	string	Title of the television series or keywords from the title.
cosmoid	integer	Cosmo database ID for the television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	ID for the television series used by the i-Guide™ interactive TV program guide.
include	string	Specify 'all' here to return episode IDs and titles in the response.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Season 0 Info data/v1.1/video/season/0/info

Returns information about unsequenced episodes in a TV series—-episodes that, for one reason or another, have not been assigned to a season. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
video	string	Title of the television series or keywords from the title.
cosmoid	integer	Cosmo database ID for the television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	ID for the television series used by the i-Guide™ interactive TV program guide.
include	string	Specify 'all' here to return episode IDs and titles in the response.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Season Episodes data/v1.1/video/season/:season/episodes

Links to every episode in a season of a television series. Please set a value for video, cosmoid, or iguideid. Fields in bold are required.

Parameter	Type	Description
:season	integer	Season number of the television series.
video	string	Title of the television series or keywords from the title.
cosmoid	integer	Cosmo database ID for the television series. For example: 7903. Cosmo is a database of television information.
iguideid	string	ID for the television series used by the i-Guide™ interactive TV program guide.
include	string	Specify 'all' here to return episode IDs and titles in the response.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Synopsis data/v1.1/video/synopsis

Returns the best available synopsis associated with a movie or program. Please set a value for video, cosmoid, or iguideid.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 62991. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Themes data/v1.1/video/themes

Returns a list of topics and circumstances that motivate or fit with a movie or program. Please set a value for video, cosmoid, or iguideid.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 62991. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Tones data/v1.1/video/tones

Returns feelings and attitudes that motivate or fit with a movie or program, along with weightings that reflect the relative strength of each term. Please set a value for video, cosmoid, or iguideid.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 62991. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Web data/v1.1/video/web

Returns information resources on the Internet about a movie or TV program. Note: Access to this information is governed by subscription level. Please set a value for video, cosmoid, or iguideid.

Parameter	Type	Description
video	string	Title of the movie, television program, or television series, or keywords from the title.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 15926143. Cosmo is a database of television information.
iguideid	string	An ID for a television program used by the i-Guide™ interactive digital cable TV program guide.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

Movie

List Methods

Expand Methods

GET Info data/v1.1/movie/info

Returns basic information about a movie or TV series. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
include	string	Additional data to include in each result. For example: 'moods,themes' or 'all'. For a list of possible values, see the documentation page for Movie/Info.
formatid	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesize	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesort	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width.
imagecount	integer	If you specify 'all' or 'images' in the "include" parameter, you can specify here the number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	If you specify 'all' or 'images' in the "include" parameter, you can specify here the number of images at the start of the response to skip. The default is zero. Use the "imagecount" and "imageoffset" parameters to paginate the available list of images.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Alttitles data/v1.1/movie/alttitles

Returns alternate and international titles for a movie. Please set a value for movie, or cosmoid, or movieid.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 1219814. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++++349 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Cast data/v1.1/movie/cast

Returns information about cast members with links to images. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Crew data/v1.1/movie/crew

Returns information about crew members with links to images. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Images data/v1.1/movie/images

Returns URLs to images of a movie along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
formatid	string	Size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesize	string	Image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesort	string	Sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width.
imagecount	integer	Number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	Number of images at the start of the response to skip. The default is zero. Use the "imagecount" and "imageoffset" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Keywords data/v1.1/movie/keywords

Returns keywords that apply to a movie and weightings that reflect the relative importance of each keyword. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Moods data/v1.1/movie/moods

Returns keywords that apply to a movie and weightings that reflect the relative importance of each keyword. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Related data/v1.1/movie/related

Returns titles of movies that are related to a movie specified in the request. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Releases data/v1.1/movie/releases

Returns information about DVDs, Blu-rays, and other movie releases. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Review data/v1.1/movie/review

Returns a review of a movie. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Synopsis data/v1.1/movie/synopsis

Returns a synopsis of the plot and the name of the author. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Themes data/v1.1/movie/themes

Returns a list of topics and circumstances that motivate or fit with a movie, along with weightings that reflect the relative importance of each. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Tones data/v1.1/movie/tones

Returns a list of feelings that motivate or fit with the movie or TV series, along with weightings that reflect the relative importance of each. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Types data/v1.1/movie/types

Returns movie subgenres that apply to the movie, along with weightings that reflect the relative importance of each. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Videos data/v1.1/movie/videos

Returns data for constructing links to movie trailers. Please set a value for movie, or cosmoid, or movieid. Fields in bold are required.

Parameter	Type	Description
movie	string	Keywords from the title of the movie or TV series.
cosmoid	integer	Cosmo database ID for the movie or television series. For example: 262068. Cosmo is a database of television information.
movieid	string	AMG ID of the movie or TV series, consisting of the letter V followed by 9 digits with leading spaces. For example: V++++20546 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

Movie Release

List Methods

Expand Methods

GET Info data/v1.1/movierelease/info

Returns basic information about a movie release. Please set a value for upcid or moviereleaseid. Fields in bold are required.

Parameter	Type	Description
moviereleaseid	integer	ID of a movie release. For example: E247882.
upcid	integer	Universal Product Code for an item. For example: 024543713678.
include	string	Additional data to include in each result. For example: 'images,features' or 'all'. For a list of possible values, see the documentation page for MovieRelease/Info.
formatid	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesize	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesort	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width.
imagecount	integer	If you specify 'all' or 'images' in the "include" parameter, you can specify here the number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	If you specify 'all' or 'images' in the "include" parameter, you can specify here the number of images at the start of the response to skip. The default is zero. Use the "imagecount" and "imageoffset" parameters to page the available list of images.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Description data/v1.1/movierelease/description

Returns the description of a movie release. Please set a value for upcid or moviereleaseid. Fields in bold are required.

Parameter	Type	Description
moviereleaseid	integer	ID of a movie release. For example: E278289.
upcid	integer	Universal Product Code for an item. For example: 025192117442.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Features data/v1.1/movierelease/features

Returns the description of a movie release. Please set a value for upcid or moviereleaseid. Fields in bold are required. Fields in bold are required.

Parameter	Type	Description
moviereleaseid	integer	ID of a movie release. For example: E247882.
upcid	integer	Universal Product Code for an item. For example: 024543713678.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Images data/v1.1/movierelease/images

Returns URLs to images of a movie release along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Please set a value for upcid or moviereleaseid. Fields in bold are required.

Parameter	Type	Description
moviereleaseid	integer	ID of a movie release. For example: E247882.
upcid	integer	Universal Product Code for an item. For example: 024543713678.
formatid	string	Size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesize	string	Image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesort	string	Sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width.
imagecount	integer	Number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	Number of images at the start of the response to skip. The default is zero. Use the "imagecount" and "imageoffset" parameters to paginate the available images.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Videos data/v1.1/movierelease/videos

Returns data for constructing links to trailers of a movie release. Please set a value for upcid or moviereleaseid. Fields in bold are required.

Parameter	Type	Description
moviereleaseid	integer	ID of a movie release. For example: E247882.
upcid	integer	Universal Product Code for an item. For example: 024543713678.
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

Music Album

List Methods

Expand Methods

GET Info data/v1.1/album/info

Returns basic information about an album. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++304960 (replace plus signs with spaces).
include	string	Additional data to include in each result. For example: 'moods,themes' or 'all'. For a list of possible values, see the documentation page for Album/Info.
formatid	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesize	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesort	string	If you specify 'all' or 'images' in the "include" parameter, you can specify here the sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width.
imagecount	integer	If you specify 'all' or 'images' in the "include" parameter, you can specify here the number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	If you specify 'all' or 'images' in the "include" parameter, you can specify here the number of images at the start of the response to skip. The default is zero. Use "imagecount" and "imageoffset" to paginate the available images.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Classical Review data/v1.1/album/classicalreview

Returns an editorial review of a classical music album. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0002565048.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R+++518192 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++304960 (replace plus signs with spaces).
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Credits data/v1.1/album/credits

Returns the production credits for an album, a list of the names and roles of the people and groups that produced the album. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++304960 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Images data/v1.1/album/images

Returns URLs to pictures of an album along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Photography credits must be displayed with images. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++304960 (replace plus signs with spaces).
formatid	string	Size and file format of returned images. Select the format IDs you want from the Format IDs table and specify multiple format IDs in a comma-separated list, like this: 36,44,51. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesize	string	Image sizes to be returned. Images are not dynamically resized to fit, so only available sizes are returned. Specify an exact size in width x height format, like this: 332x419. Specify a size range in width x height format, like this: 60-80x80-100. Specify multiple sizes in a comma-separated list, like this: 332x419,60-80x80-100. Note: Returned images meet a combination of all specified filters (formatid and imagesize).
imagesort	string	Sort order of returned images. Images can be sorted in ascending or descending order by the following properties: width, height, formatid, author, copyrightowner, url, imageorder, zoomlevel. Specify a descending sort order with a minus (-) sign, like this: -width. Specify a multilevel sort in highest-to-lowest order in a comma-separated list, like this: formatid,-height,width
imagecount	integer	Number of images to be returned. If fewer images are available, the available images are returned without error. The default is 25.
imageoffset	integer	Number of images at the start of the response to skip. The default is zero. Use the "imagecount" and "imageoffset" parameters to paginate the available images.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Moods data/v1.1/album/moods

Returns a list of terms that describe expressive characteristics of the music, along with weightings that reflect the relative strength of each term. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++304960 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Primary Review data/v1.1/album/primaryreview

Returns the most recent major review of an album. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W++++67248 (replace plus signs with spaces).
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Releases data/v1.1/album/releases

Returns information about the releases of an album, including media type and whether it can be purchased. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++304960 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Styles data/v1.1/album/styles

Returns a list of musical styles that apply to the music on an album along with weightings that reflect the importance of each style in the music. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++304960 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Themes data/v1.1/album/themes

Returns a list of topics, feelings, and circumstances that motivate or fit with the music on an album. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184.
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++306362 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Tracks data/v1.1/album/tracks

Returns information about the songs on a popular music album and the performances on a classical music album. Popular music songs are identified by track IDs; classical music performances are identified by performance IDs. Please set a value for album, albumid, amgpopid, or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
album	string	Keywords from the album title.
albumid	string	Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000111184
amgpopid	string	AMG ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R++++20987 (replace plus signs with spaces).
amgclassicalid	string	AMG ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W+++304960 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

Music Composition

List Methods

Expand Methods

GET Info data/v1.1/composition/info

Returns basic information about a classical music composition. Please set a value for compositionid or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
compositionid	string	Rovi Music ID for a classical music composition, consisting of the prefix MC followed by a ten-digit number. For example: MC0002369165.
amgclassicalid	string	AMG ID for a classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C++++43235 (replace plus signs with spaces).
include	string	Additional data to include in each result. For example: 'parts,releases,description' or 'all'.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Description data/v1.1/composition/description

Returns a description of a classical music composition. Please set a value for compositionid or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
compositionid	string	Rovi Music ID for a classical music composition, consisting of the prefix MC followed by a ten-digit number. For example: MC0002369165.
amgclassicalid	string	AMG ID for a classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C++++43235 (replace plus signs with spaces).
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Parts data/v1.1/composition/parts

Returns the names of the parts or movements of a classical music composition, each of which is recorded as a single track. Please set a value for compositionid or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
compositionid	string	Rovi Music ID for a classical music composition, consisting of the prefix MC followed by a ten-digit number. For example: MC0002369165.
amgclassicalid	string	AMG ID for a classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C++++43235 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Releases data/v1.1/composition/releases

Returns a list of album releases that feature a performance of a composition. Please set a value for compositionid or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
compositionid	string	Rovi Music ID for a classical music composition, consisting of the prefix MC followed by a ten-digit number. For example: MC0002369165.
amgclassicalid	string	AMG ID for a classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C++++43235 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

Music Performance

List Methods

Expand Methods

GET Info data/v1.1/performance/info

Returns basic information about a classical music performance. Please set a value for performanceid or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
performanceid	string	Rovi Music ID for a classical music performance, consisting of the prefix MQ followed by a ten-digit number. For example, MQ0001169372.
amgclassicalid	string	AMG ID for a classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C++++43235 (replace plus signs with spaces).
include	string	Additional data to include in each result. For example: 'credits,images' or 'all'. For a list of possible values, see the documentation page for Performance/Info.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Composition data/v1.1/performance/composition

Returns information about a composition played in a classical music performance. Please set a value for performanceid or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
performanceid	string	Rovi Music ID for a classical music performance, consisting of the prefix MQ followed by a ten-digit number. For example, MQ0001169372.
amgclassicalid	string	AMG ID for a classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C++++43235 (replace plus signs with spaces).
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Credits data/v1.1/performance/credits

Returns the names and roles of the people, groups, and organizations that contributed to a classical music performance and the album release. Please set a value for performanceid or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
performanceid	string	Rovi Music ID for a classical music performance, consisting of the prefix MQ followed by a ten-digit number. For example, MQ0001169372.
amgclassicalid	string	AMG ID for a classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C++++43235 (replace plus signs with spaces).
count	integer	Number of items you want to be returned. The default is zero, which returns all items after the "offset".
offset	integer	Number of items at the start of the response to skip. The default is zero. Use the "offset" and "count" parameters to paginate the available results.
country	string	Country of the language of the response. This request currently supports only 'US' (United States).
language	string	Language of the response data. This request currently supports only 'en' (English).
format	string	Format of the returned data: JSON or XML. Default is JSON.

GET Images data/v1.1/performance/images

Returns URLs to images of an album that contains the recording a classical music performance, along with associated image information. Note: Access to images is governed by your subscription level and geographical location. Photography credits must be displayed with images. Please set a value for performanceid or amgclassicalid. Fields in bold are required.

Parameter	Type	Description
performanceid	string	Rovi Music ID for a classical music performance, consisting of the prefix MQ followed by a ten-digit number. For example, MQ0001169372.
amgclassicalid	string	AMG ID for a classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C++++43235 (replace plus signs with spaces).
country	string	Country of the language of the response. This request currently supports only 'US' (United States).

I/O Docs: Interactive API Documentation

Select an API Autocomplete API Metadata and Search APIs REST TV Listings APIs

Autocomplete API List Methods Expand Methods

Search List Methods Expand Methods

Recommendations List Methods Expand Methods

Video List Methods Expand Methods

Movie List Methods Expand Methods

Movie Release List Methods Expand Methods

Music Album List Methods Expand Methods

Music Composition List Methods Expand Methods

Music Performance List Methods Expand Methods

Autocomplete API

List Methods

Expand Methods

Search

List Methods

Expand Methods

Recommendations

List Methods

Expand Methods

Video

List Methods

Expand Methods

Movie

List Methods

Expand Methods

Movie Release

List Methods

Expand Methods

Music Album

List Methods

Expand Methods

Music Composition

List Methods

Expand Methods

Music Performance

List Methods

Expand Methods