Search

Tools

Bookmark This Page

Advanced Relevant Content

This request offers insight into some of the custom capabilities available from Rovi Advanced Recommendations. This is one of several requests that show how entertainment recommendations can be generated for your customers.

Advanced Relevant Content returns the content and people relevant to a characteristic of TV, movie, or music entertainment. Results are returned in order of relevance and the priorities specified in the request parameters, including the following which are unique to Rovi Advanced Recommendations:

Additional field-level filters.
Priority settings such as hot, new, fresh, or all-time.

Characteristics include:

keywords — hundreds of Rovi Video keywords such as sitcom, high school, and action/adventure.
attributes — hundreds of Rovi Music attributes such as family, goth rock, and meditative.
descriptors — hundreds of Rovi DVDs descriptors such as ghosts, social climbing, and political thriller.

Syntax

endpoint/relevantcontent?

keywordid=keywordid
attributeid=attributeid
descriptorid=descriptorid

&apikey=apikey&sig=sig& entitytype=entitytype [&filter=filter] [&include=include] [&formatid=formatid] [&format=format] [&country=country] [&language=language] [&size=size]

Request Example 1

Request the hottest music artists relevant to an autumn theme, along with all themes that apply and JPGs that fit a bounding box of 250 x 250 pixels.

http://api.rovicorp.com/snrpreview/v2.1/music/relevantcontent?apikey=apikey&sig=sig&
entitytype=artist&attributeid=MA0000004245&include=themes,images&formatid=44&boost=hot:1

Request Example 2

Request the 50 newest movies and freshest TV series in Rovi DVDs that are relevant to an enigmatic tone, along with tones that apply and JPGs that fit a bounding box of 100 x 100 pixels.

http://api.rovicorp.com/snrpreview/v2.1/amgvideo/relevantcontent?apikey=apikey&sig=sig&
entitytype=movie&entitytype=tvseries&descriptorid=D++1309&boost=new:0.5&boost=fresh:0.5&
include=tones,images&formatid=51&size=50

Request Example 3

Request 10 all-time best albums that are relevant to a reassuring/consoling mood in an XML response, along with the list of album moods.

http://api.rovicorp.com/snrpreview/v2.1/music/relevantcontent?apikey=apikey&sig=sig&
entitytype=album&attributeid=XA0000001074&include=moods&size=10&format=xml&
boost=alltime:1

Request Example 4

Request the 20 hottest, newest, G- or PG-rated click-flick movies released after 2000, along with keywords that apply and images that fit a bounding box of 250 x 250 pixels.

http://api.rovicorp.com/snrpreview/v2.1/video/relevantcontent?apikey=apikey&sig=sig&
entitytype=movie&keywordid=375&filter=releaseyear>2000&filter=ratingid:3|ratingid:4&
include=keywords,images&formatid=44&format=json&size=20&boost=new:0.5&boost=hot:0.5

Request Parameters

♫ Music-related requests 日 Movie-related requests ⊑⊒ TV-related requests

Parameter Required Description

apikey Yes Access code that authorizes your request for data from Rovi.

endpoint

Yes

Database to search.

To search in . . .	Specify this endpoint.
music	music ♫
movies and TV series (our DVD database)	amgvideo 日
television (our international TV schedule database)	video ⊑⊒

entitytype

Yes

Type of content to return.

For this endpoint . . .	To return . . .	Specify entitytype.	(And ID.)
music ♫	songs	song	`attributeid`
	albums	album	`attributeid`
	people working in music	artist	`attributeid`
amgvideo 日	movies	movie	`descriptorid`
	TV series	tvseries	`descriptorid`
video ⊑⊒	movies	movie	`keywordid`
	TV series	tvseries	`keywordid`

To return data from multiple entity types within an endpoint, specify multiple entitytype parameters like this: entitytype=tvseries&entitytype=movie. Note: The top results may come from just one of the entity types. Order of results is determined by relevance and is not deliberately balanced across the entity types.

sig

Yes

A calculated authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three strings:

Your API key.
The secret key you received with your API key.
The Unix time. Unix time is a timestamp supported in most development environments, and is generally defined as the number of seconds since January 1, 1970 00:00:00 GMT.

Perform the calculation at the time of each request to be sure it's within a five-minute window of the server time. If you're testing the call in a browser, use our online signature generator to perform the calculation.

attributeid

Conditional

Rovi Music ID for a music mood, style, theme, genre, or subgenre. Attribute IDs consist of the prefix MA or XA followed by a ten-digit number, specified like this: attributeid=MA0000002504 or attributeid=XA0000001029.

For a list of music moods, see the Music Moods table.

For a list of music themes, see the Music Themes table.

For a list of music genres, subgenres, and styles, call Descriptor/MusicGenres.

You can also grab attribute IDs from responses to the following requests:

Condition: Required for and limited to an endpoint of music.

descriptorid

Conditional

A Rovi DVDs ID for a genre or subgenre that applies to movies or TV series.

Descriptor IDs consist of the letter D followed by 6 digits with leading spaces. When using a descriptor ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: D+++646.

For a list of those genre and subgenre IDs, call Descriptor/MovieGenres. You can also grab genre and subgenre IDs from responses to the following requests:

Condition: Required for and limited to an endpoint of amgvideo.

keywordid

Conditional

Rovi Video ID for a keyword that applies to movies or TV programs.

For a list of keywords, see the Rovi Video Keywords table. You can also grab keyword IDs from responses to Video/Keywords.

Condition: Required for and limited to an endpoint of video.

boost

Sort-order priorities you can increase or decrease by a decimal value between -1 and 1. To boost the priority of new content by 50%, for example, specify boost=new:0.5. The priorities you can increase and decrease are:

Factor	Meaning
hot new fresh alltime	hot content recent original release date new episodes in a TV series all-time popularity

To boost multiple factors, specify multiple parameters: boost=new:0.5&boost=alltime:‑0.4. Note: The sum of the absolute values of all factors must be less than or equal to 1. That is, add all of the absolute values together and make sure the total is less than or equal to 1.

country No Country the language parameter applies to. The current release of the API supports only US.

filter

Field content that determines which results are returned. Like a WHERE clause in an SQL statement, this parameter selects only results with fields that meet your criteria.

This parameter requires an endpoint of video.

Examples:

Specify filter=releaseyear>2009 to return only shows released in 2010 or later.
Specify filter=ratingid:3|ratingid:4|ratingid:5 to return movies rated G, PG, or PG13.

The selection operators include:

Operator	Meaning
`:`	Is equal to.
`!:`	Is not equal to.
`<`	Is less than.
`<:`	Is less than or equal to.
`>`	Is greater than.
`>:`	Is greater than or equal to.
`\|`	Or.

For the And operation, specify another filter parameter like this: filter=releaseyear>:2004&filter=releaseyear<2009.

The following shows which fields you can select for each video entity type. If you specify a filter that does not apply to an entity type, no data will be returned for that entity type.

For . . .	You can filter on . . .	Description
movie	latestairing	Filters out content based on the most recent date the program was broadcast (YYYYMMDD).
	ratingid	Includes only content that has a particular parental rating. See the IDs in the ratings table.
	releaseyear	Filters content by release year.
tvseries	latestairing	Filters out content based on the most recent date the series was broadcast (YYYYMMDD).
	ratingid	Returns only content that has a particular parental rating. See the IDs in the ratings table.

format

Format of the returned data: json or xml. The default is JSON.

Alternatively you can specify the response format in an HTTP Accept header with either of these Accept field content types:

application/xml
application/json

If you specify both, the format parameter overrides the Accept header.

formatid

If you specify All or Images in the include parameter, formatid specifies the size and file format of returned images. Select the format IDs you want from the Format IDs table.

Specify multiple format IDs in a comma-separated list, like this: formatid=36,44,51.

include

Additional data to include in each result returned. To include cast members in movie results, for example, specify include=cast. For multiple includes, separate the values with commas like this: include=moods,crew. To include all data, specify include=all.

For endpoint	Entitytype	You can include these results . . .
music ♫	album	All ClassicalReview Credits Images Moods PrimaryReview	Releases Similar Styles Themes Tracks
music ♫	song	All Appearances	Review	Sample
music ♫	artist	All Aliases AssociatedWith ClassicalBio CollaboratorWith Compositions Contemporaries Credits Discography Factsheets Filmography Followers GroupMembers Images	Influencers MemberOf Moods MovieBio MovieStyles MusicBio MusicCredits MusicStyles Similars Songs Themes Videos Web
amgvideo 日	movie	All Cast Crew Images Keywords	Moods Related Releases Review Similar	Synopsis Themes Tones Types Videos
amgvideo 日	tvseries	All Cast Crew Images Keywords	Moods Related Releases Review Similar	Synopsis Themes Tones Types Videos
video ⊑⊒	movie	All Awards Cast Crew	Event Images Keywords Review	Synopsis Themes Tones
video ⊑⊒	tvseries	All Awards Cast Crew	Images Keywords Review Seasons	Synopsis Themes Tones

language No Language of the response data. This request supports only en (English).

size No The number of items you want to be returned. The default is 20.

Response

Response Header

Response	Type	Description
controlSet	ControlSet	The HTTP response status.
id	string	Server transaction ID for the response.

Response for Advanced Relevant Content

Response	Type	Description
results	result [ ]	The entertainment content relevant to the characteristic specified in the request, listed in order of most-to-least relevance.
totalResultCounts	integer	Number of items available to be returned for the request.

Response Example 1

The hottest music artist relevant to an autumn theme, along with all themes that apply to the artist and JPGs that fit a bounding box of 250 x 250 pixels.

Requested with http://api.rovicorp.com/snrpreview/v2.1/music/relevantcontent?apikey=apikey&sig=sig&
entitytype=artist&attributeid=MA0000004245&format=json&include=themes,images&formatid=44&
size=1&boost=hot:1.

{
   "relevantcontentResponse":{
      "meta:id":"tul1cpgssrapp2:gwy:3enr2",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"artist",
            "relevance":[
               {
                  "code":"Score",
                  "value":1
               }
            ],
            "id":"MN0000663645",
            "messages":null,
            "name":{
               "ids":{
                  "amgClassicalId":"Q 689727",
                  "amgMovieId":null,
                  "amgPopId":"P 991558",
                  "cosmoId":null,
                  "nameId":"MN0000663645"
               },
               "name":"Bon Iver",
               "isGroup":true,
               "primaryMedia":"Popular",
               "musicGenres":[
                  {
                     "id":"MA0000002613",
                     "name":"Pop/Rock",
                     "weight":10
                  }
               ],
               "movieGenres":null,
               "active":[
                  "2000s",
                  "2010s"
               ],
               "birth":{
                  "date":"2007-??-??",
                  "place":"Eau Claire, WI"
               },
               "death":{
                  "date":"",
                  "place":""
               },
               "country":"United States of America",
               "period":"",
               "headlineBio":"A sparse, effecting storyteller with a slightly off-kilter approach to folk",
               "classicalBio":null,
               "classicalBioUri":"",
               "discography":null,
               "discographyUri":"http://api.rovicorp.com/v1/name/discography?format=json&apikey=141341&nameid=MN0000663645",
               "filmography":null,
               "filmographyUri":"",
               "followers":null,
               "followersUri":"",
               "groupMembers":null,
               "groupMembersUri":"http://api.rovicorp.com/v1/name/groupMembers?format=json&apikey=141341&nameid=MN0000663645",
               "memberOf":null,
               "memberOfUri":"",
               "images":[
                  {
                     "height":166,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":"D.L. Anderson",
                     "copyrightOwner":""
                  },
                  {
                     "height":187,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":"",
                     "copyrightOwner":""
                  }
               ],
               "imagesUri":"http://api.rovicorp.com/v1/name/images?format=json&apikey=141341&nameid=MN0000663645",
               "influencers":null,
               "influencersUri":"http://api.rovicorp.com/v1/name/influencers?format=json&apikey=141341&nameid=MN0000663645",
               "similars":null,
               "similarsUri":"http://api.rovicorp.com/v1/name/similars?format=json&apikey=141341&nameid=MN0000663645",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/v1/name/moods?format=json&apikey=141341&nameid=MN0000663645",
               "movieBio":null,
               "movieBioUri":"",
               "musicBio":null,
               "musicBioUri":"http://api.rovicorp.com/v1/name/musicBio?format=json&apikey=141341&nameid=MN0000663645",
               "musicCredits":null,
               "musicCreditsUri":"http://api.rovicorp.com/v1/name/musicCredits?format=json&apikey=141341&nameid=MN0000663645",
               "songs":null,
               "songsUri":"http://api.rovicorp.com/v1/name/songs?format=json&apikey=141341&nameid=MN0000663645",
               "musicStyles":null,
               "musicStylesUri":"http://api.rovicorp.com/v1/name/musicStyles?format=json&apikey=141341&nameid=MN0000663645",
               "themes":[
                  {
                     "id":"MA0000006313",
                     "name":"Solitude",
                     "weight":9
                  },
                  {
                     "id":"MA0000004285",
                     "name":"Winter",
                     "weight":9
                  },
                  {
                     "id":"MA0000004245",
                     "name":"Autumn",
                     "weight":8
                  },
                  {
                     "id":"MA0000006318",
                     "name":"Introspection",
                     "weight":8
                  },
                  {
                     "id":"MA0000006316",
                     "name":"Reflection",
                     "weight":8
                  },
                  {
                     "id":"MA0000004251",
                     "name":"Feeling Blue",
                     "weight":7
                  },
                  {
                     "id":"MA0000005096",
                     "name":"Rainy Day",
                     "weight":7
                  }
               ],
               "themesUri":"http://api.rovicorp.com/v1/name/themes?format=json&apikey=141341&nameid=MN0000663645",
               "videos":null,
               "videosUri":"http://api.rovicorp.com/v1/name/videos?format=json&apikey=141341&nameid=MN0000663645",
               "movieStyles":null,
               "movieStylesUri":"",
               "contemporaries":null,
               "contemporariesUri":"http://api.rovicorp.com/v1/name/contemporaries?format=json&apikey=141341&nameid=MN0000663645",
               "associatedWith":null,
               "associatedWithUri":"http://api.rovicorp.com/v1/name/associatedwith?format=json&apikey=141341&nameid=MN0000663645",
               "collaboratorWith":null,
               "collaboratorWithUri":"",
               "compositions":null,
               "compositionsUri":"",
               "aliases":null,
               "aliasesUri":"http://api.rovicorp.com/v1/name/aliases?format=json&apikey=141341&nameid=MN0000663645",
               "web":null,
               "webUri":"http://api.rovicorp.com/v1/name/web?format=json&apikey=141341&nameid=MN0000663645",
               "factsheets":null,
               "factsheetsUri":"",
               "schedule":null,
               "scheduleUri":"",
               "credits":null,
               "creditsUri":""
            }
         }
      ],
      "totalResultCounts":846
   }
}

Response Example 2

The newest movie or freshest TV series in Rovi DVDs relevant to an enigmatic tone, along with tones that apply and JPGs that fit a bounding box of 100 x 100 pixels.

Requested with http://api.rovicorp.com/snrpreview/v2.1/amgvideo/relevantcontent?apikey=apikey&sig=sig&
entitytype=movie&entitytype=tvseries&descriptorid=D++1309&include=tones,images&formatid=51&size=1&
boost=new:0.5&boost=fresh:0.5.

{
   "relevantcontentResponse":{
      "meta:id":"tul1cpgssrapp1:gwy:3l56f",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"tvseries",
            "relevance":[
               {
                  "code":"Score",
                  "value":0.7252217
               }
            ],
            "id":"V 526351",
            "messages":null,
            "movie":{
               "ids":{
                  "cosmoId":"16478039",
                  "movieId":"V 526351"
               },
               "title":"The Event [TV Series]",
               "releaseYear":2010,
               "rating":0,
               "duration":60,
               "directors":null,
               "countries":[
                  "USA"
               ],
               "mpaa":"",
               "flags":null,
               "genres":[
                  {
                     "id":"D 651",
                     "name":"Mystery",
                     "weight":5
                  },
                  {
                     "id":"D 652",
                     "name":"Science Fiction",
                     "weight":5
                  }
               ],
               "attributes":null,
               "cast":null,
               "castUri":"",
               "crew":null,
               "crewUri":"http://api.rovicorp.com/v1/movie/crew?format=json&apikey=141341&movieid=V+++526351",
               "images":[
                  {
                     "height":56,
                     "width":100,
                     "formatid":51,
                     "url":"http://actual-url-concealed.jpg",
                     "author":"",
                     "copyrightOwner":""
                  }
               ],
               "imagesUri":"http://api.rovicorp.com/v1/movie/images?format=json&apikey=141341&movieid=V+++526351",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/v1/movie/moods?format=json&apikey=141341&movieid=V+++526351",
               "keywords":null,
               "keywordsUri":"http://api.rovicorp.com/v1/movie/keywords?format=json&apikey=141341&movieid=V+++526351",
               "related":null,
               "relatedUri":"http://api.rovicorp.com/v1/movie/related?format=json&apikey=141341&movieid=V+++526351",
               "releases":null,
               "releasesUri":"",
               "review":null,
               "reviewUri":"",
               "similar":null,
               "similarUri":"http://api.rovicorp.com/v1/movie/similar?format=json&apikey=141341&movieid=V+++526351",
               "synopsis":null,
               "synopsisUri":"http://api.rovicorp.com/v1/movie/synopsis?format=json&apikey=141341&movieid=V+++526351",
               "themes":null,
               "themesUri":"http://api.rovicorp.com/v1/movie/themes?format=json&apikey=141341&movieid=V+++526351",
               "tones":[
                  {
                     "id":"D 1309",
                     "name":"Enigmatic",
                     "weight":5
                  },
                  {
                     "id":"D 1340",
                     "name":"Ominous",
                     "weight":5
                  },
                  {
                     "id":"D 1341",
                     "name":"Paranoid",
                     "weight":5
                  },
                  {
                     "id":"D 1363",
                     "name":"Tense",
                     "weight":5
                  }
               ],
               "tonesUri":"http://api.rovicorp.com/v1/movie/tones?format=json&apikey=141341&movieid=V+++526351",
               "types":null,
               "typesUri":"http://api.rovicorp.com/v1/movie/types?format=json&apikey=141341&movieid=V+++526351",
               "videos":null,
               "videosUri":"",
               "studio":"",
               "producedBy":[
                  "Steve Stark Productions",
                  "Universal Media Studios"
               ],
               "releasedBy":null,
               "distributor":null
            }
         }
      ],
      "totalResultCounts":842
   }
}

Response Example 3

The all-time best album that is relevant to a reassuring/consoling mood, along with a list of the album moods.

Requested with http://api.rovicorp.com/snrpreview/v2.1/music/relevantcontent?apikey=apikey&sig=sig&
entitytype=album&attributeid=XA0000001074&include=moods&format=xml&size=1&boost=alltime:1.

<relevantcontentResponse xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="com.rovicorp.metadataservice" xmlns:meta="com.rovicorp.metadataservice" meta:id="tul1cpgssrapp2:gwy:3eouv">
  <controlSet>
    <status>ok</status>
    <code>200</code>
    <messages>null</messages>
  </controlSet>
  <results>
    <result>
      <type>album</type>
      <relevance>
        <code>Score</code>
        <value>0.8793651</value>
      </relevance>
      <availabilties />
      <id>MW0002288090</id>
      <messages i:nil="true" />
      <album>
        <ids>
          <albumId>MW0002288090</albumId>
          <amgClassicalId i:nil="true" />
          <amgPopId>R 2386627</amgPopId>
        </ids>
        <title>Kisses on the Bottom</title>
        <primaryArtists>
          <AlbumArtist>
            <id>MN0000029884</id>
            <name>Paul McCartney</name>
          </AlbumArtist>
        </primaryArtists>
        <guestArtists i:nil="true" />
        <flags i:nil="true" />
        <duration>2950</duration>
        <originalReleaseDate>2012-02-06</originalReleaseDate>
        <rating>5</rating>
        <isPick>false</isPick>
        <genres>
          <Genre>
            <id>MA0000011877</id>
            <name>Vocal</name>
            <weight>7</weight>
          </Genre>
          <Genre>
            <id>MA0000002613</id>
            <name>Pop/Rock</name>
            <weight>5</weight>
          </Genre>
        </genres>
        <headlineReview>
          <text>Paul McCartney indulges his love of great American pop standards on the sweetly sentimental [roviLink="MW0002288090"]Kisses on the Bottom[/roviLink].</text>
          <author>Stephen Thomas Erlewine</author>
        </headlineReview>
        <classicalReview i:nil="true" />
        <classicalReviewUri i:nil="true" />
        <credits i:nil="true" />
        <creditsUri>http://api.rovicorp.com/v1/album/credits?format=xml&apikey=141341&albumid=MW0002288090</creditsUri>
        <images i:nil="true" />
        <imagesUri>http://api.rovicorp.com/v1/album/images?format=xml&apikey=141341&albumid=MW0002288090</imagesUri>
        <moods>
          <Mood>
            <id>XA0000000934</id>
            <name>Amiable/Good-Natured</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000000704</id>
            <name>Cheerful</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000000988</id>
            <name>Elegant</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000001074</id>
            <name>Reassuring/Consoling</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000000755</id>
            <name>Relaxed</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000000765</id>
            <name>Sentimental</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000001097</id>
            <name>Soft/Quiet</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000001099</id>
            <name>Soothing</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000001100</id>
            <name>Sophisticated</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000000773</id>
            <name>Sweet</name>
            <weight>5</weight>
          </Mood>
          <Mood>
            <id>XA0000001138</id>
            <name>Warm</name>
            <weight>5</weight>
          </Mood>
        </moods>
        <moodsUri>http://api.rovicorp.com/v1/album/moods?format=xml&apikey=141341&albumid=MW0002288090</moodsUri>
        <primaryReview i:nil="true" />
        <primaryReviewUri>http://api.rovicorp.com/v1/album/primaryReview?format=xml&apikey=141341&albumid=MW0002288090</primaryReviewUri>
        <releases i:nil="true" />
        <releasesUri>http://api.rovicorp.com/v1/album/releases?format=xml&apikey=141341&albumid=MW0002288090</releasesUri>
        <similar i:nil="true" />
        <similarUri i:nil="true" />
        <styles i:nil="true" />
        <stylesUri>http://api.rovicorp.com/v1/album/styles?format=xml&apikey=141341&albumid=MW0002288090</stylesUri>
        <themes i:nil="true" />
        <themesUri>http://api.rovicorp.com/v1/album/themes?format=xml&apikey=141341&albumid=MW0002288090</themesUri>
        <tracks i:nil="true" />
        <tracksUri>http://api.rovicorp.com/v1/album/tracks?format=xml&apikey=141341&albumid=MW0002288090</tracksUri>
      </album>
    </result>
  </results>
  <totalResultCounts>734</totalResultCounts>
</relevantcontentResponse>

Response Example 4

The hottest, newest, G- or PG-rated click-flick movie released after 2000, along with keywords that apply and JPGs that fit a bounding box of 250 x 250 pixels.

Requested with http://api.rovicorp.com/snrpreview/v2.1/video/relevantcontent?apikey=apikey&sig=sig&
entitytype=movie&keywordid=375&filter=releaseyear>2000&filter=ratingid:3|ratingid:4&
include=images,keywords&format=json&size=1&boost=new:0.4&boost=hot:0.4.

{
   "relevantcontentResponse":{
      "meta:id":"tul1cpgssrapp1:gwy:3l4br",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"movie",
            "relevance":[
               {
                  "code":"Score",
                  "value":0.8054309
               }
            ],
            "id":18694108,
            "messages":null,
            "video":{
               "ids":{
                  "amgMovieId":null,
                  "cosmoId":"18694108",
                  "iguideId":2717490
               },
               "seriesIds":null,
               "masterTitle":"Monte Carlo",
               "secondaryTitle":"",
               "episodeTitle":null,
               "category":"Movie",
               "color":"Color",
               "lastAirDate":null,
               "originalAirDate":null,
               "programType":"Movie",
               "releaseYear":2011,
               "duration":109,
               "subcategory":"comedy",
               "syndicated":false,
               "programLanguage":"English",
               "partNumber":null,
               "partTotal":null,
               "parentalRatings":null,
               "parentalRatingsUri":"http://api.rovicorp.com/v1/video/parentalratings?format=json&apikey=141341&cosmoid=18694108",
               "cast":null,
               "castUri":"http://api.rovicorp.com/v1/video/cast?format=json&apikey=141341&cosmoid=18694108",
               "crew":null,
               "crewUri":"http://api.rovicorp.com/v1/video/crew?format=json&apikey=141341&cosmoid=18694108",
               "awards":null,
               "awardsUri":"",
               "images":[
                  {
                     "height":250,
                     "width":187,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":"20th Century Fox",
                     "copyrightOwner":null
                  },
                  {
                     "height":187,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null
                  }
               ],
               "imagesUri":"http://api.rovicorp.com/v1/video/images?format=json&apikey=141341&cosmoid=18694108",
               "clip":null,
               "clipUri":"",
               "seasons":null,
               "seasonsUri":"",
               "schedule":"",
               "scheduleUri":"",
               "event":null,
               "eventUri":"",
               "keywords":[
                  {
                     "keywords":[
                        {
                           "id":12,
                           "keyword":"comedy",
                           "weight":""
                        },
                        {
                           "id":174,
                           "keyword":"romance",
                           "weight":""
                        },
                        {
                           "id":375,
                           "keyword":"chick flick",
                           "weight":""
                        }
                     ],
                     "characteristics":[
                        {
                           "id":"K 1906",
                           "keyword":"heir",
                           "weight":5
                        },
                        {
                           "id":"K 1906",
                           "keyword":"heiress",
                           "weight":5
                        },
                        {
                           "id":"K 292",
                           "keyword":"royalty",
                           "weight":5
                        },
                        {
                           "id":"K 4142",
                           "keyword":"stepsister",
                           "weight":5
                        }
                     ]
                  }
               ],
               "keywordsUri":"http://api.rovicorp.com/v1/video/keywords?format=json&apikey=141341&cosmoid=18694108",
               "moods":null,
               "moodsUri":"",
               "related":null,
               "relatedUri":"",
               "review":null,
               "reviewUri":"",
               "synopsis":null,
               "synopsisUri":"",
               "themes":null,
               "themesUri":"",
               "tones":null,
               "tonesUri":""
            }
         }
      ],
      "totalResultCounts":46
   }
}

Response Example 5

The song most relevant to a theme of hanging out, along with a review and a link to a song sample.

Requested with http://api.rovicorp.com/snrpreview/v2.1/music/relevantcontent?apikey=apikey&sig=sig&
entitytype=song&attributeid=MA0000006297&include=review,sample&size=1.

{
   "relevantcontentResponse":{
      "meta:id":"tul1cpgssrapp1:gwy:3krqj",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"song",
            "relevance":[
               {
                  "code":"Score",
                  "value":0.810071
               }
            ],
            "id":"MT0002791738",
            "messages":null,
            "song":{
               "ids":{
                  "amgClassicalTrackId":null,
                  "amgPopTrackId":"T 2770341",
                  "isrcId":"USA176610260",
                  "muzeId":"5497084",
                  "trackId":"MT0002791738"
               },
               "title":"Out of Time",
               "primaryArtists":[
                  {
                     "id":"MN0000894465",
                     "name":"The Rolling Stones"
                  }
               ],
               "isPick":true,
               "genres":[
                  {
                     "id":"MA0000002613",
                     "name":"Pop/Rock",
                     "weight":9
                  }
               ],
               "appearances":null,
               "appearancesUri":"http://api.rovicorp.com/v1/song/appearances?format=json&apikey=141341&trackId=MT0002791738",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/v1/song/moods?format=json&apikey=141341&trackId=MT0002791738",
               "review":{
                  "text":"[roviLink=\"MC\"]\"Out of Time\"[/roviLink] was one of the great LP-only [roviLink=\"MN\"]Rolling Stones[/roviLink] cuts of the 1960s, appearing on [roviLink=\"MW\"]Aftermath[/roviLink] in the U.K. in 1966 and on [roviLink=\"MW\"]Flowers[/roviLink] slightly later in the U.S. The instantly catchy, deep, blurry opening riff -- which sounds much like farting electric keyboards, if truth be told -- is followed by a jazzy run on the vibes (almost certainly played by [roviLink=\"MN\"]Brian Jones[/roviLink]). Like [roviLink=\"MC\"]\"Under My Thumb,\"[/roviLink] also recorded around this time, it illustrated how [roviLink=\"MN\"]the Stones[/roviLink] were getting into varied textures that reached beyond their [roviLink=\"MA\"]blues-rock[/roviLink] base. Set to a lightly swinging rhythm, the verse utilizes the group's overlooked talent for slightly raw but purposeful call-response lines between [roviLink=\"MN\"]Mick Jagger[/roviLink]'s lead and backup harmonizers. The joyful chorus is almost as memorable as the hooks heard on the best 1960s [roviLink=\"MN\"]Rolling Stones[/roviLink] singles -- and, as was often the situation with vocal hooks on [roviLink=\"MN\"]Rolling Stones[/roviLink] songs, juxtaposed the [roviLink=\"MA\"]pop[/roviLink] exuberance of the melody with a nasty, vindictive lyric. As putdown lyrics of girls go in [roviLink=\"MN\"]Stones[/roviLink] tunes, [roviLink=\"MC\"]\"Out of Time\"[/roviLink] is one of the most artful yet vengeful, implying -- no, outright stating -- that she's outlived her usefulness, both to him and to the world in general. The restraint of the vocal delivery does ameliorate what could be perceived, with some justification, as a diatribe with some misogynistic elements. Possibly, there is a pun or double meaning involved in the title lyric. The girl is \"out of time,\" perhaps, in several ways: out of sync with the world around her, or out of time remaining in the relationship with the narrator. (It was this quality, most likely, that enabled [roviLink=\"MC\"]\"Out of Time\"[/roviLink] to find its way onto a prominent position on the soundtrack of the movie [roviLink=\"VW\"]Coming Home[/roviLink], as it reflected the \"out of timeness\" and disorientation felt by the returning Vietnam vets of the film.) And, of course, \"out of time\" is a musical term as well, referring to those who can't keep the beat -- a cardinal sin for musicians as committed and successful as [roviLink=\"MN\"]the Rolling Stones[/roviLink]. It's not mere conjecture to surmise that [roviLink=\"MC\"]\"Out of Time\"[/roviLink] had serious commercial potential as a single if [roviLink=\"MN\"]the Stones[/roviLink] had decided to release it as such, since it was a number one single in the U.K. for their friend, [roviLink=\"MN\"]Chris Farlowe[/roviLink], produced by [roviLink=\"MN\"]Mick Jagger[/roviLink]. Actually, this is an inferior rendition, with a far more [roviLink=\"MA\"]pop[/roviLink]-oriented production using strings. If you have never heard the [roviLink=\"MN\"]Farlowe[/roviLink] version, but have [roviLink=\"MN\"]the Stones[/roviLink]' outtakes compilation [roviLink=\"MW\"]Metamorphosis[/roviLink], you can still hear the backing track, as the version used on that album had the very same backing track used for [roviLink=\"MN\"]Farlowe[/roviLink]'s single, with a different vocal by [roviLink=\"MN\"]Jagger[/roviLink] laid on top. To compound the discographical confusion, a longer [roviLink=\"MN\"]Rolling Stones[/roviLink] version of [roviLink=\"MC\"]\"Out of Time\"[/roviLink] exists than is commonly available on most releases, although it's not much different from the familiar one. Long after the 1960s were done with, [roviLink=\"MN\"]the Ramones[/roviLink] revived the song for their '90s album of '60s covers, [roviLink=\"MW\"]Acid Eaters[/roviLink]. ~ Richie Unterberger",
                  "author":"Richie Unterberger"
               },
               "reviewUri":"http://api.rovicorp.com/v1/song/review?format=json&apikey=141341&trackId=MT0002791738",
               "styles":null,
               "stylesUri":"http://api.rovicorp.com/v1/song/styles?format=json&apikey=141341&trackId=MT0002791738",
               "themes":null,
               "themesUri":"http://api.rovicorp.com/v1/song/themes?format=json&apikey=141341&trackId=MT0002791738",
               "sample":"http://actual-url-concealed.mp3",
               "sampleUri":"http://api.rovicorp.com/v1/song/sample?format=json&apikey=141341&trackId=MT0002791738"
            }
         }
      ],
      "totalResultCounts":10000
   }
}

Error Codes

Code	Description
400	Incorrect or invalid request. The reason is shown in the Message object in ControlSet.

Rcs-eval-api/v2.1/relevantcontent

Topics

Search

TOOLBOX

Tools

Advanced Relevant Content

Syntax

Request Example 1

Request Example 2

Request Example 3

Request Example 4

Request Parameters

Response

Response Header

Response for Advanced Relevant Content

Response Example 1

Response Example 2

Response Example 3

Response Example 4

Response Example 5

Error Codes

See Also

Personal tools