Recommendations-api/v2.1/relevantcontent

Jump to: navigation, search

RelevantContent

Returns the content that is most relevant to a characteristic of TV, movie, or music entertainment. Results change over time with the changing content and popularity of entertainment.

Characteristics include:

  • attributes — hundreds of Rovi Music attributes such as family, goth rock, and meditative.
  • keywords — hundreds of Rovi Video keywords such as sitcom, high school, and action/adventure.
  • 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 music artists that are relevant to an autumn theme, along with JPGs that fit a bounding box of 250 x 250 pixels.

Request Example 2

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

Request Example 3

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

Request Example 4

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

Request Example 5

Request 15 songs that are relevant to a theme of hanging out, along with reviews and song samples.

Request Parameters

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

ParameterRequiredDescription
apikey Yes Access code that authorizes your request for data from Rovi.
endpoint Yes Database to search.
To search in . . .Specify this endpoint.
musicmusic 
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 songssongattributeid
albumsalbumattributeid
people working in musicartistattributeid
amgvideo moviesmoviedescriptorid
TV seriestvseriesdescriptorid
video ⊑⊒moviesmoviekeywordid
TV seriestvserieskeywordid
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.

country No Country the language parameter applies to. The current release of the API supports only US.
filter No 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
  • ratingid
Includes only content that has a particular parental rating. See the IDs in the ratings table.
  • releaseyear
Filters content by release year.
tvseries
  • ratingid
Returns only content that has a particular parental rating. See the IDs in the ratings table.
format No 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 No 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 No 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 endpointEntitytypeYou 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

ResponseTypeDescription
controlSet ControlSet The HTTP response status.
id string Server transaction ID for the response.

Response for RelevantContent

ResponseTypeDescription
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 first music artist relevant to an autumn theme, along with JPGs that fit a bounding box of 250 x 250 pixels.
Requested with http://api.rovicorp.com/recs/v2.1/music/relevantcontent?apikey=apikey&sig=sig&
entitytype=artist&attributeid=MA0000004245&format=json&include=images&formatid=44&size=1
.
{
   "relevantcontentResponse":{
      "meta:id":"tul1cpgpsrapp24:gwy:3r85qw",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"artist",
            "relevance":[
               {
                  "code":"Score",
                  "value":0.9100097
               }
            ],
            "id":"MN0000485204",
            "messages":null,
            "name":{
               "ids":{
                  "amgClassicalId":"Q 568064",
                  "amgMovieId":null,
                  "amgPopId":"P 826247",
                  "cosmoId":null,
                  "nameId":"MN0000485204"
               },
               "name":"Ingrid Michaelson",
               "isGroup":false,
               "primaryMedia":"Music",
               "musicGenres":[
                  {
                     "id":"MA0000002613",
                     "name":"Pop/Rock",
                     "weight":10
                  }
               ],
               "movieGenres":null,
               "active":[
                  "2000s",
                  "2010s"
               ],
               "birth":{
                  "date":"1979-??-??",
                  "place":"Staten Island, NY"
               },
               "death":{
                  "date":"",
                  "place":""
               },
               "country":"United States of America",
               "period":"",
               "headlineBio":"Staten Island singer-songwriter with a breezy jazz-folk style.",
               "classicalBio":null,
               "classicalBioUri":null,
               "discography":null,
               "discographyUri":"http://api.rovicorp.com/data/v1.1/name/discography?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "filmography":null,
               "filmographyUri":null,
               "followers":null,
               "followersUri":null,
               "groupMembers":null,
               "groupMembersUri":null,
               "memberOf":null,
               "memberOfUri":null,
               "images":[
                  {
                     "height":250,
                     "width":165,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":0
                  },
                  {
                     "height":165,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":0
                  },
                  {
                     "height":166,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":0
                  },
                  {
                     "height":167,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":0
                  },
                  {
                     "height":204,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":0
                  },
                  {
                     "height":230,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":"Deborah Lopez",
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":0
                  }
               ],
               "imagesUri":"http://api.rovicorp.com/data/v1.1/name/images?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "influencers":null,
               "influencersUri":"http://api.rovicorp.com/data/v1.1/name/influencers?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "similars":null,
               "similarsUri":"http://api.rovicorp.com/data/v1.1/name/similars?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/data/v1.1/name/moods?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "movieBio":null,
               "movieBioUri":null,
               "musicBio":null,
               "musicBioUri":"http://api.rovicorp.com/data/v1.1/name/musicBio?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "musicCredits":null,
               "musicCreditsUri":"http://api.rovicorp.com/data/v1.1/name/musicCredits?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "songs":null,
               "songsUri":"http://api.rovicorp.com/data/v1.1/name/songs?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "musicStyles":null,
               "musicStylesUri":"http://api.rovicorp.com/data/v1.1/name/musicStyles?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "themes":null,
               "themesUri":"http://api.rovicorp.com/data/v1.1/name/themes?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "videos":null,
               "videosUri":null,
               "movieStyles":null,
               "movieStylesUri":null,
               "contemporaries":null,
               "contemporariesUri":"http://api.rovicorp.com/data/v1.1/name/contemporaries?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "associatedWith":null,
               "associatedWithUri":null,
               "collaboratorWith":null,
               "collaboratorWithUri":null,
               "compositions":null,
               "compositionsUri":null,
               "aliases":null,
               "aliasesUri":"http://api.rovicorp.com/data/v1.1/name/aliases?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "web":null,
               "webUri":"http://api.rovicorp.com/data/v1.1/name/web?format=json&apikey=4p1k3y&nameid=MN0000485204",
               "factsheets":null,
               "factsheetsUri":null,
               "schedule":null,
               "scheduleUri":null,
               "credits":null,
               "creditsUri":null
            }
         }
      ],
      "totalResultCounts":932
   }
}

Response Example 2

The first movie or TV series from Rovi DVDs with an enigmatic tone, along with JPGs that fit a bounding box of 100 x 100 pixels.
Requested with http://api.rovicorp.com/recs/v2.1/amgvideo/relevantcontent?apikey=apikey&sig=sig&
entitytype=movie&entitytype=tvseries&descriptorid=D++1309&include=images&formatid=51&size=1
.
{
   "relevantcontentResponse":{
      "meta:id":"tul1cpgpsrapp7:gwy:3o37az",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"movie",
            "relevance":[
               {
                  "code":"Score",
                  "value":1.0420346
               }
            ],
            "id":"V 15947",
            "messages":null,
            "movie":{
               "ids":{
                  "cosmoId":"354712",
                  "movieId":"V 15947"
               },
               "title":"Eraserhead",
               "releaseYear":1977,
               "rating":9,
               "duration":100,
               "directors":[
                  {
                     "id":"P100454",
                     "name":"David Lynch"
                  }
               ],
               "countries":[
                  "USA"
               ],
               "mpaa":"",
               "flags":[
                  "Adult Humor",
                  "Not For Children"
               ],
               "genres":[
                  {
                     "id":"D 658",
                     "name":"Avant-garde / Experimental",
                     "weight":5
                  }
               ],
               "attributes":[
                  "Cult Film",
                  "High Artistic Quality",
                  "High Historical Importance"
               ],
               "cast":null,
               "castUri":"http://api.rovicorp.com/data/v1.1/movie/cast?format=json&apikey=4p1k3y&movieid=V++++15947",
               "crew":null,
               "crewUri":"http://api.rovicorp.com/data/v1.1/movie/crew?format=json&apikey=4p1k3y&movieid=V++++15947",
               "images":[
                  {
                     "height":100,
                     "width":75,
                     "formatid":51,
                     "url":"http://actual-url-concealed.jpg",
                     "author":"",
                     "copyrightOwner":"",
                     "imageTypeId":0,
                     "zoomLevel":null
                  }
               ],
               "imagesUri":"http://api.rovicorp.com/data/v1.1/movie/images?format=json&apikey=4p1k3y&movieid=V++++15947",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/data/v1.1/movie/moods?format=json&apikey=4p1k3y&movieid=V++++15947",
               "keywords":null,
               "keywordsUri":"http://api.rovicorp.com/data/v1.1/movie/keywords?format=json&apikey=4p1k3y&movieid=V++++15947",
               "related":null,
               "relatedUri":"http://api.rovicorp.com/data/v1.1/movie/related?format=json&apikey=4p1k3y&movieid=V++++15947",
               "releases":null,
               "releasesUri":"http://api.rovicorp.com/data/v1.1/movie/releases?format=json&apikey=4p1k3y&movieid=V++++15947",
               "review":null,
               "reviewUri":"http://api.rovicorp.com/data/v1.1/movie/review?format=json&apikey=4p1k3y&movieid=V++++15947",
               "similar":null,
               "similarUri":"http://api.rovicorp.com/data/v1.1/movie/similar?format=json&apikey=4p1k3y&movieid=V++++15947",
               "synopsis":null,
               "synopsisUri":"http://api.rovicorp.com/data/v1.1/movie/synopsis?format=json&apikey=4p1k3y&movieid=V++++15947",
               "themes":null,
               "themesUri":"http://api.rovicorp.com/data/v1.1/movie/themes?format=json&apikey=4p1k3y&movieid=V++++15947",
               "tones":null,
               "tonesUri":"http://api.rovicorp.com/data/v1.1/movie/tones?format=json&apikey=4p1k3y&movieid=V++++15947",
               "types":null,
               "typesUri":"http://api.rovicorp.com/data/v1.1/movie/types?format=json&apikey=4p1k3y&movieid=V++++15947",
               "videos":null,
               "videosUri":null,
               "studio":"American Film Institute/Dav",
               "producedBy":[
                  "American Film Institute",
                  "Libra Films International"
               ],
               "releasedBy":null,
               "distributor":null
            }
         }
      ],
      "totalResultCounts":854
   }
}

Response Example 3

The first album relevant to a reassuring/consoling mood, along with the list of album moods that apply.
Requested with http://api.rovicorp.com/recs/v2.1/music/relevantcontent?apikey=apikey&sig=sig&
entitytype=album&attributeid=XA0000001074&include=moods&format=xml&size=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="tul1cpgssrapp1:gwy:3ky6k">
  <controlSet>
    <status>ok</status>
    <code>200</code>
    <messages i:nil="true" />
  </controlSet>
  <results>
    <result>
      <type>album</type>
      <relevance>
        <code>Score</code>
        <value>0.810465</value>
      </relevance>
      <availabilties xmlns="com.rovicorp.snrservice" />
      <id>MW0002024479</id>
      <messages i:nil="true" />
      <album>
        <ids>
          <albumId>MW0002024479</albumId>
          <amgClassicalId i:nil="true" />
          <amgPopId>R 1944402</amgPopId>
        </ids>
        <title>Wake Up!</title>
        <primaryArtists>
          <AlbumArtist>
            <id>MN0000814387</id>
            <name>John Legend</name>
          </AlbumArtist>
          <AlbumArtist>
            <id>MN0000415906</id>
            <name>The Roots</name>
          </AlbumArtist>
        </primaryArtists>
        <guestArtists i:nil="true" />
        <flags i:nil="true" />
        <duration>3768</duration>
        <originalReleaseDate>2010-09-21</originalReleaseDate>
        <rating>5</rating>
        <isPick>false</isPick>
        <genres>
          <Genre>
            <id>MA0000002809</id>
            <name>R&B</name>
            <weight>9</weight>
          </Genre>
          <Genre>
            <id>MA0000002816</id>
            <name>Rap</name>
            <weight>4</weight>
          </Genre>
        </genres>
        <headlineReview i:nil="true" />
        <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=MW0002024479</creditsUri>
        <images i:nil="true" />
        <imagesUri>http://api.rovicorp.com/v1/album/images?format=xml&apikey=141341&albumid=MW0002024479</imagesUri>
        <moods>
          <Mood>
            <id>XA0000000696</id>
            <name>Anguished/Distraught</name>
            <weight>9</weight>
          </Mood>
          <Mood>
            <id>XA0000000706</id>
            <name>Defiant</name>
            <weight>9</weight>
          </Mood>
          <Mood>
            <id>XA0000000996</id>
            <name>Extroverted</name>
            <weight>9</weight>
          </Mood>
          <Mood>
            <id>XA0000000997</id>
            <name>Exuberant</name>
            <weight>9</weight>
          </Mood>
          <Mood>
            <id>XA0000001074</id>
            <name>Reassuring/Consoling</name>
            <weight>9</weight>
          </Mood>
          <Mood>
            <id>XA0000001088</id>
            <name>Searching</name>
            <weight>9</weight>
          </Mood>
          <Mood>
            <id>XA0000000721</id>
            <name>Intense</name>
            <weight>8</weight>
          </Mood>
          <Mood>
            <id>XA0000001027</id>
            <name>Introspective</name>
            <weight>8</weight>
          </Mood>
          <Mood>
            <id>XA0000000736</id>
            <name>Mighty</name>
            <weight>8</weight>
          </Mood>
          <Mood>
            <id>XA0000000744</id>
            <name>Optimistic</name>
            <weight>8</weight>
          </Mood>
          <Mood>
            <id>XA0000001059</id>
            <name>Outraged</name>
            <weight>8</weight>
          </Mood>
          <Mood>
            <id>XA0000001062</id>
            <name>Passionate</name>
            <weight>8</weight>
          </Mood>
          <Mood>
            <id>XA0000001068</id>
            <name>Poignant</name>
            <weight>8</weight>
          </Mood>
          <Mood>
            <id>XA0000001132</id>
            <name>Uplifting</name>
            <weight>8</weight>
          </Mood>
          <Mood>
            <id>XA0000000933</id>
            <name>Ambitious</name>
            <weight>7</weight>
          </Mood>
          <Mood>
            <id>XA0000001015</id>
            <name>Gutsy</name>
            <weight>7</weight>
          </Mood>
          <Mood>
            <id>XA0000001019</id>
            <name>Heroic</name>
            <weight>7</weight>
          </Mood>
          <Mood>
            <id>XA0000001128</id>
            <name>Turbulent</name>
            <weight>7</weight>
          </Mood>
        </moods>
        <moodsUri>http://api.rovicorp.com/v1/album/moods?format=xml&apikey=141341&albumid=MW0002024479</moodsUri>
        <primaryReview i:nil="true" />
        <primaryReviewUri>http://api.rovicorp.com/v1/album/primaryReview?format=xml&apikey=141341&albumid=MW0002024479</primaryReviewUri>
        <releases i:nil="true" />
        <releasesUri>http://api.rovicorp.com/v1/album/releases?format=xml&apikey=141341&albumid=MW0002024479</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=MW0002024479</stylesUri>
        <themes i:nil="true" />
        <themesUri>http://api.rovicorp.com/v1/album/themes?format=xml&apikey=141341&albumid=MW0002024479</themesUri>
        <tracks i:nil="true" />
        <tracksUri>http://api.rovicorp.com/v1/album/tracks?format=xml&apikey=141341&albumid=MW0002024479</tracksUri>
      </album>
    </result>
  </results>
  <totalResultCounts>734</totalResultCounts>
</relevantcontentResponse>

Response Example 4

The top 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/recs/v2.1/video/relevantcontent?apikey=apikey&sig=sig&
entitytype=movie&keywordid=375&filter=releaseyear>2000&filter=ratingid:3|ratingid:4&
include=images,keywords&formatid=44&size=1
.
{
   "relevantcontentResponse":{
      "meta:id":"tul1cpgpsrapp4:gwy:3mtv1c",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"movie",
            "relevance":[
               {
                  "code":"Score",
                  "value":0.17541045
               }
            ],
            "id":5101062,
            "messages":null,
            "video":{
               "ids":{
                  "amgMovieId":null,
                  "cosmoId":"5101062",
                  "iguideId":5101062,
                  "pidPaid":null,
                  "videoId":null
               },
               "seriesIds":null,
               "masterTitle":"Pride & Prejudice",
               "secondaryTitle":"",
               "episodeTitle":null,
               "category":"Movie",
               "color":"Color",
               "lastAirDate":null,
               "originalAirDate":null,
               "programType":"Movie",
               "releaseYear":2005,
               "duration":127,
               "subcategory":"drama",
               "syndicated":false,
               "programLanguage":"English",
               "partNumber":null,
               "partTotal":null,
               "parentalRatings":null,
               "parentalRatingsUri":"http://api.rovicorp.com/data/v1.1/video/parentalRatings?format=json&apikey=4p1k3y&cosmoid=5101062",
               "cast":null,
               "castUri":"http://api.rovicorp.com/data/v1.1/video/cast?format=json&apikey=4p1k3y&cosmoid=5101062",
               "crew":null,
               "crewUri":"http://api.rovicorp.com/data/v1.1/video/crew?format=json&apikey=4p1k3y&cosmoid=5101062",
               "awards":null,
               "awardsUri":"http://api.rovicorp.com/data/v1.1/video/awards?format=json&apikey=4p1k3y&cosmoid=5101062",
               "images":[
                  {
                     "height":250,
                     "width":166,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":27,
                     "zoomLevel":2
                  },
                  {
                     "height":250,
                     "width":187,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":27,
                     "zoomLevel":2
                  },
                  {
                     "height":187,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":6,
                     "zoomLevel":2
                  },
                  {
                     "height":125,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":6,
                     "zoomLevel":2
                  },
                  {
                     "height":187,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":6,
                     "zoomLevel":2
                  },
                  {
                     "height":187,
                     "width":250,
                     "formatid":44,
                     "url":"actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":6,
                     "zoomLevel":2
                  },
                  {
                     "height":187,
                     "width":250,
                     "formatid":44,
                     "url":"actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":6,
                     "zoomLevel":2
                  }
               ],
               "imagesUri":"http://api.rovicorp.com/data/v1.1/video/images?format=json&apikey=4p1k3y&cosmoid=5101062",
               "clip":null,
               "clipUri":"http://api.rovicorp.com/data/v1.1/video/clip?format=json&apikey=4p1k3y&cosmoid=5101062",
               "seasons":null,
               "seasonsUri":null,
               "variants":null,
               "variantsUri":"http://api.rovicorp.com/data/v1.1/video/variants?format=json&apikey=4p1k3y&cosmoid=5101062",
               "schedule":"",
               "scheduleUri":null,
               "event":null,
               "eventUri":null,
               "keywords":[
                  {
                     "keywords":[
                        {
                           "id":16,
                           "keyword":"drama",
                           "weight":""
                        },
                        {
                           "id":383,
                           "keyword":"adaptation",
                           "weight":""
                        },
                        {
                           "id":174,
                           "keyword":"romance",
                           "weight":""
                        },
                        {
                           "id":375,
                           "keyword":"chick flick",
                           "weight":""
                        },
                        {
                           "id":182,
                           "keyword":"costumer",
                           "weight":""
                        }
                     ],
                     "characteristics":[
                        {
                           "id":"K 252",
                           "keyword":"bachelor",
                           "weight":5
                        },
                        {
                           "id":"K 989",
                           "keyword":"daughter",
                           "weight":5
                        },
                        {
                           "id":"K 1317",
                           "keyword":"engagement",
                           "weight":5
                        },
                        {
                           "id":"K 1458",
                           "keyword":"family",
                           "weight":5
                        },
                        {
                           "id":"K 2474",
                           "keyword":"love",
                           "weight":5
                        },
                        {
                           "id":"K 28871",
                           "keyword":"suitor",
                           "weight":5
                        },
                        {
                           "id":"K 29945",
                           "keyword":"class-system",
                           "weight":3
                        }
                     ]
                  }
               ],
               "keywordsUri":"http://api.rovicorp.com/data/v1.1/video/keywords?format=json&apikey=4p1k3y&cosmoid=5101062",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/data/v1.1/video/moods?format=json&apikey=4p1k3y&cosmoid=5101062",
               "related":null,
               "relatedUri":"http://api.rovicorp.com/data/v1.1/video/related?format=json&apikey=4p1k3y&cosmoid=5101062",
               "review":null,
               "reviewUri":"http://api.rovicorp.com/data/v1.1/video/review?format=json&apikey=4p1k3y&cosmoid=5101062",
               "synopsis":null,
               "synopsisUri":"http://api.rovicorp.com/data/v1.1/video/synopsis?format=json&apikey=4p1k3y&cosmoid=5101062",
               "themes":null,
               "themesUri":null,
               "tones":null,
               "tonesUri":"http://api.rovicorp.com/data/v1.1/video/tones?format=json&apikey=4p1k3y&cosmoid=5101062"
            }
         }
      ],
      "totalResultCounts":20
   }
}

Response Example 5

The first song relevant to a theme of hanging out, along with a review.
Requested with http://api.rovicorp.com/recs/v2.1/music/relevantcontent?apikey=apikey&sig=sig&
entitytype=song&attributeid=MA0000006297&include=review&format=xml&size=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="tul1cpgpsrapp26:gwy:3gzlqq">
  <controlSet>
    <status>ok</status>
    <code>200</code>
    <messages i:nil="true" />
  </controlSet>
  <results>
    <result>
      <type>song</type>
      <relevance>
        <code>Score</code>
        <value>0.85998136</value>
      </relevance>
      <availabilties xmlns="com.rovicorp.snrservice" />
      <id>MT0002791738</id>
      <messages i:nil="true" />
      <song>
        <ids>
          <amgClassicalTrackId i:nil="true" />
          <amgPopTrackId>T 2770341</amgPopTrackId>
          <isrcId>USA176610260</isrcId>
          <muzeId>5497084</muzeId>
          <trackId>MT0002791738</trackId>
        </ids>
        <title>Out of Time</title>
        <primaryArtists>
          <AlbumArtist>
            <id>MN0000894465</id>
            <name>The Rolling Stones</name>
          </AlbumArtist>
        </primaryArtists>
        <isPick>true</isPick>
        <genres>
          <Genre>
            <id>MA0000002613</id>
            <name>Pop/Rock</name>
            <weight>9</weight>
          </Genre>
        </genres>
        <attributes i:nil="true" />
        <attributesUri i:nil="true" />
        <appearances i:nil="true" />
        <appearancesUri>http://api.rovicorp.com/data/v1.1/song/appearances?format=xml&apikey=4p1k3y&trackId=MT0002791738</appearancesUri>
        <moods i:nil="true" />
        <moodsUri>http://api.rovicorp.com/data/v1.1/song/moods?format=xml&apikey=4p1k3y&trackId=MT0002791738</moodsUri>
        <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</text>
          <author>Richie Unterberger</author>
        </review>
        <reviewUri>http://api.rovicorp.com/data/v1.1/song/review?format=xml&apikey=4p1k3y&trackId=MT0002791738</reviewUri>
        <styles i:nil="true" />
        <stylesUri>http://api.rovicorp.com/data/v1.1/song/styles?format=xml&apikey=4p1k3y&trackId=MT0002791738</stylesUri>
        <themes i:nil="true" />
        <themesUri>http://api.rovicorp.com/data/v1.1/song/themes?format=xml&apikey=4p1k3y&trackId=MT0002791738</themesUri>
      </song>
    </result>
  </results>
  <totalResultCounts>10000</totalResultCounts>
</relevantcontentResponse>

Error Codes

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

See Also

↑ Top

Personal tools