SnR/V2/FullSearch

Jump to: navigation, search

Search Version 2.0

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

Syntax

endpoint/search?apikey=apikey&sig=sig&query=query&entitytype=entitytype [&filter=filter] [&include=include] [&facet=facet] [&format=format] [&country=country] [&language=language] [&offset=offset] [&size=size]

Request Example 1

Get the IDs for the movie Avatar.
http://api.rovicorp.com/search/v2/amgvideo/search?apikey=apikey&sig=sig&query=Avatar&
entitytype=movie

Request Example 2

Get the IDs for Eric Clapton and the groups he has been a member of.
http://api.rovicorp.com/search/v2/music/search?apikey=apikey&sig=sig&query=eric+clapton&
entitytype=artist&size=1&include=artist:memberof

Request Example 3

Get the IDs for the TV series The Office along with keywords and URLs to information about the seasons and episodes.
http://api.rovicorp.com/search/v2/video/search?apikey=apikey&sig=sig&query=the+office&
entitytype=tvseries&size=1&include=tvseries:keywords,seasons

Request Example 4

Get ten pop/rock songs released in the year 2009 with the word love in the title and show the number of those songs in all genres.
http://api.rovicorp.com/search/v2/music/search?apikey=apikey&sig=sig&query=love&entitytype=song&
facet=genre&filter=genreid:MA0000002613&filter=releasedate>:20090101&
filter=releasedate<20100101&size=10

Request Example 5

Get the films and albums Ice-T has performed in, along with URLs to images of him.
http://api.rovicorp.com/search/v2/music/search?apikey=apikey&sig=sig&query=Ice-T&entitytype=artist&
size=1&include=artist:images,discography,filmography

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 search for.
In this endpoint . . .   To search in this area . . .   Specify this entitytype.
music ♫albumsalbum
popular songssong
people working in musicartist
amgvideo 日moviesmovie
TV seriestvseries
video ⊑⊒moviesmovie
TV seriestvseries
TV programsonetimeonly
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 searched entity types.
query Yes The search string. Replace spaces with plus (+) or percent20 (%20) symbols. Character case does not affect the results (search is not case-sensitive).
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.

country No Country of the language of the response. The current release of the API supports only US.
facet No Count of items available to be returned.
To return the item count available . . .  Specify this facet.
for the entity typetype
by genre or subgenregenre
To return both, specify two facet parameters: facet=type&facet=genre.
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.

Examples:

  • Specify filter=decade:1990s to limit the results to artists active in the 1990s.
  • Specify filter=length<120 to return only movies less than 120 minutes long.
  • Specify filter=genreid:MA0000002467 to limit the results to the blues genre.
  • Specify filter=releasedate>19991231 for releases in the year 2000 or later.
  • Specify filter=moodid:XA0000000952 to return music results with a bright mood.
  • Specify filter=mpaa:G|mpaa:PG|mpaa:PG13 to return movies rated G, PG, or PG13.
  • Specify filter=editorialrating>7 to return albums or movies with a rating greater than 7.
  • Specify filter=themeid:MA0000006310 to return music results with a Sunday afternoon theme.
  • Specify filter=toneid:D++2067&filter=toneid:D++1292 for movies with both gruesome and cerebral tones.
  • Specify filter=subgenreid:D+++509|subgenreid:D+++510 to return action thriller or martial arts movies.

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=releasedate>:20070101&
filter=releasedate<20080101. A request can contain up to 20 filter parameters.

The following shows which fields you can select for each 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 this entity type. . .You can filter on . . .Example or Format
album
  • moodid
  • themeid
  • genreid
  • subgenreid
  • performerid
  • releasedate
  • editorialrating
  • recordingtype

XA0000000952 (table)
MA0000005079 (table)
MA0000002467 (look up)
MA0000002517 (look up)
MN0000994823
YYYYMMDD
1 to 10
single (live, remix, clean, single, mainalbum, soundtrack, variousartists)

artist
  • decade
  • moodid
  • themeid
  • genreid
  • subgenreid

2000s
XA0000000952 (table)
MA0000005079 (table)
MA0000002467 (look up)
MA0000002517 (look up)

movie
  • mpaa
  • adult
  • length
  • toneid
  • moodid
  • themeid
  • genreid
  • subgenreid
  • releaseyear
  • editorialrating

PG13
true (amgvideo endpoint)
120 (minutes)
D++1304 (table) (amgvideo endpoint)
D++2030 (table) (amgvideo endpoint)
D++1431 (table) (amgvideo endpoint)
D+++649 (look up) (amgvideo endpoint)
D++1376 (look up) (amgvideo endpoint)
2008
1 to 10 (amgvideo endpoint)

onetimeonly
  • length

120 (minutes, integer)

song
  • moodid
  • themeid
  • genreid
  • subgenreid
  • performerid
  • releasedate

XA0000000952 (table)
MA0000005079 (table)
MA0000002467 (look up)
MA0000002517 (look up)
MN0000994823
YYYYMMDD

tvseries
  • mpaa
  • adult
  • length
  • toneid
  • moodid
  • themeid
  • genreid
  • subgenreid
  • editorialrating

PG13
true (amgvideo endpoint)
120 (minutes)
D++1304 (table) (amgvideo endpoint)
D++2030 (table) (amgvideo endpoint)
D++1431 (table) (amgvideo endpoint)
D+++649 (look up) (amgvideo endpoint)
D++1376 (look up) (amgvideo endpoint)
1 to 10 (amgvideo endpoint)

format No Format of the returned data: json or xml. The default is JSON.
include No Additional data to include in each result returned. To include cast members in movie results, for example, specify include=movie:cast. For multiple includes, separate the values with commas like this: include=movie:moods,crew. For multiple entity types, specify separate parameters like this: include=movie:cast,crew&include=tvseries:cast,crew. A request can contain up to 20 include values.
For endpointEntitytypeYou can include these results . . .
music ♫album
  • All ♫
  • ClassicalReview ♫
  • Credits ♫
  • Images ♫
  • Moods ♫
  • PrimaryReview ♫
  • Releases ♫
  • Similar ♫
  • Styles ♫
  • Themes ♫
  • Tracks ♫
music ♫song
  • All ♫
  • Appearances ♫
  • Moods ♫
  • Review ♫
  • Styles ♫
  • Themes ♫
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 ⊑⊒
video ⊑⊒onetimeonly
  • All ⊑⊒
  • Awards ⊑⊒
  • Cast ⊑⊒
  • Crew ⊑⊒
  • Event ⊑⊒
  • Images ⊑⊒
  • Keywords ⊑⊒
  • Review ⊑⊒
  • Synopsis ⊑⊒
  • Themes ⊑⊒
  • Tones ⊑⊒

* Notice: Do not include Credits or Factsheets in a production application. They are currently in alpha release and responses may change.

language No Language of the response data. This request supports only en (English).
offset No Number of items at the start of the returned list to skip. The default is zero.

Use offset and size to paginate the response.

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 Search Version 2.0

ResponseTypeDescription
facetCounts facetCounts [ ] Number of results available to be returned in each genre or entity type, as requested by the facet parameter.
results result [ ] The search results listed in order of popularity and similarity and the filters specified in the request.
totalResultCounts Integer Total number of results found.

Response Example 1

Response to the search for the song Pacific Pride. Requested with http://api.rovicorp.com/search/v2/music/
search?apikey=apikey&sig=sig&query=pacific+pride&entitytype=song&facet=type&size=1.
{
   "searchResponse":{
      "meta:id":"tul1cpgpsrapp3:gwy:olv8",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":[
            ""
         ]
      },
      "results":[
         {
            "type":"song",
            "relevance":[
               {
                  "code":"Score",
                  "value":2.009985
               }
            ],
            "id":"MT0039727343",
            "messages":null,
            "song":{
               "ids":{
                  "amgClassicalTrackId":null,
                  "amgPopTrackId":"T 22175635",
                  "isrcId":null,
                  "muzeId":29252795,
                  "trackId":"MT0039727343"
               },
               "title":"Pacific Pride",
               "primaryArtists":[
                  {
                     "id":"MN0002497794",
                     "name":"No Joy"
                  }
               ],
               "isPick":true,
               "genre":null,
               "appearances":null,
               "appearancesUri":"http://api.rovicorp.com/v1/song/appearances?format=json&apikey=4p1k3y&trackId=MT0039727343",
               "moods":null,
               "moodsUri":"",
               "review":null,
               "reviewUri":"",
               "styles":null,
               "stylesUri":"",
               "themes":null,
               "themesUri":"",
               "sample":null,
               "sampleUri":"http://api.rovicorp.com/v1/song/sample?format=json&apikey=4p1k3y&trackId=MT0039727343"
            }
         }
      ],
      "totalResultCounts":9,
      "facetCounts":[
         {
            "name":"type",
            "facetCount":[
               {
                  "name":"Track",
                  "count":9
               }
            ]
         }
      ]
   }
}

Response Example 2

XML response to a search for Will Smith. Requested with http://api.rovicorp.com/search/v2/music/search?
apikey=apikey&sig=sig&query=will+smith&entitytype=artist&size=1&format=xml.
<searchResponse id="tul1cstadgwapp01:gwy:7kxe">
  <controlSet>
    <status>ok</status>
    <code>200</code>
    <messages/>
  </controlSet>
  <results>
    <result>
      <type>artist</type>
      <relevance>
        <code>Score</code>
        <name>2.8692374</name>
      </relevance>
      <id>MN0000963005</id>
      <messages i:nil="true"/>
      <name>
        <ids>
          <amgClassicalId>Q 253387</amgClassicalId>
          <amgMovieId>P 66596</amgMovieId>
          <amgPopId>P 278403</amgPopId>
          <cosmoId>100947</cosmoId>
          <nameId>MN0000963005</nameId>
        </ids>
        <name>Will Smith</name>
        <isGroup>false</isGroup>
        <primaryMedia>Movies</primaryMedia>
        <musicGenres>
          <Genre>
            <id>MA0000002816</id>
            <name>Rap</name>
            <weight>10</weight>
          </Genre>
          <Genre>
            <id>MA0000002809</id>
            <name>R&amp;B</name>
            <weight>9</weight>
          </Genre>
          <Genre>
            <id>MA0000002613</id>
            <name>Pop/Rock</name>
            <weight>7</weight>
          </Genre>
        </musicGenres>
        <movieGenres>
          <Genre>
            <id>D 648</id>
            <name>Comedy</name>
            <weight>99</weight>
          </Genre>
          <Genre>
            <id>D 649</id>
            <name>Drama</name>
            <weight>61</weight>
          </Genre>
          <Genre>
            <id>D 652</id>
            <name>Science Fiction</name>
            <weight>28</weight>
          </Genre>
        </movieGenres>
        <active xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a:string>1980s</a:string>
          <a:string>1990s</a:string>
          <a:string>2000s</a:string>
          <a:string>2010s</a:string>
        </active>
        <birth>
          <date>09/25/1968</date>
          <place>Philadelphia, PA</place>
        </birth>
        <death>
          <date/>
          <place/>
        </death>
        <country/>
        <period>1986-2013</period>
        <headlineBio>Fresh Prince half of classic old school pop rappers became one of the top actors in the US, hitmaking MC.</headlineBio>
        <classicalBio i:nil="true"/>
        <classicalBioUri i:nil="true"/>
        <discography i:nil="true"/>
        <discographyUri>http://api.rovicorp.com/v1/name/discography?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</discographyUri>
        <filmography i:nil="true"/>
        <filmographyUri>http://api.rovicorp.com/v1/name/filmography?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</filmographyUri>
        <followers i:nil="true"/>
        <followersUri>http://api.rovicorp.com/v1/name/followers?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</followersUri>
        <groupMembers i:nil="true"/>
        <groupMembersUri i:nil="true"/>
        <memberOf i:nil="true"/>
        <memberOfUri>http://api.rovicorp.com/v1/name/memberOf?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</memberOfUri>
        <images i:nil="true"/>
        <imagesUri>http://api.rovicorp.com/v1/name/images?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</imagesUri>
        <influencers i:nil="true"/>
        <influencersUri>http://api.rovicorp.com/v1/name/influencers?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</influencersUri>
        <similars i:nil="true"/>
        <similarsUri>http://api.rovicorp.com/v1/name/similars?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</similarsUri>
        <moods i:nil="true"/>
        <moodsUri>http://api.rovicorp.com/v1/name/moods?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</moodsUri>
        <movieBio i:nil="true"/>
        <movieBioUri>http://api.rovicorp.com/v1/name/movieBio?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</movieBioUri>
        <musicBio i:nil="true"/>
        <musicBioUri>http://api.rovicorp.com/v1/name/musicBio?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</musicBioUri>
        <musicCredits i:nil="true"/>
        <musicCreditsUri>http://api.rovicorp.com/v1/name/musicCredits?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</musicCreditsUri>
        <songs i:nil="true"/>
        <songsUri>http://api.rovicorp.com/v1/name/songs?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</songsUri>
        <musicStyles i:nil="true"/>
        <musicStylesUri>http://api.rovicorp.com/v1/name/musicStyles?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</musicStylesUri>
        <themes i:nil="true"/>
        <themesUri i:nil="true"/>
        <videos i:nil="true"/>
        <videosUri>http://api.rovicorp.com/v1/name/videos?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</videosUri>
        <movieStyles i:nil="true"/>
        <movieStylesUri>http://api.rovicorp.com/v1/name/movieStyles?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</movieStylesUri>
        <contemporaries i:nil="true"/>
        <contemporariesUri>http://api.rovicorp.com/v1/name/contemporaries?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</contemporariesUri>
        <associatedWith i:nil="true"/>
        <associatedWithUri i:nil="true"/>
        <collaboratorWith i:nil="true"/>
        <collaboratorWithUri i:nil="true"/>
        <compositions i:nil="true"/>
        <compositionsUri i:nil="true"/>
        <aliases xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true"/>
        <aliasesUri>http://api.rovicorp.com/v1/name/aliases?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</aliasesUri>
        <web i:nil="true"/>
        <webUri>http://api.rovicorp.com/v1/name/web?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</webUri>
        <factsheets i:nil="true"/>
        <factsheetsUri>http://api.rovicorp.com/v1/name/factsheets?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</factsheetsUri>
        <schedule i:nil="true"/>
        <scheduleUri i:nil="true"/>
        <credits i:nil="true"/>
        <creditsUri>http://api.rovicorp.com/v1/name/credits?format=xml&amp;apikey=4p1k3y&amp;amgmovieid=P+66596</creditsUri>
      </name>
    </result>
  </results>
  <totalResultCounts>51</totalResultCounts>
</searchResponse>

Response Example 3

Response to the search for the movie Avatar and the request for a list of DVD releases. Requested with http://api.rovicorp.com/search/v2/amgvideo/search?apikey=apikey&sig=sig&query=avatar&entitytype=movie&
facet=type&include=movie:releases&size=1.
{
   "searchResponse":{
      "meta:id":"tul1cpgpsrapp1:gwy:1fes8",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":[
            ""
         ]
      },
      "results":[
         {
            "type":"movie",
            "relevance":[
               {
                  "code":"Score",
                  "value":1.734911
               }
            ],
            "id":"V 352199",
            "messages":null,
            "movie":{
               "ids":{
                  "cosmoId":8904814,
                  "movieId":"V 352199"
               },
               "title":"Avatar",
               "releaseYear":2009,
               "rating":6,
               "duration":160,
               "directors":[
                  {
                     "id":"P 10397",
                     "name":"James Cameron"
                  }
               ],
               "countries":[
                  "USA"
               ],
               "mpaa":"PG13",
               "flags":[
                  "Profanity",
                  "Sexual Situations",
                  "War Violence",
                  "Smoking"
               ],
               "genres":[
                  {
                     "id":"D 652",
                     "name":"Science Fiction",
                     "weight":5
                  }
               ],
               "attributes":[
                  "High Production Values",
                  "High Budget"
               ],
               "cast":null,
               "castUri":"http://api.rovicorp.com/v1/movie/cast?format=json&apikey=4p1k3y&movieid=V+++352199",
               "crew":null,
               "crewUri":"http://api.rovicorp.com/v1/movie/crew?format=json&apikey=4p1k3y&movieid=V+++352199",
               "images":null,
               "imagesUri":"http://api.rovicorp.com/v1/movie/images?format=json&apikey=4p1k3y&movieid=V+++352199",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/v1/movie/moods?format=json&apikey=4p1k3y&movieid=V+++352199",
               "keywords":null,
               "keywordsUri":"http://api.rovicorp.com/v1/movie/keywords?format=json&apikey=4p1k3y&movieid=V+++352199",
               "related":null,
               "relatedUri":"",
               "releases":[
                  {
                     "ids":"",
                     "title":"Avatar [Extended Collector's Edition] [3 Discs]",
                     "studio":"20th Century Fox",
                     "rating":6,
                     "formats":[
                        "DVD"
                     ],
                     "year":"2010 11 16",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar [Blu-ray]",
                     "studio":"20th Century Fox Home Entertainment",
                     "rating":6,
                     "formats":[
                        "Blu-ray"
                     ],
                     "year":"",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar [Extended Collector's Edition] [3 Discs] [Blu-ray]",
                     "studio":"20th Century Fox Home Entertainment (Canadian)",
                     "rating":6,
                     "formats":[
                        "Blu-ray"
                     ],
                     "year":"2010 11 16",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar",
                     "studio":"20th Century Fox",
                     "rating":6,
                     "formats":[
                        "DVD"
                     ],
                     "year":"2010 04 22",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar [2 Discs] [Blu-ray/DVD]",
                     "studio":"20th Century Fox",
                     "rating":6,
                     "formats":[
                        "Blu-ray",
                        "DVD"
                     ],
                     "year":"2010 04 22",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar [Extended Collector's Edition] [3 Discs]",
                     "studio":"20th Century Fox Home Entertainment (Canadian)",
                     "rating":6,
                     "formats":[
                        "DVD"
                     ],
                     "year":"2010 11 16",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar [Extended Collector's Edition] [3 Discs] [Blu-ray]",
                     "studio":"20th Century Fox",
                     "rating":6,
                     "formats":[
                        "Blu-ray"
                     ],
                     "year":"2010 11 16",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar [Extended Collector's Edition] [Blu-ray] [3 Discs]",
                     "studio":"20th Century Fox Home Entertainment (UK)",
                     "rating":6,
                     "formats":[
                        "Blu-ray"
                     ],
                     "year":"2010 11 15",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar [2 Discs] [Bilingual] [Blu-ray/DVD]",
                     "studio":"20th Century Fox (Canadian)",
                     "rating":6,
                     "formats":[
                        "Blu-ray",
                        "DVD"
                     ],
                     "year":"2010 04 22",
                     "hasCommentary":true,
                     "isPurchasable":true
                  },
                  {
                     "ids":"",
                     "title":"Avatar [Bilingual]",
                     "studio":"20th Century Fox (Canadian)",
                     "rating":6,
                     "formats":[
                        "DVD"
                     ],
                     "year":"2010 04 22",
                     "hasCommentary":true,
                     "isPurchasable":true
                  }
               ],
               "releasesUri":"http://api.rovicorp.com/v1/movie/releases?format=json&apikey=4p1k3y&movieid=V+++352199",
               "review":null,
               "reviewUri":"http://api.rovicorp.com/v1/movie/review?format=json&apikey=4p1k3y&movieid=V+++352199",
               "similar":null,
               "similarUri":"http://api.rovicorp.com/v1/movie/similar?format=json&apikey=4p1k3y&movieid=V+++352199",
               "synopsis":null,
               "synopsisUri":"http://api.rovicorp.com/v1/movie/synopsis?format=json&apikey=4p1k3y&movieid=V+++352199",
               "themes":null,
               "themesUri":"http://api.rovicorp.com/v1/movie/themes?format=json&apikey=4p1k3y&movieid=V+++352199",
               "tones":null,
               "tonesUri":"http://api.rovicorp.com/v1/movie/tones?format=json&apikey=4p1k3y&movieid=V+++352199",
               "types":null,
               "typesUri":"http://api.rovicorp.com/v1/movie/types?format=json&apikey=4p1k3y&movieid=V+++352199",
               "videos":null,
               "videosUri":"http://api.rovicorp.com/v1/movie/videos?format=json&apikey=4p1k3y&movieid=V+++352199",
               "studio":"",
               "producedBy":"Ingenious Film Partners",
               "producedBy":"Dune Entertainment",
               "releasedBy":"20th Century Fox",
               "distributor":null
            }
         }
      ],
      "totalResultCounts":5,
      "facetCounts":[
         {
            "name":"type",
            "facetCount":[
               {
                  "name":"Movie",
                  "count":5
               }
            ]
         }
      ]
   }
}

Response Example 4

The first pop/rock song out of 136 that are titled My Way. Requested with
http://api.rovicorp.com/search/v2/music/search?apikey=apikey&sig=sig&query=my+way&entitytype=song&
facet=type&facet=genre&filter=genreid:MA0000002613&size=1.
{
   "searchResponse":{
      "meta:id":"tul1cpgpsrapp3:gwy:om0q",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":[
            ""
         ]
      },
      "results":[
         {
            "type":"song",
            "relevance":[
               {
                  "code":"Score",
                  "value":2.0581145
               }
            ],
            "id":"MT0000267651",
            "messages":null,
            "song":{
               "ids":{
                  "amgClassicalTrackId":null,
                  "amgPopTrackId":null,
                  "isrcId":null,
                  "muzeId":3223021,
                  "trackId":"MT0000267651"
               },
               "title":"My Way",
               "primaryArtists":[
                  {
                     "id":"MN0000745915",
                     "name":"Paul Anka"
                  }
               ],
               "isPick":true,
               "genres":[
                  {
                     "id":"MA0000011877",
                     "name":"Vocal",
                     "weight":9
                  },
                  {
                     "id":"MA0000002613",
                     "name":"Pop/Rock",
                     "weight":8
                  }
               ],
               "appearances":null,
               "appearancesUri":"http://api.rovicorp.com/v1/song/appearances?format=json&apikey=4p1k3y&trackId=MT0000267651",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/v1/song/moods?format=json&apikey=4p1k3y&trackId=MT0000267651",
               "review":null,
               "reviewUri":"",
               "styles":null,
               "stylesUri":"http://api.rovicorp.com/v1/song/styles?format=json&apikey=4p1k3y&trackId=MT0000267651",
               "themes":null,
               "themesUri":"http://api.rovicorp.com/v1/song/themes?format=json&apikey=4p1k3y&trackId=MT0000267651",
               "sample":null,
               "sampleUri":"http://api.rovicorp.com/v1/song/sample?format=json&apikey=4p1k3y&trackId=MT0000267651"
            }
         }
      ],
      "totalResultCounts":304,
      "facetCounts":[
         {
            "name":"type",
            "facetCount":[
               {
                  "name":"Track",
                  "count":304
               }
            ]
         },
         {
            "name":"genre",
            "facetCount":[
               {
                  "id":"MA0000004431",
                  "name":"Religious",
                  "count":1
               },
               {
                  "id":"MA0000002572",
                  "name":"Electronic",
                  "count":47
               },
               {
                  "id":"MA0000002809",
                  "name":"R&B",
                  "count":16
               },
               {
                  "id":"MA0000004432",
                  "name":"Stage & Screen",
                  "count":2
               },
               {
                  "id":"MA0000002467",
                  "name":"Blues",
                  "count":2
               },
               {
                  "id":"MA0000002532",
                  "name":"Country",
                  "count":16
               },
               {
                  "id":"MA0000002820",
                  "name":"Reggae",
                  "count":1
               },
               {
                  "id":"MA0000011877",
                  "name":"Vocal",
                  "count":29
               },
               {
                  "id":"MA0000002567",
                  "name":"Easy Listening",
                  "count":4
               },
               {
                  "id":"MA0000002674",
                  "name":"Jazz",
                  "count":30
               },
               {
                  "id":"MA0000002592",
                  "name":"Folk",
                  "count":14
               },
               {
                  "id":"MA0000002660",
                  "name":"International",
                  "count":18
               },
               {
                  "id":"MA0000002816",
                  "name":"Rap",
                  "count":1
               },
               {
                  "id":"MA0000002745",
                  "name":"New Age",
                  "count":1
               },
               {
                  "id":"MA0000002613",
                  "name":"Pop/Rock",
                  "count":304
               }
            ]
         }
      ]
   }
}

Error Codes

CodeDescription
400 Incorrect or invalid request. The reason is shown in the Message object in ControlSet.
502 No results found. The Message object in ControlSet returns the following:
  {
      "code": "Empty Result",
      "name": "No results available for this request"
  }

See Also

↑ Top

Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/SnR/V2/FullSearch"
Personal tools