Search-api/v2.1/single-stage-search

Jump to: navigation, search

SingleStageSearch

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

This request returns a large amount of data, especially if you use the include parameter to return additional data. To speed data transmission, do the following:

  • Request only data that you need to immediately display.
  • Request a compressed response by including Accept-Encoding: gzip,deflate in the HTTP header.

Syntax

endpoint/singlestagesearch?apikey=apikey&sig=sig&entitytype=entitytype&query=query [&filter=filter] [&include=include] [&clu=clu] [&start=start] [&end=end] [&rep=rep] [&facet=facet] [&format=format] [&country=country] [&language=language] [&offset=offset] [&size=size]

Request Example 1

From the characters Lo, return movies that are appearing on Time Warner Cable in Beverly Hills today.

Request Example 2

From the characters be, return rap songs in an XML response along with the number of results available in all genres.

Request Example 3

From the character m, return movies with a baseball theme and a synopsis.

Request Example 4

From the characters be, return music artists and include images that fit a bounding box of 250 x 250 pixels.

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 songssong
albumsalbum
compositionscomposition
people working in musicartist
amgvideo moviesmovie
TV seriestvseries
people working in TV or moviescredit
video ⊑⊒moviesmovie
TV seriestvseries
episode titlesepisode
TV programsonetimeonly
people working in TV or moviescredit
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, 32-hex-digit authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three ASCII 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.

Express the alpha hex digits as lower case.

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.

clu No Service ID of a television service that has upcoming movies or TV series you want to match against. Service IDs for television services are available with calls to Services.

Broadcast times of programs are returned in availabilities objects. To return more than one broadcast time, specify the rep parameter.

Notes:

  • Requires an endpoint of video.
  • Requires an entitytype of movie or tvseries.
  • To check multiple television services, specify multiple parameters like this: clu=360861&clu=20494.
  • To limit the broadcast time window to less than the next two weeks, specify the start or end parameters, or both.
  • To return only programs in the broadcast time window, add filter=availability to the request.
  • Here are some Service IDs you can use for evaluation tests:
    • 20419 — Chicago Area Broadcast TV
    • 890504 — CanalSat in Paris, France
    • 68809 — Shaw Cable in Moose Jaw, Saskatchewan
    • 60795 — Time Warner Cable in Southern Manhattan
    • 360861 — Time Warner Cable in Beverly Hills, California
country No Country the language parameter applies to. The current release of the API supports only US.
end No If you specify the clu parameter, end specifies the end of the broadcast time window in one of the following formats:
  • UTC time: YYYYmmDDhhMMssZ. For example: 20120315140000Z for 2012-03-15 14:00:00 GMT.
  • Local time with a UTC offset: YYYYmmDDhhMMss + or - hhMM (positive or negative offset). For example, for the same time specified as US Pacific time: 201203150600000800.

If not specified, the end time is two weeks after the time of the request.

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.
  • Specify filter=availability to return only upcoming movies or TV series on the television service specified by the clu parameter.

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)

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

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

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
  • availability
  • 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)
availability (video endpoint) *
2008
1 to 10 (amgvideo endpoint)

onetimeonly
  • length

120 (minutes, integer)

tvseries
  • mpaa
  • adult
  • length
  • toneid
  • moodid
  • themeid
  • genreid
  • subgenreid
  • availability
  • 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)
availability (video endpoint) *
1 to 10 (amgvideo endpoint)

* Note: The availability filter is specified without a value, like this: filter=availability. Use this to filter out movies or TV series that are not airing on the television service specified by the clu parameter.

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.

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
video ⊑⊒onetimeonly
  • All
  • Awards
  • Cast
  • Crew
  • Event
  • Images
  • Keywords
  • Review
  • Synopsis
  • Themes
  • Tones
language No Language of the response data. This request supports only en (English).
offset No Counting from zero as the first item in the returned list, the number of the first item you want. The default is zero. The maximum is 3000.

Use the offset and size parameters to paginate the available results.

rep No If you specify the clu parameter, rep specifies the maximum number of broadcasts to be reported in the availabilities object. For example, to return up to five broadcasts during the time specified, specify rep=5. Default is 1.
size No The number of items you want to be returned. The default is 20.
start No If you specify the clu parameter, start specifies the start of the broadcast time window in one of the following formats:
  • UTC time: YYYYmmDDhhMMssZ. For example: 20120315140000Z for 2012-03-15 14:00:00 GMT.
  • Local time with a UTC offset: YYYYmmDDhhMMss + or - hhMM (positive or negative offset). For example, for the same time specified as US Pacific time: 201203150600000800.

If not specified, the start time is the time of the request.

Response

Response Header

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

Response for SingleStageSearch

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 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

Here's the response to Request Example 1, looking for movies appearing on Time Warner Cable in Beverly Hills today with the characters Lo. Just the top result is requested to show as a sample.
Requested with http://api.rovicorp.com/search/v2.1/video/singlestagesearch?apikey=apikey&sig=sig&
entitytype=movie&clu=360861&filter=availability&end=20140318080000Z&size=1&query=lo
{
   "searchResponse":{
      "meta:id":"tul1cpgpsrapp7:gwy:3novlu",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"movie",
            "relevance":[
               {
                  "code":"Score",
                  "value":0.6865882
               }
            ],
            "availabilities":[
               {
                  "end":"20140318050000+0000",
                  "format":"sd",
                  "source":"CLU_360861",
                  "cosmosource":3646,
                  "start":"20140318030000+0000",
                  "available_as":{
                     "id":4819679,
                     "type":"CosmoIdProgram"
                  }
               }
            ],
            "id":4819679,
            "messages":null,
            "video":{
               "ids":{
                  "amgMovieId":null,
                  "cosmoId":"4819679",
                  "iguideId":4819679,
                  "pidPaid":null,
                  "videoId":null
               },
               "seriesIds":null,
               "masterTitle":"The Longest Yard",
               "secondaryTitle":"",
               "episodeTitle":null,
               "category":"Movie",
               "color":"Color",
               "lastAirDate":null,
               "originalAirDate":null,
               "programType":"Movie",
               "releaseYear":2005,
               "duration":113,
               "subcategory":"comedy-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=4819679",
               "cast":null,
               "castUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/cast?format=json&apikey=4p1k3y&cosmoid=4819679",
               "crew":null,
               "crewUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/crew?format=json&apikey=4p1k3y&cosmoid=4819679",
               "awards":null,
               "awardsUri":null,
               "images":null,
               "imagesUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/images?format=json&apikey=4p1k3y&cosmoid=4819679",
               "clip":null,
               "clipUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/clip?format=json&apikey=4p1k3y&cosmoid=4819679",
               "seasons":null,
               "seasonsUri":null,
               "schedule":"",
               "scheduleUri":null,
               "event":null,
               "eventUri":null,
               "keywords":null,
               "keywordsUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/keywords?format=json&apikey=4p1k3y&cosmoid=4819679",
               "moods":null,
               "moodsUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/moods?format=json&apikey=4p1k3y&cosmoid=4819679",
               "related":null,
               "relatedUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/related?format=json&apikey=4p1k3y&cosmoid=4819679",
               "review":null,
               "reviewUri":null,
               "synopsis":null,
               "synopsisUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/synopsis?format=json&apikey=4p1k3y&cosmoid=4819679",
               "themes":null,
               "themesUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/themes?format=json&apikey=4p1k3y&cosmoid=4819679",
               "tones":null,
               "tonesUri":"http:\/\/api.rovicorp.com\/data\/v1.1\/video\/tones?format=json&apikey=4p1k3y&cosmoid=4819679"
            }
         }
      ],
      "totalResultCounts":7
   }
}

Response Example 2

Here's a response to Request Example 2, looking for rap songs with the characters be and the number of results available in all genres. Just the top result is requested to show as a sample.
Requested with http://api.rovicorp.com/search/v2.1/music/singlestagesearch?apikey=apikey&sig=sig&
entitytype=song&filter=genreid:MA0000002816&facet=genre&size=1&format=xml&query=be
.
<?xml version="1.0" ?>
<searchResponse 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="tul1cpgpsrapp30:gwy:3l31ai">
  <controlSet>
    <status>ok</status>
    <code>200</code>
    <messages i:nil="true" />
  </controlSet>
  <results>
    <result>
      <type>song</type>
      <relevance>
        <code>Score</code>
        <value>0.086718</value>
      </relevance>
      <availabilties xmlns="com.rovicorp.snrservice" />
      <id>MT0007684203</id>
      <messages i:nil="true" />
      <song>
        <ids>
          <amgClassicalTrackId i:nil="true" />
          <amgPopTrackId>T 27563260</amgPopTrackId>
          <isrcId>USPO10200092</isrcId>
          <muzeId>5558095</muzeId>
          <trackId>MT0007684203</trackId>
        </ids>
        <title>Beautiful</title>
        <primaryArtists>
          <AlbumArtist>
            <id>MN0000029086</id>
            <name>Snoop Dogg</name>
          </AlbumArtist>
          <AlbumArtist>
            <id>MN0000275757</id>
            <name>Pharrell Williams</name>
          </AlbumArtist>
          <AlbumArtist>
            <id>MN0000100116</id>
            <name>Charlie Wilson</name>
          </AlbumArtist>
        </primaryArtists>
        <isPick>true</isPick>
        <genres>
          <Genre>
            <id>MA0000002572</id>
            <name>Electronic</name>
            <weight>5</weight>
          </Genre>
          <Genre>
            <id>MA0000002816</id>
            <name>Rap</name>
            <weight>5</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=MT0007684203</appearancesUri>
        <moods i:nil="true" />
        <moodsUri>http://api.rovicorp.com/data/v1.1/song/moods?format=xml&apikey=4p1k3y&trackId=MT0007684203</moodsUri>
        <review i:nil="true" />
        <reviewUri i:nil="true" />
        <styles i:nil="true" />
        <stylesUri>http://api.rovicorp.com/data/v1.1/song/styles?format=xml&apikey=4p1k3y&trackId=MT0007684203</stylesUri>
        <themes i:nil="true" />
        <themesUri>http://api.rovicorp.com/data/v1.1/song/themes?format=xml&apikey=4p1k3y&trackId=MT0007684203</themesUri>
      </song>
    </result>
  </results>
  <totalResultCounts>2865</totalResultCounts>
  <facetCounts xmlns="com.rovicorp.snrservice" name="genre">
    <facetCount>
      <id>MA0000002572</id>
      <name>Electronic</name>
      <count>362</count>
    </facetCount>
    <facetCount>
      <id>MA0000004431</id>
      <name>Religious</name>
      <count>39</count>
    </facetCount>
    <facetCount>
      <id>MA0000012075</id>
      <name>Holiday</name>
      <count>1</count>
    </facetCount>
    <facetCount>
      <id>MA0000002809</id>
      <name>R&B</name>
      <count>160</count>
    </facetCount>
    <facetCount>
      <id>MA0000002467</id>
      <name>Blues</name>
      <count>1</count>
    </facetCount>
    <facetCount>
      <id>MA0000004433</id>
      <name>Comedy/Spoken</name>
      <count>8</count>
    </facetCount>
    <facetCount>
      <id>MA0000002692</id>
      <name>Latin</name>
      <count>53</count>
    </facetCount>
    <facetCount>
      <id>MA0000002532</id>
      <name>Country</name>
      <count>4</count>
    </facetCount>
    <facetCount>
      <id>MA0000002944</id>
      <name>Children's</name>
      <count>4</count>
    </facetCount>
    <facetCount>
      <id>MA0000002820</id>
      <name>Reggae</name>
      <count>40</count>
    </facetCount>
    <facetCount>
      <id>MA0000011877</id>
      <name>Vocal</name>
      <count>4</count>
    </facetCount>
    <facetCount>
      <id>MA0000002567</id>
      <name>Easy Listening</name>
      <count>4</count>
    </facetCount>
    <facetCount>
      <id>MA0000002674</id>
      <name>Jazz</name>
      <count>17</count>
    </facetCount>
    <facetCount>
      <id>MA0000002592</id>
      <name>Folk</name>
      <count>2</count>
    </facetCount>
    <facetCount>
      <id>MA0000002660</id>
      <name>International</name>
      <count>55</count>
    </facetCount>
    <facetCount>
      <id>MA0000012170</id>
      <name>Avant-Garde</name>
      <count>2</count>
    </facetCount>
    <facetCount>
      <id>MA0000002816</id>
      <name>Rap</name>
      <count>2865</count>
    </facetCount>
    <facetCount>
      <id>MA0000002613</id>
      <name>Pop/Rock</name>
      <count>545</count>
    </facetCount>
  </facetCounts>
</searchResponse>

Response Example 3

Here's a response to Request Example 3, looking for movies that have a baseball theme with the letter m in the title and a synopsis. Just the top result is requested to show as a sample.
Requested with http://api.rovicorp.com/search/v2.1/amgvideo/singlestagesearch?apikey=apikey&sig=sig&
entitytype=movie&filter=themeid:D++1517&include=synopsis&size=1&query=m
.
{
   "searchResponse":{
      "meta:id":"tul1cpgpsrapp13:gwy:3o6xjj",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"movie",
            "relevance":[
               {
                  "code":"Score",
                  "value":0.6731586
               }
            ],
            "id":"V 480787",
            "messages":null,
            "movie":{
               "ids":{
                  "cosmoId":"18790568",
                  "movieId":"V 480787"
               },
               "title":"Moneyball",
               "releaseYear":2011,
               "rating":7,
               "duration":126,
               "directors":[
                  {
                     "id":"P238370",
                     "name":"Bennett Miller"
                  }
               ],
               "countries":[
                  "USA"
               ],
               "mpaa":"PG13",
               "flags":[
                  "Profanity"
               ],
               "genres":[
                  {
                     "id":"D 531",
                     "name":"Comedy Drama",
                     "weight":5
                  }
               ],
               "attributes":null,
               "cast":null,
               "castUri":"http://api.rovicorp.com/data/v1.1/movie/cast?format=json&apikey=4p1k3y&movieid=V+++480787",
               "crew":null,
               "crewUri":"http://api.rovicorp.com/data/v1.1/movie/crew?format=json&apikey=4p1k3y&movieid=V+++480787",
               "images":null,
               "imagesUri":"http://api.rovicorp.com/data/v1.1/movie/images?format=json&apikey=4p1k3y&movieid=V+++480787",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/data/v1.1/movie/moods?format=json&apikey=4p1k3y&movieid=V+++480787",
               "keywords":null,
               "keywordsUri":"http://api.rovicorp.com/data/v1.1/movie/keywords?format=json&apikey=4p1k3y&movieid=V+++480787",
               "related":null,
               "relatedUri":"http://api.rovicorp.com/data/v1.1/movie/related?format=json&apikey=4p1k3y&movieid=V+++480787",
               "releases":null,
               "releasesUri":"http://api.rovicorp.com/data/v1.1/movie/releases?format=json&apikey=4p1k3y&movieid=V+++480787",
               "review":null,
               "reviewUri":"http://api.rovicorp.com/data/v1.1/movie/review?format=json&apikey=4p1k3y&movieid=V+++480787",
               "similar":null,
               "similarUri":"http://api.rovicorp.com/data/v1.1/movie/similar?format=json&apikey=4p1k3y&movieid=V+++480787",
               "synopsis":{
                  "text":"[rovilink=\"P\"]Bennett Miller[/rovilink]'s adaptation of [rovilink=\"P\"]Michael Lewis[/rovilink]' non-fiction best seller [rovilink=\"V\"]Moneyball[/rovilink] stars [rovilink=\"P\"]Brad Pitt[/rovilink] as [rovilink=\"P\"]Billy Beane[/rovilink], a one-time phenom who flamed out in the big leagues and now works as the GM for the Oakland Athletics, a franchise that's about to lose their three best players to free agency. Because the team isn't in a financial position to spend as much as perennial favorites like the Yankees and the Red Sox, [rovilink=\"P\"]Beane[/rovilink] realizes he needs to radically change how he evaluates what players can bring to the squad. After he meets Peter Brand ([rovilink=\"P\"]Jonah Hill[/rovilink]), an Ivy League economics major working as an executive assistant for scouting on another team, [rovilink=\"P\"]Beane[/rovilink] realizes he's found the man who understands how to subvert the system of assessing players that's been in place for nearly a century. However, as the duo begin to acquire players that seem too old, injured, or inept to play major-league baseball, they face stiff resistance from both the A's longtime scouts and the team's manager [rovilink=\"P\"]Art Howe[/rovilink] ([rovilink=\"P\"]Philip Seymour Hoffman[/rovilink]), who outright refuses to allow [rovilink=\"P\"]Beane[/rovilink]'s more-nontraditional acquisitions to play. [rovilink=\"V\"]Moneyball[/rovilink] screened at the 2011 [rovilink=\"P\"]Toronto International Film Festival[/rovilink].",
                  "author":"Perry Seibert"
               },
               "synopsisUri":"http://api.rovicorp.com/data/v1.1/movie/synopsis?format=json&apikey=4p1k3y&movieid=V+++480787",
               "themes":null,
               "themesUri":"http://api.rovicorp.com/data/v1.1/movie/themes?format=json&apikey=4p1k3y&movieid=V+++480787",
               "tones":null,
               "tonesUri":"http://api.rovicorp.com/data/v1.1/movie/tones?format=json&apikey=4p1k3y&movieid=V+++480787",
               "types":null,
               "typesUri":"http://api.rovicorp.com/data/v1.1/movie/types?format=json&apikey=4p1k3y&movieid=V+++480787",
               "videos":null,
               "videosUri":"http://api.rovicorp.com/data/v1.1/movie/videos?format=json&apikey=4p1k3y&movieid=V+++480787",
               "studio":"",
               "producedBy":null,
               "releasedBy":[
                  "Columbia Pictures"
               ],
               "distributor":null
            }
         }
      ],
      "totalResultCounts":58
   }
}

Response Example 4

Here's the response to Request Example 4, looking for music artists with the characters be in their name and images that fit a bounding box of 250 x 250 pixels. Just the top result is requested to show as a sample.
Requested with http://api.rovicorp.com/search/v2.1/music/singlestagesearch?apikey=apikey&sig=sig&
entitytype=artist&include=images&formatid=44&size=1&query=be
.
{
   "searchResponse":{
      "meta:id":"tul1cpgpsrapp14:gwy:3lnqq4",
      "controlSet":{
         "status":"ok",
         "code":200,
         "messages":null
      },
      "results":[
         {
            "type":"artist",
            "relevance":[
               {
                  "code":"Score",
                  "value":1.0000168
               }
            ],
            "id":"MN0000761179",
            "messages":null,
            "name":{
               "ids":{
                  "amgClassicalId":"Q 134699",
                  "amgMovieId":"P487106",
                  "amgPopId":"P 349078",
                  "cosmoId":null,
                  "nameId":"MN0000761179"
               },
               "name":"BeyoncĂ©",
               "isGroup":false,
               "primaryMedia":"Music\\Popular",
               "musicGenres":[
                  {
                     "id":"MA0000002809",
                     "name":"R&B",
                     "weight":10
                  }
               ],
               "movieGenres":[
                  {
                     "id":"D 1776",
                     "name":"Music [nf]",
                     "weight":99
                  }
               ],
               "active":[
                  "1990s",
                  "2000s",
                  "2010s"
               ],
               "birth":{
                  "date":"1981-09-04",
                  "place":"Houston, TX"
               },
               "death":{
                  "date":"",
                  "place":""
               },
               "country":"United States of America",
               "period":"2003-2012",
               "headlineBio":"R&B's biggest superstar of the new millennium, a vocal and performance dynamo with chart-busting albums, film roles, and a relationship with Jay-Z.",
               "classicalBio":null,
               "classicalBioUri":null,
               "discography":null,
               "discographyUri":"http://api.rovicorp.com/data/v1.1/name/discography?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "filmography":null,
               "filmographyUri":"http://api.rovicorp.com/data/v1.1/name/filmography?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "followers":null,
               "followersUri":"http://api.rovicorp.com/data/v1.1/name/followers?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "groupMembers":null,
               "groupMembersUri":null,
               "memberOf":null,
               "memberOfUri":"http://api.rovicorp.com/data/v1.1/name/memberOf?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "images":[
                  {
                     "height":250,
                     "width":166,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":0
                  },
                  {
                     "height":250,
                     "width":166,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":1
                  },
                  {
                     "height":250,
                     "width":166,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":1
                  },
                  {
                     "height":250,
                     "width":241,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":1
                  },
                  {
                     "height":166,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":1
                  },
                  {
                     "height":200,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":1
                  },
                  {
                     "height":249,
                     "width":250,
                     "formatid":44,
                     "url":"http://actual-url-concealed.jpg",
                     "author":null,
                     "copyrightOwner":null,
                     "imageTypeId":3,
                     "zoomLevel":0,
                     "override":false,
                     "musicSort":1
                  }
               ],
               "imagesUri":"http://api.rovicorp.com/data/v1.1/name/images?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "influencers":null,
               "influencersUri":"http://api.rovicorp.com/data/v1.1/name/influencers?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "similars":null,
               "similarsUri":"http://api.rovicorp.com/data/v1.1/name/similars?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "moods":null,
               "moodsUri":"http://api.rovicorp.com/data/v1.1/name/moods?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "movieBio":null,
               "movieBioUri":"http://api.rovicorp.com/data/v1.1/name/movieBio?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "musicBio":null,
               "musicBioUri":"http://api.rovicorp.com/data/v1.1/name/musicBio?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "musicCredits":null,
               "musicCreditsUri":"http://api.rovicorp.com/data/v1.1/name/musicCredits?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "songs":null,
               "songsUri":"http://api.rovicorp.com/data/v1.1/name/songs?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "musicStyles":null,
               "musicStylesUri":"http://api.rovicorp.com/data/v1.1/name/musicStyles?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "themes":null,
               "themesUri":"http://api.rovicorp.com/data/v1.1/name/themes?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "videos":null,
               "videosUri":"http://api.rovicorp.com/data/v1.1/name/videos?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "movieStyles":null,
               "movieStylesUri":"http://api.rovicorp.com/data/v1.1/name/movieStyles?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "contemporaries":null,
               "contemporariesUri":null,
               "associatedWith":null,
               "associatedWithUri":"http://api.rovicorp.com/data/v1.1/name/associatedWith?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "collaboratorWith":null,
               "collaboratorWithUri":null,
               "compositions":null,
               "compositionsUri":"http://api.rovicorp.com/data/v1.1/name/compositions?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "aliases":null,
               "aliasesUri":"http://api.rovicorp.com/data/v1.1/name/aliases?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "web":null,
               "webUri":"http://api.rovicorp.com/data/v1.1/name/web?format=json&apikey=4p1k3y&nameid=MN0000761179",
               "factsheets":null,
               "factsheetsUri":null,
               "schedule":null,
               "scheduleUri":null,
               "credits":null,
               "creditsUri":null
            }
         }
      ],
      "totalResultCounts":55343
   }
}

Error Codes

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

See Also

↑ Top

Personal tools