Data/descriptor-api/v1.1/descriptor/subgenres

Jump to: navigation, search

Descriptor/Subgenres

Returns descriptions of the subgenres recognized by Rovi Music and Rovi DVDs, and the music styles of music subgenres. This request gives you the following options:

  • To get information about particular subgenres, specify the subgenre IDs in the request.
  • To get information about all subgenres, do not specify a subgenre ID. The response contains information about all movie subgenres in alphabetical order, followed by all music subgenres.
  • To include the list of music styles that apply to a music subgenre, specify the include=styles parameter in the request.

Syntax

descriptor/subgenres?apikey=apikey&sig=sig [&subgenreids=subgenreids] [&include=include] [&format=format] [&country=country] [&language=language]

Request Example 1

Request descriptions of all subgenres.

Request Example 2

Request a description of the movie subgenre black comedy.

Request Example 3

Request a description of the music subgenre garage and a list of its music styles in an XML response.

Request Parameters

Sort none.gif  Click to re-sort

Parameter Required Description
apikey Yes Access code that authorizes your request for data from Rovi.
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.

country No Country the language parameter applies to. The current release of the API supports only US.
format No Format of the returned data: json or xml. The default is JSON.
include No The request for music styles of music subgenres. To include music styles in the response, add include=styles or include=all.
language No Language of the response data. This request supports only en (English).
subgenreids No Specific subgenre IDs you want information about. Replace any spaces in an ID with plus (+) or percent20 (%20) symbols. To specify multiple IDs, use a comma-separated list like this: subgenreids=MA0000012228,MA0000002544,D+++513.

If not specified, all movie subgenres are returned in alphabetical order, followed by all music subgenres.

Response

Response Header

ResponseTypeDescription
buildstringThe software release level of the API.
codeintegerHTTP status code. See the status field for the text part of the code.
durationintegerServer processing time in milliseconds. The difference between startTime and endTime.
endTimestringWhen the server sent the response (UTC time).
messagesMessage [ ]Elements of a multiple HTTP response status message.
parametersparametersThe parameters that were included in the request.
serverNamestringName of the server that processed the request.
startTimestringWhen the server received the request (UTC time).
statusstringText part of the HTTP status code, which is shown in the code field.
viewviewSummary of items returned in a list of items.

Response for Descriptor/Subgenres

ResponseTypeDescription
subgenres subgenre [ ] Subgenre descriptions and, if requested, the music styles of the music subgenres.

If you do not specify a subgenre ID, all movie subgenres are returned in alphabetical order, followed by all music subgenres.

JSON Response Example

Here's the response to Request Example 2, which asks for a description of the movie subgenre black comedy. The response is formatted with extra spaces and carriage returns to make it easy to read.
Requested with http://api.rovicorp.com/data/v1.1/descriptor/subgenres?apikey=apikey&sig=sig&
subgenreids=D+++528
.
{
   "status":"ok",
   "code":200,
   "messages":null,
   "build":"1.7.2.5",
   "parameters":{
      "apiKey":"4p1k3y",
      "id":"D   528"
   },
   "view":{
      "total":1
   },
   "serverName":"tul1cssw1",
   "startTime":"2011-10-08T01:10:28.4118277Z",
   "endTime":"2011-10-08T01:10:28.4118277Z",
   "duration":0,
   "subgenres":[
      {
         "id":"D 528",
         "name":"Black Comedy",
         "type":"Movie SubGenre",
         "description":"A comedy with a wicked sense of humor -- often dark, cynical and edgy -- that makes fun of such supposedly serious subjects as death, illness, murder, or war. Nothing is sacred from attack in black comedy, and all taboos are welcome. Black comedy first found popularity in the 1940s and 1950s, in a world that was struggling to understand the global evil of Nazism and its second World War in less than three decades. In America, {#Arsenic and Old Lace} was among the first examples, while the British perfected the form with films like {#The Ladykillers} and {#Kind Hearts and Coronets}. Since the '40s, the British have taken the form to new, darker levels, with films like {#The Wrong Box}, {#If...}, {#The Cook, The Thief, His Wife and Her Lover}, {#A Zed and Two Noughts}, {#Brazil} and the work of {$Monty Python}. In America, black comedies have increased in number with the rise of independent filmmaking (though {#M*A*S*H}, {#Harold and Maude}, and the films of {$Tim Burton} are fine studio examples). Directors like {$John Waters}, the {$Coen Brothers}, {$Paul Bartel}, and early {$Brian De Palma} blended black comedy with social issues and\/or absurdism. Abroad, directors like {$Luis Buñuel}, {$Roman Polanski}, {$Juzo Itami}, {$Pedro Almodovar} and {$Paul Verhoeven} are just a handful of filmmakers who have kept the style alive and vital.",
         "genre":{
            "id":"D 531",
            "name":"Comedy Drama"
         }
      }
   ]
}

XML Response Example

Here's the response to Request Example 3, which asks for a description of the music subgenre garage and a list of its music styles in an XML response.
Requested with http://api.rovicorp.com/data/v1.1/descriptor/subgenres?apikey=apikey&sig=sig&
include=all&subgenreids=MA0000012308&format=xml
.
<SubGenres xmlns="com.rovicorp.metadataservice" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <status>ok</status>
  <code>200</code>
  <messages i:nil="true"/>
  <build>1.7.2.5</build>
  <parameters>
    <apiKey>4p1k3y</apiKey>
    <id>MA0000012308</id>
    <include>all</include>
    <format>xml</format>
  </parameters>
  <view>
    <total>1</total>
  </view>
  <serverName>tul1cssw4</serverName>
  <startTime>2011-10-08T01:20:31.1292650Z</startTime>
  <endTime>2011-10-08T01:20:31.1292650Z</endTime>
  <duration>0</duration>
  <subgenres>
    <subgenre>
      <id>MA0000012308</id>
      <name>Garage</name>
      <type>Music SubGenre</type>
      <description>Named for what is arguably the birthplace of house music — the Paradise Garage in New York — Garage is the dance style closest in spirit and execution to the original disco music of the &apos;70s. Favoring synthesizer runs and gospel vocals similar to house music but with even more polished and shimmering production values than house, garage has more of a soulful, organic feel. Though the style&apos;s led by producer/DJs ([roviLink=&quot;MN&quot;]Todd Terry[/roviLink], [roviLink=&quot;MN&quot;]Tony Humphries[/roviLink], [roviLink=&quot;MN&quot;]Kerri Chandler[/roviLink]) and production teams ([roviLink=&quot;MN&quot;]Masters at Work[/roviLink], [roviLink=&quot;MN&quot;]Blaze[/roviLink]), vocalists who bring the soulful anthems to life ([roviLink=&quot;MN&quot;]Ultra Naté[/roviLink], [roviLink=&quot;MN&quot;]Dajae[/roviLink], [roviLink=&quot;MN&quot;]Jocelyn Brown[/roviLink], and [roviLink=&quot;MN&quot;]Loleatta Holloway[/roviLink], among many others) are much more important than in other forms of dance music. During the early &apos;80s, garage was originally centered in the New York metro area, mostly in Manhattan, but strong enough across state lines to later be dubbed the Jersey Sound as well. At that time, the early history of garage is practically synonomous with that of house music. It was only when Chicago house became popular around the world that New York&apos;s discofied garage emerged as a separate entity from house music in general. (Consequently, the sound that many Brits pointed to as an influence was Midwestern in origin.) By no means forgotten, though, New York gained ascendance by the turn of the decade, with British producer [roviLink=&quot;MN&quot;]Joey Negro[/roviLink] showing garage influences through his Republic label. Spurred on by admiration from the U.K., a flock of fresh New York labels opened up during the late &apos;80s and early &apos;90s — [roviLink=&quot;MN&quot;]Strictly Rhythm[/roviLink], [roviLink=&quot;MN&quot;]King Street[/roviLink], [roviLink=&quot;MN&quot;]Nervous[/roviLink], [roviLink=&quot;MN&quot;]Perfect Pair[/roviLink], [roviLink=&quot;MN&quot;]Freeze[/roviLink], [roviLink=&quot;MN&quot;]Streetside[/roviLink]. London&apos;s influential Ministry of Sound even tapped [roviLink=&quot;MN&quot;]Tony Humphries[/roviLink] for an exclusive deal to DJ for its club and produce for its accompanying label. By 1996, a British variant of garage had emerged, dubbed speed garage (and later 2-step) for its aggressive synthesis of drum&apos;n&apos;bass and ragga with the original garage sound.</description>
      <styles>
        <style>
          <id>MA0000004479</id>
          <name>2-Step/British Garage</name>
          <type>Music Style</type>
        </style>
        <style>
          <id>MA0000004465</id>
          <name>Dubstep</name>
          <type>Music Style</type>
        </style>
        <style>
          <id>MA0000004464</id>
          <name>Garage Rap/Grime</name>
          <type>Music Style</type>
        </style>
      </styles>
      <genre>
        <id>MA0000002572</id>
        <name>Electronic</name>
      </genre>
    </subgenre>
  </subgenres>
</SubGenres>


See Also

↑ Top

Personal tools