API 2.0 Version 1.0
album
Contains all the information about an album.
Child Elements
Element Description Empty Allowed? Cardinality?
itemid
Uniquely identifies the album.
no 1
pid
Another identifier for the album. It is being deprecated and should not be used.
no 1
owner
Username of the account that created the object.
yes 1
status
Allowed values are:
  • online - The album is visible on platforms served by InstantEncore.
  • pending - The album is not visible on platforms served by InstantEncore.
 no 1
date-added
The DateTime the object was added to InstantEncore.
no 1
first-online
The DateTime the album status was first turned to online. If the album status has not been set online the value is empty.
yes 1
release-date
The DateTime the album was made available to the public.
yes 1
title
Title of the album.
no 1
image
URL of the default image for the album.
yes 1
photoid
PhotoID of the image. Can be used to get different sizes of the image.
yes 1
ielink
Link to the album page on InstantEncore.com.
no 1
notes
Additional notes provided by the owner of the album.
yes 1
label
Label the album was released on.
yes 1
catalog-number
Catalog number used by the Label to identify the album.
yes 1
sponsor
Information about the sponsor of the album. See sponsor for more info.
no 0, 1
product
Sales information. See product for more info.
no 1
program-notes
Contains 0 to many program-note objects.
yes 1
buy-links
Contains 0 to many buy-link objects.
yes 1
works
Contains 0 to many work objects that describe the repertoire, performers and tracks.
yes 1
Sample
<album>
   <itemid>334518</itemid>
   <pid>5049581</pid>
   <owner>sdsymphony</owner>
   <status>online</status>
   <date-added>2009-10-01T22:34:01</date-added>
   <first-online>2009-10-01T23:44:07</first-online>
   <release-date>2009-08-24T00:00:00</release-date>
   <title>NEVER FAR AWAY - MUSIC OF BRIGHT SHENG CD</title>
   <image>https://s3.amazonaws.com/photos.instantencore.com/55361/55361_150s.jpg</image>
   <photoid>55361</photoid>
   <ielink>http://instantencore.com/music/details.aspx?PId=5049581</ielink>
   <notes />
   <label />
   <catalog-number />
   <sponsor>
      <name>Concord Music Group, Inc.</name>
      <link>http://www.concordmusicgroup.com </link>
      <image>https://s3.amazonaws.com/photos.instantencore.com/104548/104548_300.jpg</image>
   </sponsor>
   <product>
      <productid>5025545</productid>
      <price>8.99</price>
      <available>n</available>
   </product>
   <program-notes />
   <buy-links>
      <buy-link>
         <buy-link-id>34</buy-link-id>
         <url>http://itunes.apple.com/WebObjects/MZStore.woa/wa/viewAlbum?id=327630455</url>
         <source>iTunes</source>
      </buy-link>
   </buy-links>
   <back-stage-passes />
   <works>
      <work>
         <itemid>334524</itemid>
         <workid>5027450</workid>
         <title>Shanghai Overture</title>
         <composite-title>Sheng: Shanghai Overture</composite-title>
         <complete>y</complete>
         <encore>n</encore>
         <recording-date>2009-01-13T00:00:00</recording-date>
         <product>
            <productid>5025551</productid>
            <price>0.99</price>
            <available>n</available>
         </product>
         <presenters />
         <composers>
            <contributor>
               <cid>5016961</cid>
               <first-last>Bright Sheng</first-last>
               <last-first>Sheng, Bright</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/2331/2331_150s.jpg</image>
               <photoid>2331</photoid>
            </contributor>
         </composers>
         <arrangers />
         <artists />
         <conductors>
            <contributor>
               <cid>5086885</cid>
               <first-last>Jahja Ling</first-last>
               <last-first>Ling, Jahja</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/125457/125457_150s.jpg</image>
               <photoid>125457</photoid>
            </contributor>
         </conductors>
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <tracks>
            <track>
               <itemid>334525</itemid>
               <title>Shanghai Overture</title>
               <act />
               <movement />
               <length>8:45</length>
               <streaming>sample</streaming>
               <product>
                  <productid>5025550</productid>
                  <price>0.99</price>
                  <available>n</available>
               </product>
            </track>
         </tracks>
      </work>
      <work>
         <itemid>334528</itemid>
         <workid>5042361</workid>
         <title>Never Far Away for Harp and Orchestra</title>
         <composite-title>Sheng: Never Far Away for Harp and Orchestra</composite-title>
         <complete>y</complete>
         <encore>n</encore>
         <recording-date>2009-01-13T00:00:00</recording-date>
         <product>
            <productid>5025557</productid>
            <price>2.69</price>
            <available>n</available>
         </product>
         <presenters />
         <composers>
            <contributor>
               <cid>5016961</cid>
               <first-last>Bright Sheng</first-last>
               <last-first>Sheng, Bright</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/2331/2331_150s.jpg</image>
               <photoid>2331</photoid>
            </contributor>
         </composers>
         <arrangers />
         <artists>
            <contributor>
               <cid>5009962</cid>
               <first-last>Yolanda Kondonassis</first-last>
               <last-first>Kondonassis, Yolanda</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/54425/54425_150s.jpg</image>
               <photoid>54425</photoid>
               <instrument>Harp</instrument>
            </contributor>
         </artists>
         <conductors>
            <contributor>
               <cid>5086885</cid>
               <first-last>Jahja Ling</first-last>
               <last-first>Ling, Jahja</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/125457/125457_150s.jpg</image>
               <photoid>125457</photoid>
            </contributor>
         </conductors>
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <tracks>
            <track>
               <itemid>334529</itemid>
               <title>Moonlight Shadows</title>
               <act />
               <movement>1</movement>
               <length>9:15</length>
               <streaming>full</streaming>
               <product>
                  <productid>5025554</productid>
                  <price>0.99</price>
                  <available>n</available>
               </product>
            </track>
            <track>
               <itemid>334530</itemid>
               <title>The Drunken Fisher</title>
               <act />
               <movement>2</movement>
               <length>7:00</length>
               <streaming>sample</streaming>
               <product>
                  <productid>5025555</productid>
                  <price>0.99</price>
                  <available>n</available>
               </product>
            </track>
            <track>
               <itemid>334531</itemid>
               <title>Doctored Pentatonics</title>
               <act />
               <movement>3</movement>
               <length>7:38</length>
               <streaming>full</streaming>
               <product>
                  <productid>5025556</productid>
                  <price>0.99</price>
                  <available>n</available>
               </product>
            </track>
         </tracks>
      </work>
      <work>
         <itemid>334540</itemid>
         <workid>5025051</workid>
         <title>The Nightingale and the Rose</title>
         <composite-title>Sheng: The Nightingale and the Rose</composite-title>
         <complete>y</complete>
         <encore>n</encore>
         <recording-date>2009-01-13T00:00:00</recording-date>
         <product>
            <productid>5025563</productid>
            <price>0.99</price>
            <available>n</available>
         </product>
         <presenters />
         <composers>
            <contributor>
               <cid>5016961</cid>
               <first-last>Bright Sheng</first-last>
               <last-first>Sheng, Bright</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/2331/2331_150s.jpg</image>
               <photoid>2331</photoid>
            </contributor>
         </composers>
         <arrangers />
         <artists />
         <conductors>
            <contributor>
               <cid>5086885</cid>
               <first-last>Jahja Ling</first-last>
               <last-first>Ling, Jahja</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/125457/125457_150s.jpg</image>
               <photoid>125457</photoid>
            </contributor>
         </conductors>
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <tracks>
            <track>
               <itemid>334541</itemid>
               <title>The Nightingale and the Rose</title>
               <act />
               <movement />
               <length>21:56</length>
               <streaming>sample</streaming>
               <product>
                  <productid>5025562</productid>
                  <price>0.99</price>
                  <available>n</available>
               </product>
            </track>
         </tracks>
      </work>
      <work>
         <itemid>334548</itemid>
         <workid>5023350</workid>
         <title>Tibetan Love Song and Swing</title>
         <composite-title>Sheng: Tibetan Love Song and Swing</composite-title>
         <complete>y</complete>
         <encore>n</encore>
         <recording-date>2009-01-13T00:00:00</recording-date>
         <product>
            <productid>5025566</productid>
            <price>1.79</price>
            <available>n</available>
         </product>
         <presenters />
         <composers>
            <contributor>
               <cid>5016961</cid>
               <first-last>Bright Sheng</first-last>
               <last-first>Sheng, Bright</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/2331/2331_150s.jpg</image>
               <photoid>2331</photoid>
            </contributor>
         </composers>
         <arrangers />
         <artists />
         <conductors>
            <contributor>
               <cid>5086885</cid>
               <first-last>Jahja Ling</first-last>
               <last-first>Ling, Jahja</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/125457/125457_150s.jpg</image>
               <photoid>125457</photoid>
            </contributor>
         </conductors>
         <ensembles>
            <contributor>
               <cid>5100783</cid>
               <first-last>San Diego Symphony</first-last>
               <last-first>San Diego Symphony</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/261372/261372_150s.jpg</image>
               <photoid>261372</photoid>
            </contributor>
         </ensembles>
         <orchestra-chorus />
         <misc-contributors />
         <tracks>
            <track>
               <itemid>334549</itemid>
               <title>Tibetan Love Song</title>
               <act />
               <movement>1</movement>
               <length>4:49</length>
               <streaming>full</streaming>
               <product>
                  <productid>5025564</productid>
                  <price>0.99</price>
                  <available>n</available>
               </product>
            </track>
            <track>
               <itemid>334550</itemid>
               <title>Tibetan Swing</title>
               <act />
               <movement>2</movement>
               <length>8:33</length>
               <streaming>full</streaming>
               <product>
                  <productid>5025565</productid>
                  <price>0.99</price>
                  <available>n</available>
               </product>
            </track>
         </tracks>
      </work>
      <work>
         <itemid>334660</itemid>
         <workid>5043666</workid>
         <title>Small River Flowing</title>
         <composite-title>Traditional: Small River Flowing</composite-title>
         <complete>y</complete>
         <encore>n</encore>
         <recording-date>2009-01-01T00:00:00</recording-date>
         <product>
            <productid>5025582</productid>
            <price>0.99</price>
            <available>n</available>
         </product>
         <presenters />
         <composers>
            <contributor>
               <cid>5018595</cid>
               <first-last>Traditional</first-last>
               <last-first>Traditional</last-first>
               <image />
               <photoid>0</photoid>
            </contributor>
         </composers>
         <arrangers>
            <contributor>
               <cid>5009962</cid>
               <first-last>Yolanda Kondonassis</first-last>
               <last-first>Kondonassis, Yolanda</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/54425/54425_150s.jpg</image>
               <photoid>54425</photoid>
            </contributor>
         </arrangers>
         <artists>
            <contributor>
               <cid>5009962</cid>
               <first-last>Yolanda Kondonassis</first-last>
               <last-first>Kondonassis, Yolanda</last-first>
               <image>https://s3.amazonaws.com/photos.instantencore.com/54425/54425_150s.jpg</image>
               <photoid>54425</photoid>
               <instrument>Harp</instrument>
            </contributor>
         </artists>
         <conductors />
         <ensembles />
         <orchestra-chorus />
         <misc-contributors />
         <tracks>
            <track>
               <itemid>334661</itemid>
               <title>Bonus Track: Small River Flowing</title>
               <act />
               <movement />
               <length>2:22</length>
               <streaming>sample</streaming>
               <product>
                  <productid>5025581</productid>
                  <price>0.99</price>
                  <available>n</available>
               </product>
            </track>
         </tracks>
      </work>
   </works>
</album>