Difference between revisions of "MusicBrainz API/Examples"

From MusicBrainz Wiki
m (Genres, tags and ratings)
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
The main web service is the [[Development/XML Web Service/Version_2|XML Web Service]]. This page is about the (beta) '''JSON''' format of that web service. For shared documentation, like the available inc= parameters, do follow the [[Development/XML Web Service/Version_2|info at the XML web service docs]]. To get a JSON response from the web service, you can either set the Accept header to "application/json" or add fmt=json to the query string (if both are set, fmt= takes precedence).
+
Below you'll find examples of API requests, to get an idea of the data you'll get back and its formatting (both on XML and JSON). Some of the responses below have some fields omitted to keep the examples shorter (additional aliases, part of the release data); in the actual response the data will obviously be included.
 
 
==Beta==
 
 
 
WARNING: This web service is available on the production server (musicbrainz.org/ws/2/) and mostly stable, but is still considered a beta, and while we do our best to avoid breaking changes, we may eventually need to make some before officially marking it as stable. If you find any issues, don't hesitate to [https://tickets.metabrainz.org/secure/Dashboard.jspa open a ticket] or contact us on IRC.
 
  
 
==Lookup requests==
 
==Lookup requests==
Below you'll find one example of a request for each entity type, to get an idea of the data you'll get back and its formatting. Some of the responses below have some fields omitted to keep the examples shorter (additional aliases, part of the release data); in the actual response the data will obviously be included.
+
===Area===
  
===Area===
+
Request: https://musicbrainz.org/ws/2/area/45f07934-675a-46d6-a577-6f8637a411b1?inc=aliases
  
Request: https://musicbrainz.org/ws/2/area/45f07934-675a-46d6-a577-6f8637a411b1?inc=aliases&fmt=json
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <area id="45f07934-675a-46d6-a577-6f8637a411b1" type="City" type-id="6fd8f29a-3d0a-32fc-980d-ea697b69da78">
 +
    <name>P&#xE4;rnu</name>
 +
    <sort-name>P&#xE4;rnu</sort-name>
 +
    <alias-list count="2">
 +
      <alias locale="en" sort-name="P&#xE4;rnu" type="Area name" type-id="0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29" primary="primary">P&#xE4;rnu</alias>
 +
      <alias locale="et" sort-name="P&#xE4;rnu" type="Area name" type-id="0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29" primary="primary">P&#xE4;rnu</alias>
 +
    </alias-list>
 +
  </area>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 57: Line 68:
 
===Artist===
 
===Artist===
  
Request: http://musicbrainz.org/ws/2/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da?inc=aliases&fmt=json
+
Request: http://musicbrainz.org/ws/2/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da?inc=aliases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <artist id="5b11f4ce-a62d-471e-81fc-a69a8278c7da" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
    <name>Nirvana</name>
 +
    <sort-name>Nirvana</sort-name>
 +
    <disambiguation>90s US grunge band</disambiguation>
 +
    <isni-list>
 +
      <isni>0000000123486830</isni>
 +
      <isni>0000000123487390</isni>
 +
    </isni-list>
 +
    <country>US</country>
 +
    <area id="489ce91b-6658-3307-9877-795b68554c98">
 +
      <name>United States</name>
 +
      <sort-name>United States</sort-name>
 +
      <iso-3166-1-code-list>
 +
        <iso-3166-1-code>US</iso-3166-1-code>
 +
      </iso-3166-1-code-list>
 +
    </area>
 +
    <begin-area id="a640b45c-c173-49b1-8030-973603e895b5">
 +
      <name>Aberdeen</name>
 +
      <sort-name>Aberdeen</sort-name>
 +
    </begin-area>
 +
    <life-span>
 +
      <begin>1988-01</begin>
 +
      <end>1994-04-05</end>
 +
      <ended>true</ended>
 +
    </life-span>
 +
    <alias-list count="2">
 +
      <alias sort-name="Nirvana US">Nirvana US</alias>
 +
      <alias locale="ja" sort-name="ニルヴァーナ" type="Artist name" type-id="894afba6-2816-3c24-8072-eadb66bd04bc" primary="primary">ニルヴァーナ</alias>
 +
    </alias-list>
 +
  </artist>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 92: Line 142:
 
     },
 
     },
 
     isnis: ["0000000123486830", "0000000123487390"],
 
     isnis: ["0000000123486830", "0000000123487390"],
     ipis: [ ]
+
     ipis: [ ],
 +
    aliases: [
 +
      {
 +
        end: null,
 +
        begin: null,
 +
        sort-name: "Nirvana US",
 +
        name: "Nirvana US",
 +
        type-id: null,
 +
        primary: null,
 +
        locale: null,
 +
        type: null,
 +
        ended: false
 +
      },
 +
      {
 +
        primary: true,
 +
        type-id: "894afba6-2816-3c24-8072-eadb66bd04bc",
 +
        name: "ニルヴァーナ",
 +
        sort-name: "ニルヴァーナ",
 +
        begin: null,
 +
        end: null,
 +
        ended: false,
 +
        type: "Artist name",
 +
        locale: "ja"
 +
      }
 +
    ]
 
   }
 
   }
 
</pre>
 
</pre>
Line 102: Line 176:
 
For events, you'll generally want to include at least artist-rels (for performers) and place-rels (for location), as in the example below.
 
For events, you'll generally want to include at least artist-rels (for performers) and place-rels (for location), as in the example below.
  
Request: https://musicbrainz.org/ws/2/event/fe39727a-3d21-4066-9345-3970cbd6cca4?inc=aliases+artist-rels+place-rels&fmt=json
+
Request: https://musicbrainz.org/ws/2/event/fe39727a-3d21-4066-9345-3970cbd6cca4?inc=aliases+artist-rels+place-rels
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <event id="fe39727a-3d21-4066-9345-3970cbd6cca4" type="Concert" type-id="ef55e8d7-3d00-394a-8012-f5506a29ff0b">
 +
    <name>Nine Inch Nails at Arena Riga</name>
 +
    <life-span>
 +
      <begin>2014-05-06</begin>
 +
      <end>2014-05-06</end>
 +
    </life-span>
 +
    <time>19:00</time>
 +
    <setlist>* Copy of A * 1,000,000 * Terrible Lie * March of the Pigs * Piggy * The Frail * The Wretched * The Becoming * Gave Up * Closer * Find My Way * Me, I'm Not * Came Back Haunted * The Great Destroyer * Eraser * Wish * Burn * The Hand That Feeds * Head Like a Hole # Encore * Hurt</setlist>
 +
    <relation-list target-type="artist">
 +
      <relation type="main performer" type-id="936c7c95-3156-3889-a062-8a0cd57f8946">
 +
        <target>b7ffd2af-418f-4be2-bdd1-22f8b48613da</target>
 +
        <direction>backward</direction>
 +
        <artist id="b7ffd2af-418f-4be2-bdd1-22f8b48613da" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
          <name>Nine Inch Nails</name>
 +
          <sort-name>Nine Inch Nails</sort-name>
 +
        </artist>
 +
      </relation>
 +
      <relation type="support act" type-id="492a850e-97eb-306a-a85e-4b6d98527796">
 +
        <target>f7f32d93-0801-45cb-9f5a-e68f640649f4</target>
 +
        <direction>backward</direction>
 +
        <artist id="f7f32d93-0801-45cb-9f5a-e68f640649f4" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
          <name>Cold Cave</name>
 +
          <sort-name>Cold Cave</sort-name>
 +
        </artist>
 +
      </relation>
 +
    </relation-list>
 +
    <relation-list target-type="place">
 +
      <relation type="held at" type-id="e2c6f697-07dc-38b1-be0b-83d740165532">
 +
        <target>478558f9-a951-4067-ad91-e83f6ba63e74</target>
 +
        <direction>forward</direction>
 +
        <place id="478558f9-a951-4067-ad91-e83f6ba63e74" type="Indoor arena" type-id="a77c11f6-82fa-3cc0-9041-ac60e5f6e024">
 +
          <name>Arēna Rīga</name>
 +
          <address>Skanstes iela 21, Rīga, Latvia</address>
 +
          <coordinates>
 +
            <latitude>56.967989</latitude>
 +
            <longitude>24.121403</longitude>
 +
          </coordinates>
 +
        </place>
 +
      </relation>
 +
    </relation-list>
 +
  </event>
 +
</metadata>
 +
 
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 204: Line 329:
 
===Genre===
 
===Genre===
  
Request: http://musicbrainz.org/ws/2/genre/f66d7266-eb3d-4ef3-b4d8-b7cd992f918b?fmt=json
+
Request: http://musicbrainz.org/ws/2/genre/f66d7266-eb3d-4ef3-b4d8-b7cd992f918b
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <genre id="f66d7266-eb3d-4ef3-b4d8-b7cd992f918b">
 +
    <name>crust punk</name>
 +
  </genre>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 220: Line 357:
 
===Instrument===
 
===Instrument===
  
Request: https://musicbrainz.org/ws/2/instrument/dd430e7f-36ba-49a5-825b-80a525e69190?inc=aliases&fmt=json
+
Request: https://musicbrainz.org/ws/2/instrument/dd430e7f-36ba-49a5-825b-80a525e69190?inc=aliases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <instrument id="dd430e7f-36ba-49a5-825b-80a525e69190" type="Percussion instrument" type-id="68fa2525-4c23-3386-bb81-e84994342e9a">
 +
    <name>kemanak</name>
 +
    <disambiguation>Banana shaped bronze slit-drum used in javanese gamelan</disambiguation>
 +
    <description>Bent into a ladle or banana like shape, it is a pair of bronze slit-drums hit with tabuh beaters.</description>
 +
    <alias-list count="12">
 +
      <alias locale="de" sort-name="Kemanak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd" primary="primary">Kemanak</alias>
 +
      <alias sort-name="gumanak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd">gumanak</alias>
 +
      <alias sort-name="kenawak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd">kenawak</alias>
 +
    </alias-list>
 +
  </instrument>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 263: Line 419:
 
===Label===
 
===Label===
  
Request: http://musicbrainz.org/ws/2/label/46f0f4cd-8aab-4b33-b698-f459faf64190?inc=aliases&fmt=json
+
Request: http://musicbrainz.org/ws/2/label/46f0f4cd-8aab-4b33-b698-f459faf64190?inc=aliases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <label id="46f0f4cd-8aab-4b33-b698-f459faf64190" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
 +
    <name>Warp</name>
 +
    <sort-name>Warp</sort-name>
 +
    <disambiguation>UK independent label</disambiguation>
 +
    <label-code>2070</label-code>
 +
    <isni-list>
 +
      <isni>0000000107280584</isni>
 +
    </isni-list>
 +
    <country>GB</country>
 +
    <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
 +
      <name>United Kingdom</name>
 +
      <sort-name>United Kingdom</sort-name>
 +
      <iso-3166-1-code-list>
 +
        <iso-3166-1-code>GB</iso-3166-1-code>
 +
      </iso-3166-1-code-list>
 +
    </area>
 +
    <life-span>
 +
      <begin>1989</begin>
 +
    </life-span>
 +
    <alias-list count="1">
 +
      <alias locale="en_GB" sort-name="Warp Records" type="Label name" type-id="3a1a0c48-d885-3b89-87b2-9e8a483c5675">Warp Records</alias>
 +
    </alias-list>
 +
  </label>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 310: Line 498:
 
===Place===
 
===Place===
  
Request: https://musicbrainz.org/ws/2/place/478558f9-a951-4067-ad91-e83f6ba63e74?inc=aliases&fmt=json
+
Request: https://musicbrainz.org/ws/2/place/478558f9-a951-4067-ad91-e83f6ba63e74?inc=aliases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <place id="478558f9-a951-4067-ad91-e83f6ba63e74" type="Indoor arena" type-id="a77c11f6-82fa-3cc0-9041-ac60e5f6e024">
 +
    <name>Arēna Rīga</name>
 +
    <address>Skanstes iela 21, Rīga, Latvia</address>
 +
    <coordinates>
 +
      <latitude>56.967989</latitude>
 +
      <longitude>24.121403</longitude>
 +
    </coordinates>
 +
    <area id="9c612199-d66f-4109-aedc-67ab26e0a43b">
 +
      <name>Rīga</name>
 +
      <sort-name>Rīga</sort-name>
 +
      <iso-3166-2-code-list>
 +
        <iso-3166-2-code>LV-RIX</iso-3166-2-code>
 +
      </iso-3166-2-code-list>
 +
    </area>
 +
    <life-span>
 +
      <begin>2006-02-15</begin>
 +
    </life-span>
 +
    <alias-list count="2">
 +
      <alias locale="en" sort-name="Arena Riga" type="Place name" type-id="fb68f9a2-622c-319b-83b0-bbff4127cdc5" primary="primary">Arena Riga</alias>
 +
      <alias locale="lv" sort-name="Arēna Rīga" type="Place name" type-id="fb68f9a2-622c-319b-83b0-bbff4127cdc5" primary="primary">Arēna Rīga</alias>
 +
    </alias-list>
 +
  </place>
 +
</metadata>
 +
 
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 358: Line 578:
 
===Recording===
 
===Recording===
  
Request: https://musicbrainz.org/ws/2/recording/b9ad642e-b012-41c7-b72a-42cf4911f9ff?inc=artist-credits+isrcs+releases&fmt=json
+
Request: https://musicbrainz.org/ws/2/recording/b9ad642e-b012-41c7-b72a-42cf4911f9ff?inc=artist-credits+isrcs+releases
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <recording id="b9ad642e-b012-41c7-b72a-42cf4911f9ff">
 +
    <title>LAST ANGEL</title>
 +
    <length>230000</length>
 +
    <artist-credit>
 +
      <name-credit joinphrase=" feat. ">
 +
        <artist id="455641ea-fff4-49f6-8fb4-49f961d8f1ac" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
          <name>倖田來未</name>
 +
          <sort-name>Koda, Kumi</sort-name>
 +
        </artist>
 +
      </name-credit>
 +
      <name-credit>
 +
        <artist id="05cbaf37-6dc2-4f71-a0ce-d633447d90c3" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
          <name>東方神起</name>
 +
          <sort-name>Tohoshinki</sort-name>
 +
        </artist>
 +
      </name-credit>
 +
    </artist-credit>
 +
    <release-list count="13">
 +
      <release id="c33dee6a-e053-4272-84ad-dfeef3f48c8a">
 +
        <title>LAST ANGEL</title>
 +
        /* some properties omitted to keep this example shorter, see the release results for the full format */
 +
      </release>
 +
      <release id="601a4558-e416-410b-a64c-857fc133b75c">
 +
        <title>Kingdom</title>
 +
        /* some properties omitted to keep this example shorter, see the release results for the full format */
 +
      </release>
 +
    </release-list>
 +
    <isrc-list count="1">
 +
      <isrc id="JPB600760301"/>
 +
    </isrc-list>
 +
  </recording>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 411: Line 671:
 
===Release===
 
===Release===
  
Request: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=artist-credits+labels+discids+recordings&fmt=json
+
Request: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=artist-credits+labels+discids+recordings
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
    <release id="59211ea4-ffd2-4ad9-9a4e-941d3148024a">
 +
        <title>æ³o & h³æ</title>
 +
        <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
 +
        <quality>normal</quality>
 +
        <text-representation>
 +
            <language>eng</language>
 +
            <script>Latn</script>
 +
        </text-representation>
 +
        <artist-credit>
 +
            <name-credit joinphrase=" & ">
 +
                <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
                    <name>Autechre</name>
 +
                    <sort-name>Autechre</sort-name>
 +
                    <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
 +
                </artist>
 +
            </name-credit>
 +
            <name-credit>
 +
                <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
                    <name>The Hafler Trio</name>
 +
                    <sort-name>Hafler Trio, The</sort-name>
 +
                </artist>
 +
            </name-credit>
 +
        </artist-credit>
 +
        <date>2003-12-04</date>
 +
        <country>GB</country>
 +
        <release-event-list count="1">
 +
            <release-event>
 +
                <date>2003-12-04</date>
 +
                <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
 +
                    <name>United Kingdom</name>
 +
                    <sort-name>United Kingdom</sort-name>
 +
                    <iso-3166-1-code-list>
 +
                        <iso-3166-1-code>GB</iso-3166-1-code>
 +
                    </iso-3166-1-code-list>
 +
                </area>
 +
            </release-event>
 +
        </release-event-list>
 +
        <cover-art-archive>
 +
            <artwork>true</artwork>
 +
            <count>1</count>
 +
            <front>true</front>
 +
            <back>false</back>
 +
        </cover-art-archive>
 +
        <label-info-list count="1">
 +
            <label-info>
 +
                <catalog-number>pgram002</catalog-number>
 +
                <label id="a0759efa-f583-49ea-9a8d-d5bbce55541c" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
 +
                    <name>Phonometrography</name>
 +
                    <sort-name>Phonometrography</sort-name>
 +
                </label>
 +
            </label-info>
 +
        </label-info-list>
 +
        <medium-list count="2">
 +
            <medium>
 +
                <title>æ³o</title>
 +
                <position>1</position>
 +
                <format id="9712d52a-4509-3d4b-a1a2-67c88c643e31">CD</format>
 +
                <disc-list count="1">
 +
                    <disc id="nN2g3a0ZSjovyIgK3bJl6_.j8C4-">
 +
                        <sectors>73241</sectors>
 +
                        <offset-list count="1">
 +
                            <offset position="1">150</offset>
 +
                        </offset-list>
 +
                    </disc>
 +
                </disc-list>
 +
                <track-list count="1" offset="0">
 +
                    <track id="61af3e5a-14e0-350d-9826-a884c6e586b1">
 +
                        <position>1</position>
 +
                        <number>1</number>
 +
                        <length>974546</length>
 +
                        <recording id="af87f070-238b-46c1-aa3e-f831ab91fa20">
 +
                            <title>æ³o</title>
 +
                            <length>974546</length>
 +
                            <artist-credit>
 +
                                <name-credit joinphrase=" & ">
 +
                                    <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
                                        <name>Autechre</name>
 +
                                        <sort-name>Autechre</sort-name>
 +
                                        <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
 +
                                    </artist>
 +
                                </name-credit>
 +
                                <name-credit>
 +
                                    <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
                                        <name>The Hafler Trio</name>
 +
                                        <sort-name>Hafler Trio, The</sort-name>
 +
                                    </artist>
 +
                                </name-credit>
 +
                            </artist-credit>
 +
                        </recording>
 +
                    </track>
 +
                </track-list>
 +
            </medium>
 +
            <medium>
 +
                <title>h³æ</title>
 +
                <position>2</position>
 +
                <format id="9712d52a-4509-3d4b-a1a2-67c88c643e31">CD</format>
 +
                <disc-list count="1">
 +
                    <disc id="aSHvkMnq2jZVFEK.DmSPbvN_f54-">
 +
                        <sectors>69341</sectors>
 +
                        <offset-list count="1">
 +
                            <offset position="1">150</offset>
 +
                        </offset-list>
 +
                    </disc>
 +
                </disc-list>
 +
                <track-list count="1" offset="0">
 +
                    <track id="5f2031a2-c67d-3bec-8ae5-8d22847ab0a5">
 +
                        <position>1</position>
 +
                        <number>1</number>
 +
                        <length>922546</length>
 +
                        <recording id="5aff6309-2e02-4a47-9233-32d7dcc9a960">
 +
                            <title>h³æ</title>
 +
                            <length>922546</length>
 +
                            <artist-credit>
 +
                                <name-credit joinphrase=" & ">
 +
                                    <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
                                        <name>Autechre</name>
 +
                                        <sort-name>Autechre</sort-name>
 +
                                        <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
 +
                                    </artist>
 +
                                </name-credit>
 +
                                <name-credit>
 +
                                    <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
 +
                                        <name>The Hafler Trio</name>
 +
                                        <sort-name>Hafler Trio, The</sort-name>
 +
                                    </artist>
 +
                                </name-credit>
 +
                            </artist-credit>
 +
                        </recording>
 +
                    </track>
 +
                </track-list>
 +
            </medium>
 +
        </medium-list>
 +
    </release>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 646: Line 1,048:
 
===Release Group===
 
===Release Group===
  
Request: http://musicbrainz.org/ws/2/release-group/c9fdb94c-4975-4ed6-a96f-ef6d80bb7738?inc=artist-credits+releases&fmt=json
+
Request: http://musicbrainz.org/ws/2/release-group/c9fdb94c-4975-4ed6-a96f-ef6d80bb7738?inc=artist-credits+releases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <release-group id="c9fdb94c-4975-4ed6-a96f-ef6d80bb7738" type="Album" type-id="f529b476-6e62-324f-b0aa-1f3e33d313fc">
 +
    <title>The Lost Tape</title>
 +
    <first-release-date>2012-05-22</first-release-date>
 +
    <primary-type id="f529b476-6e62-324f-b0aa-1f3e33d313fc">Album</primary-type>
 +
    <secondary-type-list>
 +
      <secondary-type id="15c1b1f5-d893-3375-a1db-e180c5ae15ed">Mixtape/Street</secondary-type>
 +
    </secondary-type-list>
 +
    <artist-credit>
 +
      <name-credit>
 +
        <artist id="8e68819d-71be-4e7d-b41d-f1df81b01d3f" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
          <name>50 Cent</name>
 +
          <sort-name>50 Cent</sort-name>
 +
        </artist>
 +
      </name-credit>
 +
    </artist-credit>
 +
    <release-list count="1">
 +
      <release id="2ec84eb6-ab92-4ac3-9720-32ad84c34f11">
 +
        <title>The Lost Tape</title>
 +
        /* some properties omitted to keep this example shorter, see the release results for the full format */
 +
      </release>
 +
    </release-list>
 +
  </release-group>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
  {
 
  {
Line 685: Line 1,118:
 
===URL===
 
===URL===
  
Request: https://musicbrainz.org/ws/2/url/46d8f693-52e4-4d03-936f-7ca8459019a7?fmt=json
+
Request: https://musicbrainz.org/ws/2/url/46d8f693-52e4-4d03-936f-7ca8459019a7
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <url id="46d8f693-52e4-4d03-936f-7ca8459019a7">
 +
    <resource>https://www.arvopart.ee/</resource>
 +
  </url>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 702: Line 1,147:
 
For works, you'll generally want to include at least artist-rels (for writers), as in the example below.
 
For works, you'll generally want to include at least artist-rels (for writers), as in the example below.
  
Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?inc=artist-rels&fmt=json
+
Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?inc=artist-rels
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <work id="b1df2cf3-69a9-3bc0-be44-f71e79b27a22" type="Song" type-id="f061270a-2fd6-32f1-a641-f0f8676d14e6">
 +
    <title>HELLO! また会おうね</title>
 +
    <language>jpn</language>
 +
    <language-list>
 +
      <language>jpn</language>
 +
    </language-list>
 +
    <iswc>T-101.690.320-9</iswc>
 +
    <iswc-list>
 +
      <iswc>T-101.690.320-9</iswc>
 +
    </iswc-list>
 +
    <attribute-list>
 +
      <attribute type="JASRAC ID" type-id="31048fcc-3dbb-3979-8f85-805afb933e0c">089-5005-9</attribute>
 +
    </attribute-list>
 +
    <relation-list target-type="artist">
 +
      <relation type="composer" type-id="d59d99ea-23d4-4a80-b066-edca32ee158f">
 +
        <target>d997d399-355e-4c49-9c7b-75a93d76bc0e</target>
 +
        <direction>backward</direction>
 +
        <artist id="d997d399-355e-4c49-9c7b-75a93d76bc0e" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
          <name>つんく♂</name>
 +
          <sort-name>Tsunku</sort-name>
 +
        </artist>
 +
      </relation>
 +
      <relation type="lyricist" type-id="3e48faba-ec01-47fd-8e89-30e81161661c">
 +
        <target>d997d399-355e-4c49-9c7b-75a93d76bc0e</target>
 +
        <direction>backward</direction>
 +
        <artist id="d997d399-355e-4c49-9c7b-75a93d76bc0e" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
          <name>つんく♂</name>
 +
          <sort-name>Tsunku</sort-name>
 +
        </artist>
 +
      </relation>
 +
    </relation-list>
 +
  </work>
 +
</metadata>
 +
 
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 768: Line 1,255:
 
</div>
 
</div>
  
==Browse Requests==
+
==Browse requests==
  
Browse requests are a direct lookup of all the entities directly linked to another entity. You can see more info about what types you can browse each entity type by if you check [[Development/XML_Web_Service/Version_2#Browse|the documentation for XML browse requests]] (most of the documentation applies as-is to the JSON version of the web service).
+
Request: http://musicbrainz.org/ws/2/release?label=47e718e1-7ee4-460c-b1cc-1192a841c6e5&offset=12&limit=2
  
Browse requests return a top-level object with offset and count properties to help with paging, and a property for the requested entity.
+
<div class="toccolours mw-collapsible mw-collapsed">
Unless you set a limit (see example below) you will get 25 results per page.
+
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 
+
<pre class="mw-collapsible-content">
The key for the entity property will be the English plural of the entity name, so: areas, artists, events, instruments, labels, places, recordings, releases, release-groups, series or works.
+
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 
+
  <release-list count="106" offset="12">
Browse requests are not currently available for genres.
+
    <release id="6283480c-5004-4da7-993c-69fd7d2f0681">
 
+
      <title>Autumntunes</title>
Request: http://musicbrainz.org/ws/2/release?label=47e718e1-7ee4-460c-b1cc-1192a841c6e5&offset=12&limit=2&fmt=json
+
      /* some properties omitted to keep this example shorter, see the release results for the full format */
 +
    </release>
 +
    <release id="26598ff2-4719-4d26-a3e5-5ccd77119455">
 +
      <title>Around Past</title>
 +
      /* some properties omitted to keep this example shorter, see the release results for the full format */
 +
    </release>
 +
  </release-list>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
 
     releases: [
 
     releases: [
 
       {
 
       {
         id: "0b405ea7-8785-402f-bcf7-d55f5000dc3e",
+
         id: "26598ff2-4719-4d26-a3e5-5ccd77119455",
         title: "Wintertunes"
+
         title: "Around Past"
 
         /* some properties omitted to keep this example shorter, see the release results for the full format */
 
         /* some properties omitted to keep this example shorter, see the release results for the full format */
 
       },
 
       },
 
       {
 
       {
         id: "7eb37a3a-646d-4501-a373-e9071186b88d",
+
         id: "6283480c-5004-4da7-993c-69fd7d2f0681",
         title: "Adventure Magic Supreme Journey Music"
+
         title: "Autumntunes"
 
         /* some properties omitted to keep this example shorter, see the release results for the full format */
 
         /* some properties omitted to keep this example shorter, see the release results for the full format */
 
       }
 
       }
Line 805: Line 1,302:
  
 
==Relationships==
 
==Relationships==
 +
You can find standard real-life examples of relationship requests above, under the lookup examples for Event and Work.
  
You can request relationships with the appropriate includes:
+
See the example below for a classical release (one-track, for simplicity) with both performers (recording level relationships) and composer (work level relationship) using <code>recording-level-rels</code> and <code>work-level-rels</code>.
  
* area-rels
+
Request: https://musicbrainz.org/ws/2/release/987f3e2d-22a6-4a4f-b840-c80c26b8b91a?inc=artist-credits+labels+recordings+recording-level-rels+work-rels+work-level-rels+artist-rels
* artist-rels
 
* event-rels
 
* instrument-rels
 
* label-rels
 
* place-rels
 
* recording-rels
 
* release-rels
 
* release-group-rels
 
* series-rels
 
* url-rels
 
* work-rels
 
  
These will load relationships between the requested entity and the specific entity type. For example, if you request "work-rels" when looking up an artist, you'll get all the relationships between this artist and any works, and if you request "artist-rels" you'll get the relationships between this artist and any other artists. As such, keep in mind requesting "artist-rels" for an artist, "release-rels" for a release, etc. '''will not''' load all the relationships for the entity, just the ones to ''other entities of the same type''.
+
<div class="toccolours mw-collapsible mw-collapsed">
 
+
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
You can find examples of relationship requests above, under Event and Work.
+
<pre class="mw-collapsible-content">
 
+
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
in a release request, you might also be interested on relationships for ''the recordings linked to the release'', or even for ''the works linked to those recordings'' (for example, to find out who played guitar on a specific track or who wrote the lyrics for the song being performed). Similarly, for a recording request, you might want to get the relationships for any linked works. There are two additional includes for this:
+
    <release id="987f3e2d-22a6-4a4f-b840-c80c26b8b91a">
 
+
        <title>Become Desert</title>
* recording-level-rels
+
        <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
* work-level-rels
+
        <quality>normal</quality>
 
+
        <packaging id="119eba76-b343-3e02-a292-f0f00644bb9b">None</packaging>
Keep in mind these just act as switches. If you request ''work-level-rels'' for a recording, you will still need to request ''work-rels'' (to get the relationship from the recording to the work in the first place) and any other relationship types you want to see (for example, ''artist-rels'' if you want to see work-artist relationships). See the example below for a one-track classical release with both performers (recording level relationships) and composer (work level relationship).
+
        <text-representation>
 
+
            <language>eng</language>
Request: https://musicbrainz.org/ws/2/release/987f3e2d-22a6-4a4f-b840-c80c26b8b91a?inc=artist-credits+labels+recordings+recording-level-rels+work-rels+work-level-rels+artist-rels&fmt=json
+
            <script>Latn</script>
 +
        </text-representation>
 +
        <artist-credit>
 +
            <name-credit joinphrase="; ">
 +
                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                    <name>John Luther Adams</name>
 +
                    <sort-name>Adams, John Luther</sort-name>
 +
                </artist>
 +
            </name-credit>
 +
            <name-credit joinphrase=", ">
 +
                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                    <name>Seattle Symphony</name>
 +
                    <sort-name>Seattle Symphony</sort-name>
 +
                </artist>
 +
            </name-credit>
 +
            <name-credit>
 +
                <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                    <name>Ludovic Morlot</name>
 +
                    <sort-name>Morlot, Ludovic</sort-name>
 +
                </artist>
 +
            </name-credit>
 +
        </artist-credit>
 +
        <date>2019-06-14</date>
 +
        <country>XW</country>
 +
        <release-event-list count="1">
 +
            <release-event>
 +
                <date>2019-06-14</date>
 +
                <area id="525d4e18-3d00-31b9-a58b-a146a916de8f">
 +
                    <name>[Worldwide]</name>
 +
                    <sort-name>[Worldwide]</sort-name>
 +
                    <iso-3166-1-code-list>
 +
                        <iso-3166-1-code>XW</iso-3166-1-code>
 +
                    </iso-3166-1-code-list>
 +
                </area>
 +
            </release-event>
 +
        </release-event-list>
 +
        <cover-art-archive>
 +
            <artwork>true</artwork>
 +
            <count>1</count>
 +
            <front>true</front>
 +
            <back>false</back>
 +
        </cover-art-archive>
 +
        <label-info-list count="1">
 +
            <label-info>
 +
                <label id="3044afdb-c895-4f60-8e69-5796b3887c21" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
 +
                    <name>Cantaloupe Music</name>
 +
                    <sort-name>Cantaloupe Music</sort-name>
 +
                </label>
 +
            </label-info>
 +
        </label-info-list>
 +
        <medium-list count="1">
 +
            <medium>
 +
                <position>1</position>
 +
                <format id="907a28d9-b3b2-3ef6-89a8-7b18d91d4794">Digital Media</format>
 +
                <track-list count="1" offset="0">
 +
                    <track id="33781879-1dae-422c-a634-b26f89705e48">
 +
                        <position>1</position>
 +
                        <number>1</number>
 +
                        <length>2422450</length>
 +
                        <artist-credit>
 +
                            <name-credit>
 +
                                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                    <name>John Luther Adams</name>
 +
                                    <sort-name>Adams, John Luther</sort-name>
 +
                                </artist>
 +
                            </name-credit>
 +
                        </artist-credit>
 +
                        <recording id="d90bc0ff-c7d9-4c09-a12b-d46f46f7281d">
 +
                            <title>Become Desert</title>
 +
                            <length>2422450</length>
 +
                            <artist-credit>
 +
                                <name-credit joinphrase=", ">
 +
                                    <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                                        <name>Seattle Symphony</name>
 +
                                        <sort-name>Seattle Symphony</sort-name>
 +
                                    </artist>
 +
                                </name-credit>
 +
                                <name-credit>
 +
                                    <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                        <name>Ludovic Morlot</name>
 +
                                        <sort-name>Morlot, Ludovic</sort-name>
 +
                                    </artist>
 +
                                </name-credit>
 +
                            </artist-credit>
 +
                            <relation-list target-type="artist">
 +
                                <relation type="conductor" type-id="234670ce-5f22-4fd0-921b-ef1662695c5d">
 +
                                    <target>eace8da8-8535-47c4-82da-902c792ec9f4</target>
 +
                                    <direction>backward</direction>
 +
                                    <begin>2018-09-25</begin>
 +
                                    <end>2018-09-26</end>
 +
                                    <ended>true</ended>
 +
                                    <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                        <name>Ludovic Morlot</name>
 +
                                        <sort-name>Morlot, Ludovic</sort-name>
 +
                                    </artist>
 +
                                </relation>
 +
                                <relation type="mix" type-id="3e3102e1-1896-4f50-b5b2-dd9824e46efe">
 +
                                    <target>ac0122d6-14e8-4335-a01f-5d6ee71d308b</target>
 +
                                    <direction>backward</direction>
 +
                                    <artist id="ac0122d6-14e8-4335-a01f-5d6ee71d308b" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                        <name>Nathaniel Reichman</name>
 +
                                        <sort-name>Reichman, Nathaniel</sort-name>
 +
                                        <disambiguation>music producer, rerecording mixer</disambiguation>
 +
                                    </artist>
 +
                                </relation>
 +
                                <relation type="performing orchestra" type-id="3b6616c5-88ba-4341-b4ee-81ce1e6d7ebb">
 +
                                    <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
 +
                                    <direction>backward</direction>
 +
                                    <begin>2018-09-25</begin>
 +
                                    <end>2018-09-26</end>
 +
                                    <ended>true</ended>
 +
                                    <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                                        <name>Seattle Symphony</name>
 +
                                        <sort-name>Seattle Symphony</sort-name>
 +
                                    </artist>
 +
                                </relation>
 +
                                <relation type="producer" type-id="5c0ceac3-feb4-41f0-868d-dc06f6e27fc0">
 +
                                    <target>748b47b2-604b-4487-b994-944918df19e9</target>
 +
                                    <direction>backward</direction>
 +
                                    <artist id="748b47b2-604b-4487-b994-944918df19e9" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                        <name>Dmitriy Lipay</name>
 +
                                        <sort-name>Lipay, Dmitriy</sort-name>
 +
                                        <disambiguation>recording engineer & producer</disambiguation>
 +
                                    </artist>
 +
                                </relation>
 +
                                <relation type="producer" type-id="5c0ceac3-feb4-41f0-868d-dc06f6e27fc0">
 +
                                    <target>ac0122d6-14e8-4335-a01f-5d6ee71d308b</target>
 +
                                    <direction>backward</direction>
 +
                                    <artist id="ac0122d6-14e8-4335-a01f-5d6ee71d308b" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                        <name>Nathaniel Reichman</name>
 +
                                        <sort-name>Reichman, Nathaniel</sort-name>
 +
                                        <disambiguation>music producer, rerecording mixer</disambiguation>
 +
                                    </artist>
 +
                                </relation>
 +
                                <relation type="recording" type-id="a01ee869-80a8-45ef-9447-c59e91aa7926">
 +
                                    <target>e2a6142d-83f5-4626-a48a-1211588d06db</target>
 +
                                    <direction>backward</direction>
 +
                                    <artist id="e2a6142d-83f5-4626-a48a-1211588d06db" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                        <name>Alexander Lipay</name>
 +
                                        <sort-name>Lipay, Alexander</sort-name>
 +
                                    </artist>
 +
                                </relation>
 +
                                <relation type="recording" type-id="a01ee869-80a8-45ef-9447-c59e91aa7926">
 +
                                    <target>748b47b2-604b-4487-b994-944918df19e9</target>
 +
                                    <direction>backward</direction>
 +
                                    <artist id="748b47b2-604b-4487-b994-944918df19e9" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                        <name>Dmitriy Lipay</name>
 +
                                        <sort-name>Lipay, Dmitriy</sort-name>
 +
                                        <disambiguation>recording engineer & producer</disambiguation>
 +
                                    </artist>
 +
                                </relation>
 +
                            </relation-list>
 +
                            <relation-list target-type="work">
 +
                                <relation type="performance" type-id="a3005666-a872-32c3-ad06-98af558e99b0">
 +
                                    <target>b6cb19ec-08d3-4563-9e82-9562e5cab030</target>
 +
                                    <direction>forward</direction>
 +
                                    <begin>2018-09-25</begin>
 +
                                    <end>2018-09-26</end>
 +
                                    <ended>true</ended>
 +
                                    <work id="b6cb19ec-08d3-4563-9e82-9562e5cab030" type="Symphony" type-id="174314aa-0aa4-30cf-96a6-50b281d8d208">
 +
                                        <title>Become Desert</title>
 +
                                        <language>zxx</language>
 +
                                        <language-list>
 +
                                            <language>zxx</language>
 +
                                        </language-list>
 +
                                        <relation-list target-type="artist">
 +
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
 +
                                                <target>7cdb68bc-c4f1-4a92-9bd2-739641c5eff0</target>
 +
                                                <direction>backward</direction>
 +
                                                <artist id="7cdb68bc-c4f1-4a92-9bd2-739641c5eff0" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                                                    <name>New York Philharmonic</name>
 +
                                                    <sort-name>New York Philharmonic</sort-name>
 +
                                                </artist>
 +
                                            </relation>
 +
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
 +
                                                <target>c5958778-9c97-4970-9e63-0072ab2c4189</target>
 +
                                                <direction>backward</direction>
 +
                                                <artist id="c5958778-9c97-4970-9e63-0072ab2c4189" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                                                    <name>Rotterdams Philharmonisch Orkest</name>
 +
                                                    <sort-name>Rotterdams Philharmonisch Orkest</sort-name>
 +
                                                </artist>
 +
                                            </relation>
 +
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
 +
                                                <target>68f7b9d5-b329-40aa-a474-5abffd6dfb44</target>
 +
                                                <direction>backward</direction>
 +
                                                <artist id="68f7b9d5-b329-40aa-a474-5abffd6dfb44" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                                                    <name>San Diego Symphony</name>
 +
                                                    <sort-name>San Diego Symphony</sort-name>
 +
                                                </artist>
 +
                                            </relation>
 +
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
 +
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
 +
                                                <direction>backward</direction>
 +
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                                                    <name>Seattle Symphony</name>
 +
                                                    <sort-name>Seattle Symphony</sort-name>
 +
                                                </artist>
 +
                                            </relation>
 +
                                            <relation type="composer" type-id="d59d99ea-23d4-4a80-b066-edca32ee158f">
 +
                                                <target>96681463-98e2-4032-9728-5fbb7b002427</target>
 +
                                                <direction>backward</direction>
 +
                                                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
                                                    <name>John Luther Adams</name>
 +
                                                    <sort-name>Adams, John Luther</sort-name>
 +
                                                </artist>
 +
                                            </relation>
 +
                                            <relation type="premiere" type-id="5cc8cfb5-cca0-4395-a44b-b7d3c1777608">
 +
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
 +
                                                <direction>backward</direction>
 +
                                                <begin>2018-03-21</begin>
 +
                                                <end>2018-03-21</end>
 +
                                                <ended>true</ended>
 +
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                                                    <name>Seattle Symphony</name>
 +
                                                    <sort-name>Seattle Symphony</sort-name>
 +
                                                </artist>
 +
                                            </relation>
 +
                                            <relation type="premiere" type-id="5cc8cfb5-cca0-4395-a44b-b7d3c1777608">
 +
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
 +
                                                <direction>backward</direction>
 +
                                                <begin>2018-03-29</begin>
 +
                                                <end>2018-03-29</end>
 +
                                                <ended>true</ended>
 +
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
 +
                                                    <name>Seattle Symphony</name>
 +
                                                    <sort-name>Seattle Symphony</sort-name>
 +
                                                </artist>
 +
                                            </relation>
 +
                                        </relation-list>
 +
                                    </work>
 +
                                </relation>
 +
                            </relation-list>
 +
                        </recording>
 +
                    </track>
 +
                </track-list>
 +
            </medium>
 +
        </medium-list>
 +
    </release>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 1,111: Line 1,839:
 
</div>
 
</div>
  
== Genres, Tags and Ratings ==
+
== Genres, tags and ratings ==
  
 
You can include ''genres'', ''tags'' and ''ratings'' to get this secondary data. Below is an example of a request including all of the three.
 
You can include ''genres'', ''tags'' and ''ratings'' to get this secondary data. Below is an example of a request including all of the three.
  
Request: http://musicbrainz.org/ws/2/artist/db92a151-1ac2-438b-bc43-b82e149ddd50?inc=aliases+genres+tags+ratings&fmt=json
+
Request: http://musicbrainz.org/ws/2/artist/db92a151-1ac2-438b-bc43-b82e149ddd50?inc=aliases+genres+tags+ratings
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <artist id="db92a151-1ac2-438b-bc43-b82e149ddd50" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
 +
    <name>Rick Astley</name>
 +
    <sort-name>Astley, Rick</sort-name>
 +
    <disambiguation>English singer, songwriter and radio personality</disambiguation>
 +
    <ipi>00159849414</ipi>
 +
    <ipi-list>
 +
      <ipi>00159849414</ipi>
 +
    </ipi-list>
 +
    <isni-list>
 +
      <isni>0000000120203276</isni>
 +
    </isni-list>
 +
    <gender id="36d3d30a-839d-3eda-8cb3-29be4384e4a9">Male</gender>
 +
    <country>GB</country>
 +
    <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
 +
      <name>United Kingdom</name>
 +
      <sort-name>United Kingdom</sort-name>
 +
      <iso-3166-1-code-list>
 +
        <iso-3166-1-code>GB</iso-3166-1-code>
 +
      </iso-3166-1-code-list>
 +
    </area>
 +
    <begin-area id="71baf484-64ec-4482-9ad2-225aa3b9a337">
 +
      <name>Newton-le-Willows</name>
 +
      <sort-name>Newton-le-Willows</sort-name>
 +
    </begin-area>
 +
    <life-span>
 +
      <begin>1966-02-06</begin>
 +
    </life-span>
 +
    <alias-list count="5">
 +
      <alias sort-name="Astley, Richard Paul" type="Legal name" type-id="d4dcd0c0-b341-3612-a332-c0ce797b25cf">Richard Paul Astley</alias>
 +
    </alias-list>
 +
    <tag-list>
 +
      <tag count="2">
 +
        <name>adult contemporary</name>
 +
      </tag>
 +
      <tag count="2">
 +
        <name>blue-eyed soul</name>
 +
      </tag>
 +
      <tag count="0">
 +
        <name>british</name>
 +
      </tag>
 +
      <tag count="0">
 +
        <name>classic pop and rock</name>
 +
      </tag>
 +
      <tag count="2">
 +
        <name>dance-pop</name>
 +
      </tag>
 +
      <tag count="0">
 +
        <name>english</name>
 +
      </tag>
 +
      <tag count="2">
 +
        <name>pop</name>
 +
      </tag>
 +
      <tag count="0">
 +
        <name>uk</name>
 +
      </tag>
 +
    </tag-list>
 +
    <genre-list>
 +
      <genre count="2" id="650bda08-20ca-4012-b873-3b68c5768bdf">
 +
        <name>blue-eyed soul</name>
 +
      </genre>
 +
      <genre count="2" id="b739a895-85ed-4ad3-8717-4e9ef5387dd8">
 +
        <name>dance-pop</name>
 +
      </genre>
 +
      <genre count="2" id="911c7bbb-172d-4df8-9478-dbff4296e791">
 +
        <name>pop</name>
 +
      </genre>
 +
    </genre-list>
 +
    <rating votes-count="2">4.5</rating>
 +
  </artist>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 1,165: Line 1,971:
 
     ],
 
     ],
 
     genres: [
 
     genres: [
       {name: "blue-eyed soul", count: 2}
+
       {
 +
        name: "blue-eyed soul",
 +
        id: "650bda08-20ca-4012-b873-3b68c5768bdf",
 +
        count: 2,
 +
        disambiguation: "",
 +
      },
 +
      {
 +
        name: "dance-pop",
 +
        id: "b739a895-85ed-4ad3-8717-4e9ef5387dd8",
 +
        count: 2,
 +
        disambiguation: "",
 +
      },
 +
      {
 +
        name: "pop",
 +
        id: "911c7bbb-172d-4df8-9478-dbff4296e791",
 +
        count: 2,
 +
        disambiguation: "",
 +
      },
 
     ],
 
     ],
 
     tags: [
 
     tags: [
 
       {name: "blue-eyed soul", count: 2},
 
       {name: "blue-eyed soul", count: 2},
       {name: "british", count: 1}
+
       {name: "british", count: 0}
 
     ],
 
     ],
 
     rating: {
 
     rating: {

Revision as of 19:07, 10 July 2020

Below you'll find examples of API requests, to get an idea of the data you'll get back and its formatting (both on XML and JSON). Some of the responses below have some fields omitted to keep the examples shorter (additional aliases, part of the release data); in the actual response the data will obviously be included.

Lookup requests

Area

Request: https://musicbrainz.org/ws/2/area/45f07934-675a-46d6-a577-6f8637a411b1?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <area id="45f07934-675a-46d6-a577-6f8637a411b1" type="City" type-id="6fd8f29a-3d0a-32fc-980d-ea697b69da78">
    <name>Pärnu</name>
    <sort-name>Pärnu</sort-name>
    <alias-list count="2">
      <alias locale="en" sort-name="Pärnu" type="Area name" type-id="0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29" primary="primary">Pärnu</alias>
      <alias locale="et" sort-name="Pärnu" type="Area name" type-id="0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29" primary="primary">Pärnu</alias>
    </alias-list>
  </area>
</metadata>
JSON Response
  {
    id: "45f07934-675a-46d6-a577-6f8637a411b1",
    name: "Pärnu",
    type-id: "6fd8f29a-3d0a-32fc-980d-ea697b69da78",
    type: "City",
    disambiguation: "",
    life-span: {
      begin: null,
      end: null,
      ended: false
    },
    aliases: [
      {
        name: "Pärnu",
        sort-name: "Pärnu",
        type-id: "0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29",
        type: "Area name",
        locale: "en",
        primary: true,
        begin: null,
        end: null,
        ended: false
      },
      {
        name: "Pärnu",
        sort-name: "Pärnu",
        type-id: "0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29",
        type: "Area name",
        locale: "et",
        primary: true,
        begin: null,
        end: null,
        ended: false
      }
    ]
  }

Artist

Request: http://musicbrainz.org/ws/2/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <artist id="5b11f4ce-a62d-471e-81fc-a69a8278c7da" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
    <name>Nirvana</name>
    <sort-name>Nirvana</sort-name>
    <disambiguation>90s US grunge band</disambiguation>
    <isni-list>
      <isni>0000000123486830</isni>
      <isni>0000000123487390</isni>
    </isni-list>
    <country>US</country>
    <area id="489ce91b-6658-3307-9877-795b68554c98">
      <name>United States</name>
      <sort-name>United States</sort-name>
      <iso-3166-1-code-list>
        <iso-3166-1-code>US</iso-3166-1-code>
      </iso-3166-1-code-list>
    </area>
    <begin-area id="a640b45c-c173-49b1-8030-973603e895b5">
      <name>Aberdeen</name>
      <sort-name>Aberdeen</sort-name>
    </begin-area>
    <life-span>
      <begin>1988-01</begin>
      <end>1994-04-05</end>
      <ended>true</ended>
    </life-span>
    <alias-list count="2">
      <alias sort-name="Nirvana US">Nirvana US</alias>
      <alias locale="ja" sort-name="ニルヴァーナ" type="Artist name" type-id="894afba6-2816-3c24-8072-eadb66bd04bc" primary="primary">ニルヴァーナ</alias>
    </alias-list>
  </artist>
</metadata>
JSON Response
  {
    id: "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
    name: "Nirvana",
    sort-name: "Nirvana",
    type-id: "e431f5f6-b5d2-343d-8b36-72607fffb74b",
    type: "Group",
    disambiguation: "90s US grunge band",
    gender: null,
    gender-id: null,
    country: "US",
    area: {
      disambiguation: "",
      id: "489ce91b-6658-3307-9877-795b68554c98",
      sort-name: "United States",
      name: "United States",
      iso-3166-1-codes: ["US"]
    },
    begin-area: {
      id: "a640b45c-c173-49b1-8030-973603e895b5",
      disambiguation: "",
      name: "Aberdeen",
      sort-name: "Aberdeen"
    },
    end-area: null,
    life-span: {
      ended: true,
      begin: "1988-01",
      end: "1994-04-05"
    },
    isnis: ["0000000123486830", "0000000123487390"],
    ipis: [ ],
    aliases: [
      {
        end: null,
        begin: null,
        sort-name: "Nirvana US",
        name: "Nirvana US",
        type-id: null,
        primary: null,
        locale: null,
        type: null,
        ended: false
      },
      {
        primary: true,
        type-id: "894afba6-2816-3c24-8072-eadb66bd04bc",
        name: "ニルヴァーナ",
        sort-name: "ニルヴァーナ",
        begin: null,
        end: null,
        ended: false,
        type: "Artist name",
        locale: "ja"
      }
    ]
  }

Event

For events, you'll generally want to include at least artist-rels (for performers) and place-rels (for location), as in the example below.

Request: https://musicbrainz.org/ws/2/event/fe39727a-3d21-4066-9345-3970cbd6cca4?inc=aliases+artist-rels+place-rels

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <event id="fe39727a-3d21-4066-9345-3970cbd6cca4" type="Concert" type-id="ef55e8d7-3d00-394a-8012-f5506a29ff0b">
    <name>Nine Inch Nails at Arena Riga</name>
    <life-span>
      <begin>2014-05-06</begin>
      <end>2014-05-06</end>
    </life-span>
    <time>19:00</time>
    <setlist>* Copy of A * 1,000,000 * Terrible Lie * March of the Pigs * Piggy * The Frail * The Wretched * The Becoming * Gave Up * Closer * Find My Way * Me, I'm Not * Came Back Haunted * The Great Destroyer * Eraser * Wish * Burn * The Hand That Feeds * Head Like a Hole # Encore * Hurt</setlist>
    <relation-list target-type="artist">
      <relation type="main performer" type-id="936c7c95-3156-3889-a062-8a0cd57f8946">
        <target>b7ffd2af-418f-4be2-bdd1-22f8b48613da</target>
        <direction>backward</direction>
        <artist id="b7ffd2af-418f-4be2-bdd1-22f8b48613da" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
          <name>Nine Inch Nails</name>
          <sort-name>Nine Inch Nails</sort-name>
        </artist>
      </relation>
      <relation type="support act" type-id="492a850e-97eb-306a-a85e-4b6d98527796">
        <target>f7f32d93-0801-45cb-9f5a-e68f640649f4</target>
        <direction>backward</direction>
        <artist id="f7f32d93-0801-45cb-9f5a-e68f640649f4" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
          <name>Cold Cave</name>
          <sort-name>Cold Cave</sort-name>
        </artist>
      </relation>
    </relation-list>
    <relation-list target-type="place">
      <relation type="held at" type-id="e2c6f697-07dc-38b1-be0b-83d740165532">
        <target>478558f9-a951-4067-ad91-e83f6ba63e74</target>
        <direction>forward</direction>
        <place id="478558f9-a951-4067-ad91-e83f6ba63e74" type="Indoor arena" type-id="a77c11f6-82fa-3cc0-9041-ac60e5f6e024">
          <name>Arēna Rīga</name>
          <address>Skanstes iela 21, Rīga, Latvia</address>
          <coordinates>
            <latitude>56.967989</latitude>
            <longitude>24.121403</longitude>
          </coordinates>
        </place>
      </relation>
    </relation-list>
  </event>
</metadata>

JSON Response
  {
    id: "fe39727a-3d21-4066-9345-3970cbd6cca4",
    name: "Nine Inch Nails at Arena Riga",
    disambiguation: "",
    type-id: "ef55e8d7-3d00-394a-8012-f5506a29ff0b",
    type: "Concert",
    life-span: {
      end: "2014-05-06",
      ended: true,
      begin: "2014-05-06"
    },
    time: "19: 00",
    cancelled: false,
    setlist: "* Copy of A * 1,000,000 * Terrible Lie * March of the Pigs * Piggy * The Frail * The Wretched * The Becoming * Gave Up * Closer * Find My Way * Me, I'm Not * Came Back Haunted * The Great Destroyer * Eraser * Wish * Burn * The Hand That Feeds * Head Like a Hole # Encore * Hurt",
    relations: [
      {
        type-id: "936c7c95-3156-3889-a062-8a0cd57f8946",
        type: "main performer",
        direction: "backward",
        target-type: "artist",
        artist: {
          id: "b7ffd2af-418f-4be2-bdd1-22f8b48613da",
          name: "Nine Inch Nails",
          sort-name: "Nine Inch Nails",
          disambiguation: ""
        },
        begin: null,
        end: null,
        ended: false,
        target-credit: "",
        source-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { }
      },
      {
        type-id: "492a850e-97eb-306a-a85e-4b6d98527796",
        type: "support act",
        direction: "backward",
        target-type: "artist",
        artist: {
          id: "f7f32d93-0801-45cb-9f5a-e68f640649f4",
          name: "Cold Cave",
          sort-name: "Cold Cave",
          disambiguation: ""
        },
        begin: null,
        end: null,
        ended: false,
        target-credit: "",
        source-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { }
      },
      {
        type-id: "e2c6f697-07dc-38b1-be0b-83d740165532",
        type: "held at",
        direction: "forward",
        target-type: "place",
        place: {
          id: "478558f9-a951-4067-ad91-e83f6ba63e74",
          name: "Arēna Rīga",
          address: "Skanstes iela 21, Rīga, Latvia",
          coordinates: {
            longitude: 24.121403,
            latitude: 56.967989
          },
          disambiguation: "",
          type-id: "a77c11f6-82fa-3cc0-9041-ac60e5f6e024",
          type: "Indoor arena",
          area: {
            id: "9c612199-d66f-4109-aedc-67ab26e0a43b",
            name: "Rīga",
            sort-name: "Rīga",
            disambiguation: "",
            iso-3166-2-codes: ["LV-RIX"]
          }
        },
        begin: null,
        end: null,
        ended: false,
        target-credit: "",
        source-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { }
      }
    ],
    aliases: [ ]
  }

Genre

Request: http://musicbrainz.org/ws/2/genre/f66d7266-eb3d-4ef3-b4d8-b7cd992f918b

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <genre id="f66d7266-eb3d-4ef3-b4d8-b7cd992f918b">
    <name>crust punk</name>
  </genre>
</metadata>
JSON Response
  {
     id: "f66d7266-eb3d-4ef3-b4d8-b7cd992f918b"
     name: "crust punk",
     disambiguation: "",
  }

Instrument

Request: https://musicbrainz.org/ws/2/instrument/dd430e7f-36ba-49a5-825b-80a525e69190?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <instrument id="dd430e7f-36ba-49a5-825b-80a525e69190" type="Percussion instrument" type-id="68fa2525-4c23-3386-bb81-e84994342e9a">
    <name>kemanak</name>
    <disambiguation>Banana shaped bronze slit-drum used in javanese gamelan</disambiguation>
    <description>Bent into a ladle or banana like shape, it is a pair of bronze slit-drums hit with tabuh beaters.</description>
    <alias-list count="12">
      <alias locale="de" sort-name="Kemanak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd" primary="primary">Kemanak</alias>
      <alias sort-name="gumanak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd">gumanak</alias>
      <alias sort-name="kenawak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd">kenawak</alias>
    </alias-list>
  </instrument>
</metadata>
JSON Response
  {
    id: "dd430e7f-36ba-49a5-825b-80a525e69190",
    name: "kemanak",
    disambiguation: "Banana shaped bronze slit-drum used in javanese gamelan",
    description: "Bent into a ladle or banana like shape, it is a pair of bronze slit-drums hit with tabuh beaters.",
    type-id: "68fa2525-4c23-3386-bb81-e84994342e9a",
    type: "Percussion instrument",
    aliases: [
      {
        name: "gumanak",
        sort-name: "gumanak",
        type-id: "2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd",
        type: "Instrument name",
        locale: null,
        primary: null,
        begin: null,
        end: null,
        ended: false
      },
      {
        name: "kenawak",
        sort-name: "kenawak",
        type-id: "2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd",
        type: "Instrument name",
        locale: null,
        primary: null,
        begin: null,
        end: null,
        ended: false
      }
    ]
  }

Label

Request: http://musicbrainz.org/ws/2/label/46f0f4cd-8aab-4b33-b698-f459faf64190?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <label id="46f0f4cd-8aab-4b33-b698-f459faf64190" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
    <name>Warp</name>
    <sort-name>Warp</sort-name>
    <disambiguation>UK independent label</disambiguation>
    <label-code>2070</label-code>
    <isni-list>
      <isni>0000000107280584</isni>
    </isni-list>
    <country>GB</country>
    <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
      <name>United Kingdom</name>
      <sort-name>United Kingdom</sort-name>
      <iso-3166-1-code-list>
        <iso-3166-1-code>GB</iso-3166-1-code>
      </iso-3166-1-code-list>
    </area>
    <life-span>
      <begin>1989</begin>
    </life-span>
    <alias-list count="1">
      <alias locale="en_GB" sort-name="Warp Records" type="Label name" type-id="3a1a0c48-d885-3b89-87b2-9e8a483c5675">Warp Records</alias>
    </alias-list>
  </label>
</metadata>
JSON Response
  {
    id: "46f0f4cd-8aab-4b33-b698-f459faf64190",
    name: "Warp",
    disambiguation: "UK independent label",
    type-id: "7aaa37fe-2def-3476-b359-80245850062d",
    type: "Original Production",
    label-code: 2070,
    life-span: {
      begin: "1989",
      end: null,
      ended: false
    },
    aliases: [
      {
        name: "Warp Records",
        sort-name: "Warp Records",
        type-id: "3a1a0c48-d885-3b89-87b2-9e8a483c5675",
        type: "Label name",
        locale: "en_GB",
        primary: false,
        begin: null,
        end: null,
        ended: false
      }
    ],
    country: "GB",
    area: {
      id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
      name: "United Kingdom",
      sort-name: "United Kingdom",
      disambiguation: ""
      iso-3166-1-codes: ["GB"],
    },
    ipis: [ ],
    isnis: ["0000000107280584"]
  }

Place

Request: https://musicbrainz.org/ws/2/place/478558f9-a951-4067-ad91-e83f6ba63e74?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <place id="478558f9-a951-4067-ad91-e83f6ba63e74" type="Indoor arena" type-id="a77c11f6-82fa-3cc0-9041-ac60e5f6e024">
    <name>Arēna Rīga</name>
    <address>Skanstes iela 21, Rīga, Latvia</address>
    <coordinates>
      <latitude>56.967989</latitude>
      <longitude>24.121403</longitude>
    </coordinates>
    <area id="9c612199-d66f-4109-aedc-67ab26e0a43b">
      <name>Rīga</name>
      <sort-name>Rīga</sort-name>
      <iso-3166-2-code-list>
        <iso-3166-2-code>LV-RIX</iso-3166-2-code>
      </iso-3166-2-code-list>
    </area>
    <life-span>
      <begin>2006-02-15</begin>
    </life-span>
    <alias-list count="2">
      <alias locale="en" sort-name="Arena Riga" type="Place name" type-id="fb68f9a2-622c-319b-83b0-bbff4127cdc5" primary="primary">Arena Riga</alias>
      <alias locale="lv" sort-name="Arēna Rīga" type="Place name" type-id="fb68f9a2-622c-319b-83b0-bbff4127cdc5" primary="primary">Arēna Rīga</alias>
    </alias-list>
  </place>
</metadata>

JSON Response
  {
    id: "478558f9-a951-4067-ad91-e83f6ba63e74",
    name: "Arēna Rīga",
    disambiguation: "",
    type-id: "a77c11f6-82fa-3cc0-9041-ac60e5f6e024",
    type: "Indoor arena",
    address: "Skanstes iela 21, Rīga, Latvia",
    life-span: {
      begin: "2006-02-15",
      end: null,
      ended: false
    },
    coordinates: {
      longitude: 24.121403,
      latitude: 56.967989
    },
    aliases: [
      {
        name: "Arena Riga",
        sort-name: "Arena Riga",
        type-id: "fb68f9a2-622c-319b-83b0-bbff4127cdc5",
        type: "Place name",
        locale: "en",
        primary: true,
        begin: null,
        end: null,
        ended: false
      }
    ],
    area: {
      id: "9c612199-d66f-4109-aedc-67ab26e0a43b",
      name: "Rīga",
      sort-name: "Rīga",
      disambiguation: "",
      iso-3166-2-codes: ["LV-RIX"]
    },
  }

Recording

Request: https://musicbrainz.org/ws/2/recording/b9ad642e-b012-41c7-b72a-42cf4911f9ff?inc=artist-credits+isrcs+releases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <recording id="b9ad642e-b012-41c7-b72a-42cf4911f9ff">
    <title>LAST ANGEL</title>
    <length>230000</length>
    <artist-credit>
      <name-credit joinphrase=" feat. ">
        <artist id="455641ea-fff4-49f6-8fb4-49f961d8f1ac" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
          <name>倖田來未</name>
          <sort-name>Koda, Kumi</sort-name>
        </artist>
      </name-credit>
      <name-credit>
        <artist id="05cbaf37-6dc2-4f71-a0ce-d633447d90c3" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
          <name>東方神起</name>
          <sort-name>Tohoshinki</sort-name>
        </artist>
      </name-credit>
    </artist-credit>
    <release-list count="13">
      <release id="c33dee6a-e053-4272-84ad-dfeef3f48c8a">
        <title>LAST ANGEL</title>
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      </release>
      <release id="601a4558-e416-410b-a64c-857fc133b75c">
        <title>Kingdom</title>
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      </release>
    </release-list>
    <isrc-list count="1">
      <isrc id="JPB600760301"/>
    </isrc-list>
  </recording>
</metadata>
JSON Response
  {
    id: "b9ad642e-b012-41c7-b72a-42cf4911f9ff",
    title: "LAST ANGEL",
    artist-credit: [
      {
        name: "倖田來未",
        joinphrase: " feat. ",
        artist: {
          id: "455641ea-fff4-49f6-8fb4-49f961d8f1ac",
          name: "倖田來未",
          disambiguation: "",
          sort-name: "Koda, Kumi"
        }
      },
      {
        name: "東方神起",
        joinphrase: "",
        artist: {
          id: "05cbaf37-6dc2-4f71-a0ce-d633447d90c3",
          name: "東方神起",
          disambiguation: "",
          sort-name: "Tohoshinki"
        }
      }
    ],
    disambiguation: "",
    length: 230000,
    video: false,
    isrcs: ["JPB600760301"],
    releases: [
      {
        id: "c33dee6a-e053-4272-84ad-dfeef3f48c8a",
        title: "LAST ANGEL",
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      },
      {
        id: "601a4558-e416-410b-a64c-857fc133b75c",
        title: "Kingdom",
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      }
    ]
  }

Release

Request: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=artist-credits+labels+discids+recordings

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
    <release id="59211ea4-ffd2-4ad9-9a4e-941d3148024a">
        <title>æ³o & h³æ</title>
        <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
        <quality>normal</quality>
        <text-representation>
            <language>eng</language>
            <script>Latn</script>
        </text-representation>
        <artist-credit>
            <name-credit joinphrase=" & ">
                <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                    <name>Autechre</name>
                    <sort-name>Autechre</sort-name>
                    <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
                </artist>
            </name-credit>
            <name-credit>
                <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                    <name>The Hafler Trio</name>
                    <sort-name>Hafler Trio, The</sort-name>
                </artist>
            </name-credit>
        </artist-credit>
        <date>2003-12-04</date>
        <country>GB</country>
        <release-event-list count="1">
            <release-event>
                <date>2003-12-04</date>
                <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
                    <name>United Kingdom</name>
                    <sort-name>United Kingdom</sort-name>
                    <iso-3166-1-code-list>
                        <iso-3166-1-code>GB</iso-3166-1-code>
                    </iso-3166-1-code-list>
                </area>
            </release-event>
        </release-event-list>
        <cover-art-archive>
            <artwork>true</artwork>
            <count>1</count>
            <front>true</front>
            <back>false</back>
        </cover-art-archive>
        <label-info-list count="1">
            <label-info>
                <catalog-number>pgram002</catalog-number>
                <label id="a0759efa-f583-49ea-9a8d-d5bbce55541c" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
                    <name>Phonometrography</name>
                    <sort-name>Phonometrography</sort-name>
                </label>
            </label-info>
        </label-info-list>
        <medium-list count="2">
            <medium>
                <title>æ³o</title>
                <position>1</position>
                <format id="9712d52a-4509-3d4b-a1a2-67c88c643e31">CD</format>
                <disc-list count="1">
                    <disc id="nN2g3a0ZSjovyIgK3bJl6_.j8C4-">
                        <sectors>73241</sectors>
                        <offset-list count="1">
                            <offset position="1">150</offset>
                        </offset-list>
                    </disc>
                </disc-list>
                <track-list count="1" offset="0">
                    <track id="61af3e5a-14e0-350d-9826-a884c6e586b1">
                        <position>1</position>
                        <number>1</number>
                        <length>974546</length>
                        <recording id="af87f070-238b-46c1-aa3e-f831ab91fa20">
                            <title>æ³o</title>
                            <length>974546</length>
                            <artist-credit>
                                <name-credit joinphrase=" & ">
                                    <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                                        <name>Autechre</name>
                                        <sort-name>Autechre</sort-name>
                                        <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
                                    </artist>
                                </name-credit>
                                <name-credit>
                                    <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                                        <name>The Hafler Trio</name>
                                        <sort-name>Hafler Trio, The</sort-name>
                                    </artist>
                                </name-credit>
                            </artist-credit>
                        </recording>
                    </track>
                </track-list>
            </medium>
            <medium>
                <title>h³æ</title>
                <position>2</position>
                <format id="9712d52a-4509-3d4b-a1a2-67c88c643e31">CD</format>
                <disc-list count="1">
                    <disc id="aSHvkMnq2jZVFEK.DmSPbvN_f54-">
                        <sectors>69341</sectors>
                        <offset-list count="1">
                            <offset position="1">150</offset>
                        </offset-list>
                    </disc>
                </disc-list>
                <track-list count="1" offset="0">
                    <track id="5f2031a2-c67d-3bec-8ae5-8d22847ab0a5">
                        <position>1</position>
                        <number>1</number>
                        <length>922546</length>
                        <recording id="5aff6309-2e02-4a47-9233-32d7dcc9a960">
                            <title>h³æ</title>
                            <length>922546</length>
                            <artist-credit>
                                <name-credit joinphrase=" & ">
                                    <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                                        <name>Autechre</name>
                                        <sort-name>Autechre</sort-name>
                                        <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
                                    </artist>
                                </name-credit>
                                <name-credit>
                                    <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                                        <name>The Hafler Trio</name>
                                        <sort-name>Hafler Trio, The</sort-name>
                                    </artist>
                                </name-credit>
                            </artist-credit>
                        </recording>
                    </track>
                </track-list>
            </medium>
        </medium-list>
    </release>
</metadata>
JSON Response
  {
    id: "59211ea4-ffd2-4ad9-9a4e-941d3148024a",
    title: "æ³o & h³æ",
    disambiguation: "",
    artist-credit: [
      {
        name: "Autechre",
        joinphrase: " & ",
        artist: {
          id: "410c9baf-5469-44f6-9852-826524b80c61",
          name: "Autechre",
          sort-name: "Autechre",
          disambiguation: "English electronic music duo Rob Brown & Sean Booth"
        }
      },
      {
        name: "The Hafler Trio",
        joinphrase: "",
        artist: {
          id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
          name: "The Hafler Trio",
          sort-name: "Hafler Trio, The",
          disambiguation: ""
        }
      }
    ],
    date: "2003-12-04",
    country: "GB",
    release-events: [
      {
        date: "2003-12-04",
        area: {
          id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
          name: "United Kingdom",
          sort-name: "United Kingdom",
          iso-3166-1-codes: ["GB"],
          disambiguation: ""
        }
      }
    ],
    label-info: [
      {
        catalog-number: "pgram002",
        label: {
          id: "a0759efa-f583-49ea-9a8d-d5bbce55541c",
          name: "Phonometrography",
          disambiguation: "",
          label-code: null
        }
      }
    ],
    barcode: null,
    packaging-id: null,
    packaging: null,
    status-id: "4e304316-386d-3409-af2e-78857eec5cfe",
    status: "Official",
    quality: "normal",
    text-representation: {
      language: "eng",
      script: "Latn"
    },
    asin: null,
    media: [
      {
        discs: [
          {
            id: "nN2g3a0ZSjovyIgK3bJl6_.j8C4-",
            sectors: 73241,
            offsets: [150],
            offset-count: 1
          }
        ],
        position: 1,
        title: "æ³o",
        format-id: "9712d52a-4509-3d4b-a1a2-67c88c643e31",
        format: "CD",
        track-count: 1,
        track-offset: 0,
        tracks: [
          {
            id: "61af3e5a-14e0-350d-9826-a884c6e586b1",
            title: "æ³o",
            length: 974546,
            number: "1",
            position: 1,
            artist-credit: [
              {
                name: "Autechre",
                joinphrase: " & ",
                artist: {
                  id: "410c9baf-5469-44f6-9852-826524b80c61",
                  name: "Autechre",
                  sort-name: "Autechre",
                  disambiguation: "English electronic music duo Rob Brown & Sean Booth"
                }
              },
              {
                name: "The Hafler Trio",
                joinphrase: "",
                artist: {
                  id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
                  name: "The Hafler Trio",
                  sort-name: "Hafler Trio, The",
                  disambiguation: ""
                }
              }
            ],
            recording: {
              id: "af87f070-238b-46c1-aa3e-f831ab91fa20",
              title: "æ³o",
              disambiguation: "",
              length: 974546,
              video: false,
              artist-credit: [
                {
                  name: "Autechre",
                  joinphrase: " & ",
                  artist: {
                    id: "410c9baf-5469-44f6-9852-826524b80c61",
                    name: "Autechre",
                    sort-name: "Autechre",
                    disambiguation: "English electronic music duo Rob Brown & Sean Booth"
                  }
                },
                {
                  name: "The Hafler Trio",
                  joinphrase: "",
                  artist: {
                    id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
                    name: "The Hafler Trio",
                    sort-name: "Hafler Trio, The",
                    disambiguation: ""
                  }
                }
              ]
            }
          }
        ]
      },
      {
        position: 2,
        title: "h³æ",
        format-id: "9712d52a-4509-3d4b-a1a2-67c88c643e31",
        format: "CD",
        track-count: 1,
        track-offset: 0,
        discs: [
          {
            id: "aSHvkMnq2jZVFEK.DmSPbvN_f54-",
            sectors: 69341,
            offsets: [150],
            offset-count: 1
          }
        ],
        tracks: [
          {
            id: "5f2031a2-c67d-3bec-8ae5-8d22847ab0a5",
            title: "h³æ",
            length: 922546,
            number: "1",
            position: 1,
            artist-credit: [
              {
                name: "Autechre",
                joinphrase: " & ",
                artist: {
                  id: "410c9baf-5469-44f6-9852-826524b80c61",
                  name: "Autechre",
                  sort-name: "Autechre",
                  disambiguation: "English electronic music duo Rob Brown & Sean Booth"
                }
              },
              {
                name: "The Hafler Trio",
                joinphrase: "",
                artist: {
                  id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
                  name: "The Hafler Trio",
                  sort-name: "Hafler Trio, The",
                  disambiguation: ""
                }
              }
            ],
            recording: {
              id: "5aff6309-2e02-4a47-9233-32d7dcc9a960",
              title: "h³æ",
              disambiguation: "",
              length: 922546,
              video: false,
              artist-credit: [
                {
                  name: "Autechre",
                  joinphrase: " & ",
                  artist: {
                    id: "410c9baf-5469-44f6-9852-826524b80c61",
                    name: "Autechre",
                    sort-name: "Autechre",
                    disambiguation: "English electronic music duo Rob Brown & Sean Booth"
                  }
                },
                {
                  name: "The Hafler Trio",
                  joinphrase: "",
                  artist: {
                    id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
                    name: "The Hafler Trio",
                    sort-name: "Hafler Trio, The",
                    disambiguation: ""
                  }
                }
              ]
            }
          }
        ]
      }
    ],
    cover-art-archive: {
      count: 1,
      artwork: true,
      front: true,
      back: false,
      darkened: false
    }
  }

Release Group

Request: http://musicbrainz.org/ws/2/release-group/c9fdb94c-4975-4ed6-a96f-ef6d80bb7738?inc=artist-credits+releases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <release-group id="c9fdb94c-4975-4ed6-a96f-ef6d80bb7738" type="Album" type-id="f529b476-6e62-324f-b0aa-1f3e33d313fc">
    <title>The Lost Tape</title>
    <first-release-date>2012-05-22</first-release-date>
    <primary-type id="f529b476-6e62-324f-b0aa-1f3e33d313fc">Album</primary-type>
    <secondary-type-list>
      <secondary-type id="15c1b1f5-d893-3375-a1db-e180c5ae15ed">Mixtape/Street</secondary-type>
    </secondary-type-list>
    <artist-credit>
      <name-credit>
        <artist id="8e68819d-71be-4e7d-b41d-f1df81b01d3f" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
          <name>50 Cent</name>
          <sort-name>50 Cent</sort-name>
        </artist>
      </name-credit>
    </artist-credit>
    <release-list count="1">
      <release id="2ec84eb6-ab92-4ac3-9720-32ad84c34f11">
        <title>The Lost Tape</title>
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      </release>
    </release-list>
  </release-group>
</metadata>
JSON Response
 {
     id: "c9fdb94c-4975-4ed6-a96f-ef6d80bb7738",
     title: "The Lost Tape",
     first-release-date: "2012-05-22",
     artist-credit: [
         "name": "50 Cent",
         "joinphrase": "",
         "artist": {
             "id": "8e68819d-71be-4e7d-b41d-f1df81b01d3f",
             "name": "50 Cent",
             "sort-name": "50 Cent",
             "disambiguation": ""
         }
     ],
     disambiguation: null,
     primary-type-id: "f529b476-6e62-324f-b0aa-1f3e33d313fc",
     primary-type: "Album",
     secondary-type-ids: ["15c1b1f5-d893-3375-a1db-e180c5ae15ed"]
     secondary-types: [ "Mixtape/Street" ],
     releases: [
         {
             "id": "2ec84eb6-ab92-4ac3-9720-32ad84c34f11",
             "title": "The Lost Tape",
             /* some properties omitted to keep this example shorter, see the release results for the full format */
         }
     ]
  }

URL

Request: https://musicbrainz.org/ws/2/url/46d8f693-52e4-4d03-936f-7ca8459019a7

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <url id="46d8f693-52e4-4d03-936f-7ca8459019a7">
    <resource>https://www.arvopart.ee/</resource>
  </url>
</metadata>
JSON Response
  {
    id: "46d8f693-52e4-4d03-936f-7ca8459019a7",
    resource: "https://www.arvopart.ee/"
  }

Work

For works, you'll generally want to include at least artist-rels (for writers), as in the example below.

Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?inc=artist-rels

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <work id="b1df2cf3-69a9-3bc0-be44-f71e79b27a22" type="Song" type-id="f061270a-2fd6-32f1-a641-f0f8676d14e6">
    <title>HELLO! また会おうね</title>
    <language>jpn</language>
    <language-list>
      <language>jpn</language>
    </language-list>
    <iswc>T-101.690.320-9</iswc>
    <iswc-list>
      <iswc>T-101.690.320-9</iswc>
    </iswc-list>
    <attribute-list>
      <attribute type="JASRAC ID" type-id="31048fcc-3dbb-3979-8f85-805afb933e0c">089-5005-9</attribute>
    </attribute-list>
    <relation-list target-type="artist">
      <relation type="composer" type-id="d59d99ea-23d4-4a80-b066-edca32ee158f">
        <target>d997d399-355e-4c49-9c7b-75a93d76bc0e</target>
        <direction>backward</direction>
        <artist id="d997d399-355e-4c49-9c7b-75a93d76bc0e" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
          <name>つんく♂</name>
          <sort-name>Tsunku</sort-name>
        </artist>
      </relation>
      <relation type="lyricist" type-id="3e48faba-ec01-47fd-8e89-30e81161661c">
        <target>d997d399-355e-4c49-9c7b-75a93d76bc0e</target>
        <direction>backward</direction>
        <artist id="d997d399-355e-4c49-9c7b-75a93d76bc0e" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
          <name>つんく♂</name>
          <sort-name>Tsunku</sort-name>
        </artist>
      </relation>
    </relation-list>
  </work>
</metadata>

JSON Response
  {
    id: "b1df2cf3-69a9-3bc0-be44-f71e79b27a22",
    title: "HELLO! また会おうね",
    type-id: "f061270a-2fd6-32f1-a641-f0f8676d14e6"
    type: "Song",
    disambiguation: "",
    iswcs: ["T-101.690.320-9"],
    languages: ["jpn"],
    attributes: [
      {
        type-id: "31048fcc-3dbb-3979-8f85-805afb933e0c",
        type: "JASRAC ID",
        value: "089-5005-9"
      }
    ],
    relations: [
      {
        type-id: "d59d99ea-23d4-4a80-b066-edca32ee158f",
        type: "composer",
        direction: "backward",
        target-type: "artist",
        artist: {
          id: "d997d399-355e-4c49-9c7b-75a93d76bc0e",
          name: "つんく♂",
          sort-name: "Tsunku",
          disambiguation: ""
        },
        source-credit: "",
        target-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { },
        begin: null,
        end: null,
        ended: false
      },
        type-id: "3e48faba-ec01-47fd-8e89-30e81161661c",
        type: "lyricist",
        direction: "backward",
        target-type: "artist",
        artist: {
          id: "d997d399-355e-4c49-9c7b-75a93d76bc0e",
          name: "つんく♂",
          sort-name: "Tsunku",
          disambiguation: ""
        },
        source-credit: "",
        target-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { },
        begin: null,
        end: null,
        ended: false
      }
    ]
  }

Browse requests

Request: http://musicbrainz.org/ws/2/release?label=47e718e1-7ee4-460c-b1cc-1192a841c6e5&offset=12&limit=2

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <release-list count="106" offset="12">
    <release id="6283480c-5004-4da7-993c-69fd7d2f0681">
      <title>Autumntunes</title>
      /* some properties omitted to keep this example shorter, see the release results for the full format */
    </release>
    <release id="26598ff2-4719-4d26-a3e5-5ccd77119455">
      <title>Around Past</title>
      /* some properties omitted to keep this example shorter, see the release results for the full format */
    </release>
  </release-list>
</metadata>
JSON Response
  {
    releases: [
      {
        id: "26598ff2-4719-4d26-a3e5-5ccd77119455",
        title: "Around Past"
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      },
      {
        id: "6283480c-5004-4da7-993c-69fd7d2f0681",
        title: "Autumntunes"
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      }
    ],
    release-offset: 12,
    release-count: 106
  }

Relationships

You can find standard real-life examples of relationship requests above, under the lookup examples for Event and Work.

See the example below for a classical release (one-track, for simplicity) with both performers (recording level relationships) and composer (work level relationship) using recording-level-rels and work-level-rels.

Request: https://musicbrainz.org/ws/2/release/987f3e2d-22a6-4a4f-b840-c80c26b8b91a?inc=artist-credits+labels+recordings+recording-level-rels+work-rels+work-level-rels+artist-rels

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
    <release id="987f3e2d-22a6-4a4f-b840-c80c26b8b91a">
        <title>Become Desert</title>
        <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
        <quality>normal</quality>
        <packaging id="119eba76-b343-3e02-a292-f0f00644bb9b">None</packaging>
        <text-representation>
            <language>eng</language>
            <script>Latn</script>
        </text-representation>
        <artist-credit>
            <name-credit joinphrase="; ">
                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                    <name>John Luther Adams</name>
                    <sort-name>Adams, John Luther</sort-name>
                </artist>
            </name-credit>
            <name-credit joinphrase=", ">
                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                    <name>Seattle Symphony</name>
                    <sort-name>Seattle Symphony</sort-name>
                </artist>
            </name-credit>
            <name-credit>
                <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                    <name>Ludovic Morlot</name>
                    <sort-name>Morlot, Ludovic</sort-name>
                </artist>
            </name-credit>
        </artist-credit>
        <date>2019-06-14</date>
        <country>XW</country>
        <release-event-list count="1">
            <release-event>
                <date>2019-06-14</date>
                <area id="525d4e18-3d00-31b9-a58b-a146a916de8f">
                    <name>[Worldwide]</name>
                    <sort-name>[Worldwide]</sort-name>
                    <iso-3166-1-code-list>
                        <iso-3166-1-code>XW</iso-3166-1-code>
                    </iso-3166-1-code-list>
                </area>
            </release-event>
        </release-event-list>
        <cover-art-archive>
            <artwork>true</artwork>
            <count>1</count>
            <front>true</front>
            <back>false</back>
        </cover-art-archive>
        <label-info-list count="1">
            <label-info>
                <label id="3044afdb-c895-4f60-8e69-5796b3887c21" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
                    <name>Cantaloupe Music</name>
                    <sort-name>Cantaloupe Music</sort-name>
                </label>
            </label-info>
        </label-info-list>
        <medium-list count="1">
            <medium>
                <position>1</position>
                <format id="907a28d9-b3b2-3ef6-89a8-7b18d91d4794">Digital Media</format>
                <track-list count="1" offset="0">
                    <track id="33781879-1dae-422c-a634-b26f89705e48">
                        <position>1</position>
                        <number>1</number>
                        <length>2422450</length>
                        <artist-credit>
                            <name-credit>
                                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                    <name>John Luther Adams</name>
                                    <sort-name>Adams, John Luther</sort-name>
                                </artist>
                            </name-credit>
                        </artist-credit>
                        <recording id="d90bc0ff-c7d9-4c09-a12b-d46f46f7281d">
                            <title>Become Desert</title>
                            <length>2422450</length>
                            <artist-credit>
                                <name-credit joinphrase=", ">
                                    <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                        <name>Seattle Symphony</name>
                                        <sort-name>Seattle Symphony</sort-name>
                                    </artist>
                                </name-credit>
                                <name-credit>
                                    <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Ludovic Morlot</name>
                                        <sort-name>Morlot, Ludovic</sort-name>
                                    </artist>
                                </name-credit>
                            </artist-credit>
                            <relation-list target-type="artist">
                                <relation type="conductor" type-id="234670ce-5f22-4fd0-921b-ef1662695c5d">
                                    <target>eace8da8-8535-47c4-82da-902c792ec9f4</target>
                                    <direction>backward</direction>
                                    <begin>2018-09-25</begin>
                                    <end>2018-09-26</end>
                                    <ended>true</ended>
                                    <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Ludovic Morlot</name>
                                        <sort-name>Morlot, Ludovic</sort-name>
                                    </artist>
                                </relation>
                                <relation type="mix" type-id="3e3102e1-1896-4f50-b5b2-dd9824e46efe">
                                    <target>ac0122d6-14e8-4335-a01f-5d6ee71d308b</target>
                                    <direction>backward</direction>
                                    <artist id="ac0122d6-14e8-4335-a01f-5d6ee71d308b" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Nathaniel Reichman</name>
                                        <sort-name>Reichman, Nathaniel</sort-name>
                                        <disambiguation>music producer, rerecording mixer</disambiguation>
                                    </artist>
                                </relation>
                                <relation type="performing orchestra" type-id="3b6616c5-88ba-4341-b4ee-81ce1e6d7ebb">
                                    <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
                                    <direction>backward</direction>
                                    <begin>2018-09-25</begin>
                                    <end>2018-09-26</end>
                                    <ended>true</ended>
                                    <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                        <name>Seattle Symphony</name>
                                        <sort-name>Seattle Symphony</sort-name>
                                    </artist>
                                </relation>
                                <relation type="producer" type-id="5c0ceac3-feb4-41f0-868d-dc06f6e27fc0">
                                    <target>748b47b2-604b-4487-b994-944918df19e9</target>
                                    <direction>backward</direction>
                                    <artist id="748b47b2-604b-4487-b994-944918df19e9" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Dmitriy Lipay</name>
                                        <sort-name>Lipay, Dmitriy</sort-name>
                                        <disambiguation>recording engineer & producer</disambiguation>
                                    </artist>
                                </relation>
                                <relation type="producer" type-id="5c0ceac3-feb4-41f0-868d-dc06f6e27fc0">
                                    <target>ac0122d6-14e8-4335-a01f-5d6ee71d308b</target>
                                    <direction>backward</direction>
                                    <artist id="ac0122d6-14e8-4335-a01f-5d6ee71d308b" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Nathaniel Reichman</name>
                                        <sort-name>Reichman, Nathaniel</sort-name>
                                        <disambiguation>music producer, rerecording mixer</disambiguation>
                                    </artist>
                                </relation>
                                <relation type="recording" type-id="a01ee869-80a8-45ef-9447-c59e91aa7926">
                                    <target>e2a6142d-83f5-4626-a48a-1211588d06db</target>
                                    <direction>backward</direction>
                                    <artist id="e2a6142d-83f5-4626-a48a-1211588d06db" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Alexander Lipay</name>
                                        <sort-name>Lipay, Alexander</sort-name>
                                    </artist>
                                </relation>
                                <relation type="recording" type-id="a01ee869-80a8-45ef-9447-c59e91aa7926">
                                    <target>748b47b2-604b-4487-b994-944918df19e9</target>
                                    <direction>backward</direction>
                                    <artist id="748b47b2-604b-4487-b994-944918df19e9" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Dmitriy Lipay</name>
                                        <sort-name>Lipay, Dmitriy</sort-name>
                                        <disambiguation>recording engineer & producer</disambiguation>
                                    </artist>
                                </relation>
                            </relation-list>
                            <relation-list target-type="work">
                                <relation type="performance" type-id="a3005666-a872-32c3-ad06-98af558e99b0">
                                    <target>b6cb19ec-08d3-4563-9e82-9562e5cab030</target>
                                    <direction>forward</direction>
                                    <begin>2018-09-25</begin>
                                    <end>2018-09-26</end>
                                    <ended>true</ended>
                                    <work id="b6cb19ec-08d3-4563-9e82-9562e5cab030" type="Symphony" type-id="174314aa-0aa4-30cf-96a6-50b281d8d208">
                                        <title>Become Desert</title>
                                        <language>zxx</language>
                                        <language-list>
                                            <language>zxx</language>
                                        </language-list>
                                        <relation-list target-type="artist">
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
                                                <target>7cdb68bc-c4f1-4a92-9bd2-739641c5eff0</target>
                                                <direction>backward</direction>
                                                <artist id="7cdb68bc-c4f1-4a92-9bd2-739641c5eff0" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>New York Philharmonic</name>
                                                    <sort-name>New York Philharmonic</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
                                                <target>c5958778-9c97-4970-9e63-0072ab2c4189</target>
                                                <direction>backward</direction>
                                                <artist id="c5958778-9c97-4970-9e63-0072ab2c4189" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>Rotterdams Philharmonisch Orkest</name>
                                                    <sort-name>Rotterdams Philharmonisch Orkest</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
                                                <target>68f7b9d5-b329-40aa-a474-5abffd6dfb44</target>
                                                <direction>backward</direction>
                                                <artist id="68f7b9d5-b329-40aa-a474-5abffd6dfb44" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>San Diego Symphony</name>
                                                    <sort-name>San Diego Symphony</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
                                                <direction>backward</direction>
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>Seattle Symphony</name>
                                                    <sort-name>Seattle Symphony</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="composer" type-id="d59d99ea-23d4-4a80-b066-edca32ee158f">
                                                <target>96681463-98e2-4032-9728-5fbb7b002427</target>
                                                <direction>backward</direction>
                                                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                                    <name>John Luther Adams</name>
                                                    <sort-name>Adams, John Luther</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="premiere" type-id="5cc8cfb5-cca0-4395-a44b-b7d3c1777608">
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
                                                <direction>backward</direction>
                                                <begin>2018-03-21</begin>
                                                <end>2018-03-21</end>
                                                <ended>true</ended>
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>Seattle Symphony</name>
                                                    <sort-name>Seattle Symphony</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="premiere" type-id="5cc8cfb5-cca0-4395-a44b-b7d3c1777608">
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
                                                <direction>backward</direction>
                                                <begin>2018-03-29</begin>
                                                <end>2018-03-29</end>
                                                <ended>true</ended>
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>Seattle Symphony</name>
                                                    <sort-name>Seattle Symphony</sort-name>
                                                </artist>
                                            </relation>
                                        </relation-list>
                                    </work>
                                </relation>
                            </relation-list>
                        </recording>
                    </track>
                </track-list>
            </medium>
        </medium-list>
    </release>
</metadata>
JSON Response
  {
    id: "987f3e2d-22a6-4a4f-b840-c80c26b8b91a",
    title: "Become Desert",
    disambiguation: "",
    artist-credit: [
      {
        name: "John Luther Adams",
        joinphrase: "; ",
        artist: {
          id: "96681463-98e2-4032-9728-5fbb7b002427",
          name: "John Luther Adams",
          sort-name: "Adams, John Luther",
          disambiguation: ""
        }
      },
      {
        name: "Seattle Symphony",
        joinphrase: ", ",
        artist: {
          id: "0b51c328-1f2b-464c-9e2c-0c2a8cce20ae",
          name: "Seattle Symphony",
          sort-name: "Seattle Symphony",
          disambiguation: ""
        }
      },
      {
        name: "Ludovic Morlot",
        joinphrase: "",
        artist: {
          id: "eace8da8-8535-47c4-82da-902c792ec9f4",
          name: "Ludovic Morlot",
          sort-name: "Morlot, Ludovic",
          disambiguation: ""
        }
      }
    ],
    text-representation: {
      language: "eng",
      script: "Latn"
    },
    date: "2019-06-14",
    country: "XW",
    release-events: [
      {
        date: "2019-06-14",
        area: {
          id: "525d4e18-3d00-31b9-a58b-a146a916de8f",
          name: "[Worldwide]",
          sort-name: "[Worldwide]",
          disambiguation: "",
          iso-3166-1-codes: ["XW"]
        }
      }
    ],
    label-info: [
      {
        label: {
          id: "3044afdb-c895-4f60-8e69-5796b3887c21",
          sort-name: "Cantaloupe Music",
          name: "Cantaloupe Music",
          label-code: null,
          disambiguation: ""
        },
        catalog-number: null
      }
    ],
    barcode: null,
    status-id: "4e304316-386d-3409-af2e-78857eec5cfe",
    status: "Official",
    packaging-id: "119eba76-b343-3e02-a292-f0f00644bb9b",
    packaging: "None",
    quality: "normal",
    relations: [ ],
    asin: null,
    media: [
      {
        position: 1,
        format-id: "907a28d9-b3b2-3ef6-89a8-7b18d91d4794",
        format: "Digital Media",
        title: "",
        track-count: 1,
        track-offset: 0,
        tracks: [
          {
            id: "33781879-1dae-422c-a634-b26f89705e48",
            title: "Become Desert",
            length: 2422450,
            number: "1",
            position: 1,
            artist-credit: [
              {
                name: "John Luther Adams",
                joinphrase: "",
                artist: {
                  id: "96681463-98e2-4032-9728-5fbb7b002427",
                  name: "John Luther Adams",
                  sort-name: "Adams, John Luther",
                  disambiguation: ""
                }
              }
            ],
            recording: {
              id: "d90bc0ff-c7d9-4c09-a12b-d46f46f7281d",
              title: "Become Desert",
              disambiguation: "",
              length: 2422450,
              video: false,
              artist-credit: [
                {
                  name: "Seattle Symphony",
                  joinphrase: ", ",
                  artist: {
                    id: "0b51c328-1f2b-464c-9e2c-0c2a8cce20ae",
                    name: "Seattle Symphony",
                    sort-name: "Seattle Symphony",
                    disambiguation: ""
                  }
                },
                {
                  name: "Ludovic Morlot",
                  joinphrase: "",
                  artist: {
                    id: "eace8da8-8535-47c4-82da-902c792ec9f4",
                    sort-name: "Morlot, Ludovic",
                    disambiguation: "",
                    name: "Ludovic Morlot"
                  }
                }
              ],
              relations: [
                {
                  type-id: "234670ce-5f22-4fd0-921b-ef1662695c5d",
                  type: "conductor",
                  direction: "backward",
                  target-type: "artist",
                  artist: {
                    id: "eace8da8-8535-47c4-82da-902c792ec9f4",
                    name: "Ludovic Morlot",
                    sort-name: "Morlot, Ludovic",
                    disambiguation: ""
                  },
                  begin: "2018-09-25",
                  end: "2018-09-26",
                  ended: true,
                  target-credit: "",
                  source-credit: "",
                  attributes: [ ],
                  attribute-values: { },
                  attribute-ids: { }
                },
                {
                  type-id: "3b6616c5-88ba-4341-b4ee-81ce1e6d7ebb",
                  type: "performing orchestra",
                  direction: "backward",
                  target-type: "artist",
                  artist: {
                    id: "0b51c328-1f2b-464c-9e2c-0c2a8cce20ae",
                    name: "Seattle Symphony",
                    sort-name: "Seattle Symphony",
                    disambiguation: ""
                  },
                  begin: "2018-09-25",
                  end: "2018-09-26",
                  ended: true,
                  target-credit: "",
                  source-credit: "",
                  attributes: [ ],
                  attribute-values: { },
                  attribute-ids: { }
                },
                {
                  type-id: "a01ee869-80a8-45ef-9447-c59e91aa7926",
                  type: "recording",
                  direction: "backward",
                  target-type: "artist",
                  artist: {
                    id: "e2a6142d-83f5-4626-a48a-1211588d06db",
                    name: "Alexander Lipay",
                    sort-name: "Lipay, Alexander",
                    disambiguation: ""
                  },
                  begin: null,
                  end: null,
                  ended: false,
                  target-credit: "",
                  source-credit: "",
                  attributes: [ ],
                  attribute-values: { },
                  attribute-ids: { }
                },
                {
                  type-id: "a3005666-a872-32c3-ad06-98af558e99b0",
                  type: "performance",
                  direction: "forward",
                  target-type: "work",
                  work: {
                    id: "b6cb19ec-08d3-4563-9e82-9562e5cab030",
                    title: "Become Desert",
                    disambiguation: "",
                    type-id: null,
                    type: null,
                    languages: ["zxx"],
                    iswcs: [ ],
                    attributes: [ ],
                    relations: [
                      {
                        type-id: "d59d99ea-23d4-4a80-b066-edca32ee158f",
                        type: "composer",
                        direction: "backward",
                        target-type: "artist",
                        artist: {
                          id: "96681463-98e2-4032-9728-5fbb7b002427",
                          name: "John Luther Adams",
                          sort-name: "Adams, John Luther",
                          disambiguation: ""
                        },
                        begin: null,
                        end: null,
                        ended: false,
                        source-credit: "",
                        target-credit: "",
                        attributes: [ ],
                        attribute-ids: { },
                        attribute-values: { }
                      },
                      {
                        type-id: "95f0213a-dbe0-4d36-8036-9782e425e98a",
                        type: "commissioned",
                        direction: "backward",
                        target-type: "artist",
                        artist: {
                          id: "7cdb68bc-c4f1-4a92-9bd2-739641c5eff0",
                          name: "New York Philharmonic",
                          sort-name: "New York Philharmonic",
                          disambiguation: ""
                        },
                        begin: null,
                        end: null,
                        ended: false,
                        source-credit: "",
                        target-credit: "",
                        attributes: [ ],
                        attribute-ids: { },
                        attribute-values: { }
                      }
                    ]
                  },
                  begin: "2018-09-25",
                  end: "2018-09-26",
                  ended: true,
                  target-credit: "",
                  source-credit: "",
                  attributes: [ ],
                  attribute-ids: { },
                  attribute-values: { }
                }
              ]
            }
          }
        ]
      }
    ],
    cover-art-archive: {
      artwork: true,
      count: 1,
      front: true,
      back: false,
      darkened: false
    }
  }

Genres, tags and ratings

You can include genres, tags and ratings to get this secondary data. Below is an example of a request including all of the three.

Request: http://musicbrainz.org/ws/2/artist/db92a151-1ac2-438b-bc43-b82e149ddd50?inc=aliases+genres+tags+ratings

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <artist id="db92a151-1ac2-438b-bc43-b82e149ddd50" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
    <name>Rick Astley</name>
    <sort-name>Astley, Rick</sort-name>
    <disambiguation>English singer, songwriter and radio personality</disambiguation>
    <ipi>00159849414</ipi>
    <ipi-list>
      <ipi>00159849414</ipi>
    </ipi-list>
    <isni-list>
      <isni>0000000120203276</isni>
    </isni-list>
    <gender id="36d3d30a-839d-3eda-8cb3-29be4384e4a9">Male</gender>
    <country>GB</country>
    <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
      <name>United Kingdom</name>
      <sort-name>United Kingdom</sort-name>
      <iso-3166-1-code-list>
        <iso-3166-1-code>GB</iso-3166-1-code>
      </iso-3166-1-code-list>
    </area>
    <begin-area id="71baf484-64ec-4482-9ad2-225aa3b9a337">
      <name>Newton-le-Willows</name>
      <sort-name>Newton-le-Willows</sort-name>
    </begin-area>
    <life-span>
      <begin>1966-02-06</begin>
    </life-span>
    <alias-list count="5">
      <alias sort-name="Astley, Richard Paul" type="Legal name" type-id="d4dcd0c0-b341-3612-a332-c0ce797b25cf">Richard Paul Astley</alias>
    </alias-list>
    <tag-list>
      <tag count="2">
        <name>adult contemporary</name>
      </tag>
      <tag count="2">
        <name>blue-eyed soul</name>
      </tag>
      <tag count="0">
        <name>british</name>
      </tag>
      <tag count="0">
        <name>classic pop and rock</name>
      </tag>
      <tag count="2">
        <name>dance-pop</name>
      </tag>
      <tag count="0">
        <name>english</name>
      </tag>
      <tag count="2">
        <name>pop</name>
      </tag>
      <tag count="0">
        <name>uk</name>
      </tag>
    </tag-list>
    <genre-list>
      <genre count="2" id="650bda08-20ca-4012-b873-3b68c5768bdf">
        <name>blue-eyed soul</name>
      </genre>
      <genre count="2" id="b739a895-85ed-4ad3-8717-4e9ef5387dd8">
        <name>dance-pop</name>
      </genre>
      <genre count="2" id="911c7bbb-172d-4df8-9478-dbff4296e791">
        <name>pop</name>
      </genre>
    </genre-list>
    <rating votes-count="2">4.5</rating>
  </artist>
</metadata>
JSON Response
  {
    id: "db92a151-1ac2-438b-bc43-b82e149ddd50",
    name: "Rick Astley",
    sort-name: "Astley, Rick",
    disambiguation: "English singer, songwriter and radio personality",
    type-id: "b6e035f4-3ce9-331c-97df-83397230b0df",
    type: "Person",
    gender-id: "36d3d30a-839d-3eda-8cb3-29be4384e4a9",
    gender: "Male",
    life-span: {
      end: null,
      ended: false,
      begin: "1966-02-06"
    },
    country: "GB"
    area: {
      id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
      name: "United Kingdom",
      sort-name: "United Kingdom",
      disambiguation: "",
      iso-3166-1-codes: ["GB"]
    },
    begin-area: {
      id: "71baf484-64ec-4482-9ad2-225aa3b9a337"
      name: "Newton-le-Willows",
      sort-name: "Newton-le-Willows",
      disambiguation: "",
    },
    end-area: null,
    ipis: ["00159849414"],
    isnis: ["0000000120203276"],
    aliases: [
      {
        name: "Richard Paul Astley",
        sort-name: "Astley, Richard Paul",
        type-id: "d4dcd0c0-b341-3612-a332-c0ce797b25cf",
        type: "Legal name",
        locale: null,
        primary: null,
        begin: null,
        end: null
        ended: false,
      }
    ],
    genres: [
      {
        name: "blue-eyed soul",
        id: "650bda08-20ca-4012-b873-3b68c5768bdf",
        count: 2,
        disambiguation: "",
      },
      {
        name: "dance-pop",
        id: "b739a895-85ed-4ad3-8717-4e9ef5387dd8",
        count: 2,
        disambiguation: "",
      },
      {
        name: "pop",
        id: "911c7bbb-172d-4df8-9478-dbff4296e791",
        count: 2,
        disambiguation: "",
      },
    ],
    tags: [
      {name: "blue-eyed soul", count: 2},
      {name: "british", count: 0}
    ],
    rating: {
      value: 4.5,
      votes-count: 2
    }
  }