Home | Index

Yahoo! Music API Guide

Responses

Category List Response (application/xml - ym:Categories)

Overall XML Structure

        

<?xml version="1.0" encoding="utf-8"?>
<Categories>
   <CategoryType name="genre">
      <Category id="7318636" name="Electronic/Dance" videoCount="25" artistCount="102" releaseCount="723" trackCount="2380" hasVideoStation="0" hasAudioStation="1" rating="30">
         <Category id="7318653" name="Ambient" videoCount="12" artistCount="46" releaseCount="236" trackCount="685" hasVideoStation="0" hasAudioStation="1" rating="-1">
            <Category id="7318760" name="Ambient Dub" videoCount="12" artistCount="25" releaseCount="125" trackCount="346" hasVideoStation="0" hasAudioStation="1" rating="-1" />
            <Category id="7318761" name="Ambient Tech" videoCount="0" artistCount="21" releaseCount="111" trackCount="339" hasVideoStation="0" hasAudioStation="1" rating="-1" />
         </Category>
         <Category id="7318654" name="Breaks" videoCount="13" artistCount="56" releaseCount="487" trackCount="1758" hasVideoStation="1" hasAudioStation="1" rating="-1" />
      </Category>
      <Category id="7318638" name="Rap" videoCount="78" artistCount="185" releaseCount="648" trackCount="1850" hasVideoStation="1" hasAudioStation="1" rating="80" >
         <Category id="7318667" name="Alternative Rap" videoCount="32" artistCount="102" releaseCount="217" trackCount="784" hasVideoStation="1" hasAudioStation="1" rating="-1" />
      </Category>
   </CategoryType>
</Categories>

        
      

shortdesc

<ShortDescription>This is the electronica category.</ShortDescription>

See “ShortDescription XML Block” for XML attributes & description.

longdesc

<LongDescription>Reaching back to grab the grooves of '70s disco/funk 
                 and the gadgets of electronic composition, 
                 Electronica soon became a whole new entity in and of itself, spinning off new sounds and subgenres 
                 with no end in sight two decades down the pike. Its beginnings came in the post-disco environment 
                 of Chicago/New York and Detroit, the cities who spawned house and techno (respectively) during the 
                 1980s. Later that decade, club-goers in Britain latched onto the fusion of mechanical and sensual, 
                 and returned the favor to hungry Americans with new styles like jungle/drum'n'bass and trip-hop. 
                 Though most all early electronica was danceable, by the beginning of the '90s, producers 
                 were also making music for the headphones and chill-out areas as well, resulting in dozens of stylistic 
                 fusions like ambient-house, experimental techno, tech-house, electro-techno, etc. Typical for the 
                 many styles gathered under the umbrella was a focus on danceable grooves, very loose song structure 
                (if any), and, in many producers, a relentless desire to find a new sound no matter how tepid the results.
</LongDescription>

See “LongDescription XML Block” for XML attributes & description.

artists

<Artist id="123456" 
        name="Gorillaz" /> 
<Artist id="123256" 
        name="Depeche Mode" /> 
<Artist id="123256" 
        name="Abba" /> 
<Artist id="123256" 
        name="DJ Tiesto" /> 
<Artist id="123256" 
        name="Pet Shop Boys" />

See “Artist XML Block” for XML attributes & description.

radiostation

<Station itemType="radio" 
         stationType="category" 
         id="7318646" 
         name="Pop Radio Station" />

See “RadioStations XML Block” for XML attributes & description.

videostation

<Station itemType="video" 
         stationType="category" 
         id="7318646" 
         name="Pop Video Station" />

See “Station XML Block” for XML attributes & description.

sorts

<Sorts> 
  <Sort name="Artist Name"> 
    <Order name="Artist Name ascending" 
           id="artistName+" default="1" /> 
    <Order name="Artist Name descending" 
           id="artistName-" /> 
  </Sort> 
  <Sort name="Date Added"> 
    <Order name="Date Added descending" 
           id="dateAdded-" 
           default="1" /> 
    <Order name="Date Added ascending" 
           id="dateAdded+" /> 
  </Sort> 
</Sorts>

See “Sorts XML Block” for XML attributes & description.