Home | Index

Yahoo! Music API Guide

Responses

Artist List Response (application/xml - ym:Artists)

Overall XML Structure

        <Artists> <Artist> <Category/>
        <Releases/> <TopSimilarArtists/> <TopTracks/>
        <RadioStations/> <Events/> <Fans/> <ItemInfo/>
        <Video/> </Artist> </Artists>
      

main

Example:

          <Artist id="313824" name="Eagles" rating="-1" flags="49087"
          hotzillaID="1802138795" catzillaID="1927003528"
          website="http://www.eaglesband.com" salesGenreCode="12" />
        

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

categories

Example:

          <Category id="7318647" rating="-1" name="Pop" type="Genre"
          /> <Category id="7318736" rating="-1" name="Adult Alternative"
          type="Genre" />
        

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

releases

Example:

          <Releases> <Release id="24919" title="I'll Remember:
          Theme From The Motion Picture With Honors" releaseYear="1994"
          typeID="1" rights="1904"> </Release>
          </Releases>
        

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

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

toptracks

          <TopTracks> <Track id="25519875" title="Hung Up"
          discNumber="1" trackNumber="1" duration="339" rights="1904">
          <Album> <Release id="25519852" title="Confessions On A
          Dance Floor" explicit="0" releaseYear="2005" /> </Album>
          </Track> </TopTracks>
        

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

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

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

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

topsimilar

          <TopSimilarArtists> <Artist id="257186" name="Kylie
          Minogue" /> <Artist id="291668" name="Robbie Williams" />
          <Artist id="301411" name="Cher" /> <Artist id="252360"
          name="Michael Jackson" /> <Artist id="252708" name="Jewel"
          /> </TopSimilarArtists>
        

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

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

radio

          <RadioStations> <Station itemType="radio"
          stationType="artist" id="256352" name="Madonna Fan Station"/>
          <Station itemType="radio" stationType="category" id="7318646"
          name="Pop Station" /> <Station itemType="radio"
          stationType="category" id="7318648" name="Dance Station" />
          </RadioStations>
        

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

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

fans

          <Fans> <Fan ymid="1209748465" yid="jmattessich" />
          <Fan ymid="1028089063" yid="egjeckeln" /> <Fan
          ymid="1528105020" yid="princehaldir" /> </Fans>
        

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

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

videos

          <Video id="14330555" rating="-1" title="Do Somethin'"
          typeID="1" localOnly="0" salesGenre="249563" copyrightYear="2005"
          label="Jive" explicit="0" /> <Video id="21279188" rating="-1"
          title="Someday" typeID="1" localOnly="0" salesGenre="249563"
          copyrightYear="2005" label="Jive" explicit="0" /> <Video
          id="2159232" rating="-1" title="Toxic" typeID="1" localOnly="0"
          salesGenre="249563" copyrightYear="2004" label="Jive" explicit="0"
          /> <Video id="2165110" rating="-1" title="Everytime"
          typeID="1" localOnly="0" salesGenre="249563" copyrightYear="2004"
          label="Zomba" explicit="0" />
        

See “Video 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.