Music
Events
Videos
Log In
Sign Up
API 2.0
Version 1.0
Resources
API Documentation
Using the API
Playing Music
Methods
Albums.AudioFile
Albums.Details
Albums.List
Buzz.Details
Buzz.List
Events.Details
Events.List
Photos.Details
Photos.List
Videos.Details
Videos.List
Common Return Objects
album
buy-link
buzz
contributor
event
perfdate
photo
product
program-note
sponsor
tags
track
venue
video
work
work
Contains information about a composition that was performed. If the
work
element is a child of an
album
or
event
element then the work will also contain information about who performed the work.
Child Elements
Element
Description
Empty Allowed
?
Cardinality
?
itemid
The itemid of the object.
no
1
workid
ID of the work (composition) that is being performed. All performances of the same composition will have the same workid.
no
1
title
The title of the work.
no
1
composite-title
Concatenation of the last name of the composer and the title of the work. If the composer is unknown then it is just the title of the work.
no
1
complete
Allowed values are:
y
-
Work was part of an encore.
n
-
Work was not part of an encore.
empty
-
Unknown.
yes
1
encore
Allowed values are:
y
-
Work was part of an encore.
n
-
Work was not part of an encore.
empty
-
Unknown.
yes
1
recording-date
The
DateTime
the work was recorded.
yes
1
product
Sales information. Only applies if the parent is an album. See
product
for more info.
no
0, 1
presenters
Contains 0 to many
contributor
objects that identify the presenters of the work. Only included if the parent element is an album or event.
yes
0, 1
composers
Contains 0 to many
contributor
objects that identify the composers of the work. Only included if the parent element is an album or event.
yes
0, 1
arrangers
Contains 0 to many
contributor
objects that identify the arrangers of the work. Only included if the parent element is an album or event.
yes
0, 1
artists
Contains 0 to many
contributor
objects that identify the artists that perform. Only included if the parent element is an album or event.
yes
0, 1
conductors
Contains 0 to many
contributor
objects that identify the conductors that perform. Only included if the parent element is an album or event.
yes
0, 1
ensembles
Contains 0 to many
contributor
objects that identify the ensembles that perform. Only included if the parent element is an album or event.
yes
0, 1
orchestra-chorus
Contains 0 to many
contributor
objects that identify the orchestra and chorus members that perform. Only included if the parent element is an album or event. For future use.
yes
0, 1
misc-contributors
Contains 0 to many
contributor
objects that identify miscellaneous contributors. Only included if the parent element is an album or event.
yes
0, 1
tracks
Contains 0 to many
track
objects with information about the tracks (i.e. movements) of the work.
yes
1
Sample
XML
JSON
<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>