Difference between revisions of "MusicBrainz API/Examples"

From MusicBrainz Wiki
m
m (Relationships)
 
(51 intermediate revisions by 2 users 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.
+
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.
  
This document describes the proposed JSON output, using example queries and the responses I am proposing. To get a JSON response 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).
+
==Lookup requests==
 +
===Area===
 +
 
 +
Request: https://musicbrainz.org/ws/2/area/45f07934-675a-46d6-a577-6f8637a411b1?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#">
 +
  <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>
  
Some notable differences compared to the JSON response currently used internally by the search server:
+
<div class="toccolours mw-collapsible mw-collapsed">
# all "-list" elements are replaced with javascript arrays, using an english plural as the key. So { "tag-list": { "tag": [ ... ] } } becomes { "tags": [ ... ] }.
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
# the "name-credit" key inside an "artist-credit" is removed.
+
<pre class="mw-collapsible-content">
 +
  {
 +
    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
 +
      }
 +
    ]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
  
Some of the responses below have some fields omitted to keep the examples shorter, in the actual webservice obviously this data will be included.
+
===Artist===
  
==Beta==
+
Request: http://musicbrainz.org/ws/2/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da?inc=aliases
  
WARNING: This web service is available on the production server (musicbrainz.org/ws/2/), but should be not be considered stable.  There are still some [http://tickets.musicbrainz.org/browse/MBS-3072 known bugs], and we may decide to make some small changes to the API as documented below. If you have any feedback comment on the [http://tickets.musicbrainz.org/browse/MBS-3072 ticket] or contact warp through e-mail or irc.  When we mark the API as stable we will be very reluctant to make any changes, so now is the time if you have any feedback or suggestions.
+
<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>
  
==Lookup requests==
+
<div class="toccolours mw-collapsible mw-collapsed">
===Artist===
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    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"
 +
      }
 +
    ]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
===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
 +
 
 +
<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 style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    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: [ ]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
===Genre===
 +
 
 +
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 style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    id: "f66d7266-eb3d-4ef3-b4d8-b7cd992f918b"
 +
    name: "crust punk",
 +
    disambiguation: "",
 +
  }
 +
</pre>
 +
</div>
 +
</div>
  
Request: http://musicbrainz.org/ws/2/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da?inc=aliases&fmt=json<br />
+
===Instrument===
Response:
 
  
<code>
+
Request: https://musicbrainz.org/ws/2/instrument/dd430e7f-36ba-49a5-825b-80a525e69190?inc=aliases
{
 
    "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
 
    "name": "Nirvana",
 
    "sort-name": "Nirvana"
 
    "type": "Group",
 
    "country": "US",
 
    "disambiguation": "90s US grunge band",
 
    "life-span": {
 
        "ended": true,
 
        "begin": "1988-02",
 
        "end": "1994-04-05"
 
    },
 
    "aliases": [ { "name": "Nirvana US", "sort-name": "Nirvana US" } ]]
 
}
 
</code>
 
  
Request: http://musicbrainz.org/ws/2/artist/05cbaf37-6dc2-4f71-a0ce-d633447d90c3?inc=aliases+tags+ratings&fmt=json<br />
+
<div class="toccolours mw-collapsible mw-collapsed">
Response:
+
<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>
  
<code>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
    "id": "05cbaf37-6dc2-4f71-a0ce-d633447d90c3",
+
<pre class="mw-collapsible-content">
    "name": "東方神起",
+
  {
    "sort-name": "TVXQ",
+
    id: "dd430e7f-36ba-49a5-825b-80a525e69190",
    "country": null,
+
    name: "kemanak",
    "disambiguation": null,
+
    disambiguation: "Banana shaped bronze slit-drum used in javanese gamelan",
    "type": "Group",
+
    description: "Bent into a ladle or banana like shape, it is a pair of bronze slit-drums hit with tabuh beaters.",
    "life-span": { "ended": false, "begin": "2003" },
+
    type-id: "68fa2525-4c23-3386-bb81-e84994342e9a",
    "aliases": [
+
    type: "Percussion instrument",
        { "name": "DBSK", "sort-name": "DBSK" },
+
    aliases: [
        { "name": "Tohoshinki", "sort-name": "Tohoshinki", "locale": "ja", "primary": false },
+
      {
        { "name": "동방신기", "sort-name": "동방신기", "locale": "ko_KR", "primary": true }
+
        name: "gumanak",
    ],
+
        sort-name: "gumanak",
    "tags": [
+
        type-id: "2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd",
        { "count": 1, "name": "kpop" },
+
        type: "Instrument name",
        { "count": 1, "name": "jpop" },
+
        locale: null,
        { "count": 1, "name": "cpop" }
+
        primary: null,
    ],
+
        begin: null,
    "rating": { "votes-count": 8, "value": 3.9 }
+
        end: null,
}
+
        ended: false
</code>
+
      },
 +
      {
 +
        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
 +
      }
 +
    ]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
  
 
===Label===
 
===Label===
  
Request: http://musicbrainz.org/ws/2/label/46f0f4cd-8aab-4b33-b698-f459faf64190?inc=aliases&fmt=json<br />
+
Request: http://musicbrainz.org/ws/2/label/46f0f4cd-8aab-4b33-b698-f459faf64190?inc=aliases
Response:
+
 
 +
<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 style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    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"]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
===Place===
 +
 
 +
Request: https://musicbrainz.org/ws/2/place/478558f9-a951-4067-ad91-e83f6ba63e74?inc=aliases
  
<code>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
    "id": "46f0f4cd-8aab-4b33-b698-f459faf64190",
+
<pre class="mw-collapsible-content">
    "name": "Warp Records",
+
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
    "sort-name": "Warp Records",
+
  <place id="478558f9-a951-4067-ad91-e83f6ba63e74" type="Indoor arena" type-id="a77c11f6-82fa-3cc0-9041-ac60e5f6e024">
    "label-code": 2070,
+
    <name>Arēna Rīga</name>
    "type": "Original Production",
+
    <address>Skanstes iela 21, Rīga, Latvia</address>
    "country": "GB",
+
    <coordinates>
    "life-span": { "ended": false, "begin": "1989" },
+
      <latitude>56.967989</latitude>
    "tags": [ { "count": 2, "name": "electronic" } ],
+
      <longitude>24.121403</longitude>
    "disambiguation": null,
+
    </coordinates>
}
+
    <area id="9c612199-d66f-4109-aedc-67ab26e0a43b">
</code>
+
      <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>
  
Request: http://musicbrainz.org/ws/2/label/f49e877d-df8d-4a28-bbe1-689d12fc7d91?inc=aliases&fmt=json<br />
+
</pre>
Response:
+
</div>
 +
</div>
  
<code>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
    "id": "f49e877d-df8d-4a28-bbe1-689d12fc7d91"
+
<pre class="mw-collapsible-content">
    "name": "AVEX ENTERTAINMENT INC.",
+
  {
    "sort-name": "AVEX ENTERTAINMENT INC.",
+
    id: "478558f9-a951-4067-ad91-e83f6ba63e74",
    "type": "Production",
+
    name: "Arēna Rīga",
    "country": "JP",
+
    disambiguation: "",
    "disambiguation": "avex's Japanese music production",
+
    type-id: "a77c11f6-82fa-3cc0-9041-ac60e5f6e024",
    "life-span": { "ended": false },
+
    type: "Indoor arena",
    "aliases": [
+
    address: "Skanstes iela 21, Rīga, Latvia",
        { "name": "AVEX MARKETING", "sort-name": "AVEX MARKETING" },
+
    life-span: {
        { "name": "avex marketing", "sort-name": "avex marketing" },
+
      begin: "2006-02-15",
        {
+
      end: null,
            "name": "エイベックス・エンタテインメント",
+
      ended: false
            "sort-name": "エイベックス・エンタテインメント"
+
    },
        }
+
    coordinates: {
    ]
+
      longitude: 24.121403,
}
+
      latitude: 56.967989
</code>
+
    },
 +
    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"]
 +
    },
 +
  }
 +
</pre>
 +
</div>
 +
</div>
  
 
===Recording===
 
===Recording===
  
Request: http://musicbrainz.org/ws/2/recording/fcbcdc39-8851-4efc-a02a-ab0e13be224f?inc=artist-credits+isrcs+releases&fmt=json<br />
+
Request: https://musicbrainz.org/ws/2/recording/b9ad642e-b012-41c7-b72a-42cf4911f9ff?inc=artist-credits+isrcs+releases
Response:
 
  
<code>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
    "id": "fcbcdc39-8851-4efc-a02a-ab0e13be224f",
+
<pre class="mw-collapsible-content">
    "title": "LAST ANGEL",
+
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
    "disambiguation": "video",
+
  <recording id="b9ad642e-b012-41c7-b72a-42cf4911f9ff">
    "artist-credit": [
+
    <title>LAST ANGEL</title>
        {
+
    <length>230000</length>
            "name": "倖田來未",
+
    <artist-credit>
            "joinphrase": " feat. ",
+
      <name-credit joinphrase=" feat. ">
            "artist": {
+
        <artist id="455641ea-fff4-49f6-8fb4-49f961d8f1ac" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                "id": "455641ea-fff4-49f6-8fb4-49f961d8f1ac",
+
          <name>倖田來未</name>
                "name": "倖田來未",
+
          <sort-name>Koda, Kumi</sort-name>
                "sort-name": "Koda, Kumi",
+
        </artist>
                "disambiguation": null
+
      </name-credit>
            }
+
      <name-credit>
        },
+
        <artist id="05cbaf37-6dc2-4f71-a0ce-d633447d90c3" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
        {
+
          <name>東方神起</name>
            "name": "東方神起",
+
          <sort-name>Tohoshinki</sort-name>
            "artist": {
+
        </artist>
                "id": "05cbaf37-6dc2-4f71-a0ce-d633447d90c3",
+
      </name-credit>
                "name": "東方神起",
+
    </artist-credit>
                "sort-name": "TVXQ",
+
    <release-list count="13">
                "disambiguation": null
+
      <release id="c33dee6a-e053-4272-84ad-dfeef3f48c8a">
            },
+
        <title>LAST ANGEL</title>
            "joinphrase": ""
+
        /* some properties omitted to keep this example shorter, see the release results for the full format */
        }
+
      </release>
    ],
+
      <release id="601a4558-e416-410b-a64c-857fc133b75c">
    "isrcs": [ "JPB600760301" ],
+
        <title>Kingdom</title>
    "length": 228106,
+
        /* some properties omitted to keep this example shorter, see the release results for the full format */
    "releases": [
+
      </release>
        {
+
    </release-list>
            "id": "abcd76db-7d5f-3eb7-b386-051c97bfe2e4",
+
    <isrc-list count="1">
            "title": "Kingdom",
+
      <isrc id="JPB600760301"/>
            /* some properties omitted to keep this example shorter. */
+
    </isrc-list>
        }
+
  </recording>
    ]
+
</metadata>
}
+
</pre>
</code>
+
</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">
 +
  {
 +
    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 */
 +
      }
 +
    ]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
  
 
===Release===
 
===Release===
  
Request: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=artist-credits+labels+discids+recordings&fmt=json<br/>
+
Request: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=artist-credits+labels+discids+recordings
Response:
+
 
 +
<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>
  
<code>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
    "id": "59211ea4-ffd2-4ad9-9a4e-941d3148024a",
+
<pre class="mw-collapsible-content">
    "title": "æ³o & h³æ",
+
  {
    "date": "2003-12-04",
+
    id: "59211ea4-ffd2-4ad9-9a4e-941d3148024a",
    "text-representation": { "language": "eng", "script": "Latn" },
+
    title: "æ³o & h³æ",
    "country": "GB",
+
    disambiguation: "",
    "status": "Official",
+
    artist-credit: [
    "quality": "normal",
+
      {
    "release-group": {
+
        name: "Autechre",
        "id": "bb5622c1-65b2-3bc4-83e6-0dcaa56abaf2",
+
        joinphrase: " & ",
        "primary-type": "EP"
+
        artist: {
    },
+
          id: "410c9baf-5469-44f6-9852-826524b80c61",
    "artist-credit": [
+
          name: "Autechre",
        {
+
          sort-name: "Autechre",
            "joinphrase": " & ",
+
          disambiguation: "English electronic music duo Rob Brown & Sean Booth"
            "name": "Autechre",
+
        }
            "artist": {
+
      },
                "id": "410c9baf-5469-44f6-9852-826524b80c61",
+
      {
                "name": "Autechre",
+
        name: "The Hafler Trio",
                "sort-name": "Autechre",
+
        joinphrase: "",
                "disambiguation": null
+
        artist: {
            }
+
          id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
        },
+
          name: "The Hafler Trio",
        {
+
          sort-name: "Hafler Trio, The",
            "name": "The Hafler Trio",
+
          disambiguation: ""
            "joinphrase": "",
+
        }
            "artist": {
+
      }
                "id": "146c01d0-d3a2-44c3-acb5-9208bce75e14",
+
    ],
                "sort-name": "Hafler Trio, The",
+
    date: "2003-12-04",
                "name": "The Hafler Trio",
+
    country: "GB",
                "disambiguation": null
+
    release-events: [
            }
+
      {
        }
+
        date: "2003-12-04",
    ],
+
        area: {
    "label-info": [
+
          id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
        {
+
          name: "United Kingdom",
            "label": {
+
          sort-name: "United Kingdom",
                "id": "a0759efa-f583-49ea-9a8d-d5bbce55541c",
+
          iso-3166-1-codes: ["GB"],
                "name": "Phonometrography",
+
          disambiguation: ""
                "sort-name": "Phonometrography",
+
        }
                "label-code": null,
+
      }
                "disambiguation": null
+
    ],
            },
+
    label-info: [
            "catalog-number": "pgram002"
+
      {
        }
+
        catalog-number: "pgram002",
    ],
+
        label: {
    "media": [
+
          id: "a0759efa-f583-49ea-9a8d-d5bbce55541c",
        {
+
          name: "Phonometrography",
            "track-offset": 0,
+
          disambiguation: "",
            "track-count": 1,
+
          label-code: null
            "title": "æ³o",
+
        }
            "format": "CD",
+
      }
            "discids": [
+
    ],
                { "id": "nN2g3a0ZSjovyIgK3bJl6_.j8C4-", "sectors": 73241 }
+
    barcode: null,
            ],
+
    packaging-id: null,
            "tracks": [
+
    packaging: null,
                {
+
    status-id: "4e304316-386d-3409-af2e-78857eec5cfe",
                    "number": "1",
+
    status: "Official",
                    "length": 974546,
+
    quality: "normal",
                    "title": "æ³o",
+
    text-representation: {
                    "recording": { /* recording data omitted for this example. */ },
+
      language: "eng",
                    "artist-credit": [ /* as on release, not repeated in this example. */ ]
+
      script: "Latn"
                }
+
    },
            ]
+
    asin: null,
        },
+
    media: [
        {
+
      {
            "track-offset": 0,
+
        discs: [
            "track-count": 1,
+
          {
            "title": "h³æ",
+
            id: "nN2g3a0ZSjovyIgK3bJl6_.j8C4-",
            "format": "CD",
+
            sectors: 73241,
            "discids": [
+
            offsets: [150],
                { "id": "aSHvkMnq2jZVFEK.DmSPbvN_f54-", "sectors": 69341 }
+
            offset-count: 1
            ],
+
          }
            "tracks": [
+
        ],
                {
+
        position: 1,
                    "number": "1",
+
        title: "æ³o",
                    "length": 922546,
+
        format-id: "9712d52a-4509-3d4b-a1a2-67c88c643e31",
                    "title": "h³æ",
+
        format: "CD",
                    "recording": { /* recording data omitted for this example. */ },
+
        track-count: 1,
                    "artist-credit": [ /* as on release, not repeated in this example. */ ]
+
        track-offset: 0,
                }
+
        tracks: [
            ]
+
          {
        }
+
            id: "61af3e5a-14e0-350d-9826-a884c6e586b1",
    ],
+
            title: "æ³o",
    "barcode": null,
+
            length: 974546,
    "disambiguation": null,
+
            number: "1",
    "packaging": null,
+
            position: 1,
    "asin": null
+
            artist-credit: [
}
+
              {
</code>
+
                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
 +
    }
 +
  }
 +
</pre>
 +
</div>
 +
</div>
  
 
===Release Group===
 
===Release Group===
  
Request: http://musicbrainz.org/ws/2/release-group/c9fdb94c-4975-4ed6-a96f-ef6d80bb7738?inc=artist-credits+releases&fmt=json<br />
+
Request: http://musicbrainz.org/ws/2/release-group/c9fdb94c-4975-4ed6-a96f-ef6d80bb7738?inc=artist-credits+releases
Response:
+
 
 +
<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>
  
<code>
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 
  {
 
  {
     "id": "c9fdb94c-4975-4ed6-a96f-ef6d80bb7738",
+
     id: "c9fdb94c-4975-4ed6-a96f-ef6d80bb7738",
     "first-release-date": "2012-05-22",
+
     title: "The Lost Tape",
     "title": "The Lost Tape",
+
    first-release-date: "2012-05-22",
    "artist-credit": [
+
     artist-credit: [
 
         "name": "50 Cent",
 
         "name": "50 Cent",
 
         "joinphrase": "",
 
         "joinphrase": "",
Line 262: Line 1,095:
 
             "name": "50 Cent",
 
             "name": "50 Cent",
 
             "sort-name": "50 Cent",
 
             "sort-name": "50 Cent",
             "disambiguation": null
+
             "disambiguation": ""
 
         }
 
         }
 
     ],
 
     ],
     "primary-type": "Album",
+
     disambiguation: null,
     "disambiguation": null,
+
    primary-type-id: "f529b476-6e62-324f-b0aa-1f3e33d313fc",
     "secondary-types": [ "Mixtape/Street" ],
+
    primary-type: "Album",
     "releases": [
+
     secondary-type-ids: ["15c1b1f5-d893-3375-a1db-e180c5ae15ed"]
 +
     secondary-types: [ "Mixtape/Street" ],
 +
     releases: [
 
         {
 
         {
 
             "id": "2ec84eb6-ab92-4ac3-9720-32ad84c34f11",
 
             "id": "2ec84eb6-ab92-4ac3-9720-32ad84c34f11",
 
             "title": "The Lost Tape",
 
             "title": "The Lost Tape",
             /* some properties omitted to keep this example shorter. */
+
             /* some properties omitted to keep this example shorter, see the release results for the full format */
 
         }
 
         }
 
     ]
 
     ]
}
+
  }
</code>
+
 
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
===URL===
 +
 
 +
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 style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    id: "46d8f693-52e4-4d03-936f-7ca8459019a7",
 +
    resource: "https://www.arvopart.ee/"
 +
  }
 +
</pre>
 +
</div>
 +
</div>
  
 
===Work===
 
===Work===
  
Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?fmt=json<br />
+
For works, you'll generally want to include at least artist-rels (for writers), as in the example below.
Response:
+
 
 +
Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?inc=artist-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#">
 +
  <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">
 +
  {
 +
    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
 +
      }
 +
    ]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
==Browse requests==
  
<code>
+
Request: http://musicbrainz.org/ws/2/release?label=47e718e1-7ee4-460c-b1cc-1192a841c6e5&offset=12&limit=2
{
+
 
    "id": "b1df2cf3-69a9-3bc0-be44-f71e79b27a22",
+
<div class="toccolours mw-collapsible mw-collapsed">
    "title": "HELLO! また会おうね",
+
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
    "language": "jpn",
+
<pre class="mw-collapsible-content">
    "iswcs": [ "T-101.690.320-9" ]
+
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
}
+
  <release-list count="106" offset="12">
</code>
+
    <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>
 +
</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">
 +
  {
 +
    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
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
==Relationships==
 +
You can find standard real-life examples of relationship requests above, under the lookup examples for Event and Work.
  
==Browse Requests==
+
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>.
  
Browse requests return a toplevel object with offset and count properties to
+
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
help with paging, and a property for the requested entity.
 
The key for this property will be the english plural of the entity, so:
 
artists, labels, recordings, releases, release-groups or works.
 
  
Request: http://musicbrainz.org/ws/2/release?label=47e718e1-7ee4-460c-b1cc-1192a841c6e5&offset=12&limit=2&fmt=json<br />
+
<div class="toccolours mw-collapsible mw-collapsed">
Response:
+
<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="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>
 +
</pre>
 +
</div>
 +
</div>
  
<code>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
    "releases": [
+
<pre class="mw-collapsible-content">
         {
+
  {
            "id": "0b405ea7-8785-402f-bcf7-d55f5000dc3e",
+
    id: "987f3e2d-22a6-4a4f-b840-c80c26b8b91a",
            "title": "Wintertunes"
+
    title: "Become Desert",
            /* some properties omitted to keep this example shorter. */
+
    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
             "id": "7eb37a3a-646d-4501-a373-e9071186b88d",
+
      }
            "title": "Adventure Magic Supreme Journey Music"
+
    ],
            /* some properties omitted to keep this example shorter. */
+
    barcode: null,
        }
+
    status-id: "4e304316-386d-3409-af2e-78857eec5cfe",
    ],
+
    status: "Official",
    "release-offset": 12,
+
    packaging-id: "119eba76-b343-3e02-a292-f0f00644bb9b",
    "release-count": 48
+
    packaging: "None",
}
+
    quality: "normal",
</code>
+
    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
 +
    }
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
 
 +
See below for an example of a relationship with relationship attributes (in this case, the work is part of a work catalogue series, and it is assigned a specific number for that series, stored as an attribute):
 +
 +
Request: https://musicbrainz.org/ws/2/work/c1b0e8a2-2461-4d48-9a89-f4e6d624d342?inc=series-rels
  
==Relationships==
+
<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#">
 +
  <work id="c1b0e8a2-2461-4d48-9a89-f4e6d624d342" type="Symphony" type-id="174314aa-0aa4-30cf-96a6-50b281d8d208">
 +
    <title>Sinfonie Nr. 1 c-Moll, op. 68</title>
 +
    <language>zxx</language>
 +
    <language-list>
 +
      <language>zxx</language>
 +
    </language-list>
 +
    <attribute-list>
 +
      <attribute value-id="d3d0b554-d3f4-3995-b995-5113f3771295" type="Key" type-id="7526c19d-3be4-3420-b6cc-9fb6e49fa1a9">C minor</attribute>
 +
    </attribute-list>
 +
    <relation-list target-type="series">
 +
      <relation type="part of" type-id="b0d44366-cdf0-3acb-bee6-0f65a77a6ef0">
 +
        <target>03531d5b-11e8-40c9-9fc3-d814e9886590</target>
 +
        <ordering-key>114</ordering-key>
 +
        <direction>backward</direction>
 +
        <attribute-list>
 +
          <attribute type-id="a59c5830-5ec7-38fe-9a21-c7ea54f6650a" value="op. 68">number</attribute>
 +
        </attribute-list>
 +
        <series id="03531d5b-11e8-40c9-9fc3-d814e9886590" type="Catalogue" type-id="49482ff0-fc9e-3b8c-a2d0-30e84d9df002">
 +
          <name>Johannes Brahms. Thematisch-Bibliographisches Werkverzeichnis</name>
 +
        </series>
 +
      </relation>
 +
    </relation-list>
 +
  </work>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
Request: http://musicbrainz.org/ws/2/release/275b01eb-8551-47ff-bd6b-2d142b4bf422?inc=url-rels&fmt=json<br />
+
<div class="toccolours mw-collapsible mw-collapsed">
Response:
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
{
 +
  id: "c1b0e8a2-2461-4d48-9a89-f4e6d624d342",
 +
  title: "Sinfonie Nr. 1 c-Moll, op. 68"
 +
  type-id: "174314aa-0aa4-30cf-96a6-50b281d8d208",
 +
  type: "Symphony",
 +
  disambiguation: "",
 +
  language: "zxx",
 +
  languages: ["zxx"],
 +
  iswcs: [],
 +
  attributes: [
 +
    {
 +
      value-id: "d3d0b554-d3f4-3995-b995-5113f3771295",
 +
      type-id: "7526c19d-3be4-3420-b6cc-9fb6e49fa1a9",
 +
      type: "Key",
 +
      value: "C minor",
 +
    }
 +
  ],
 +
  relations: [
 +
    {
 +
      direction: "backward",
 +
      target-credit: "",
 +
      type-id: "b0d44366-cdf0-3acb-bee6-0f65a77a6ef0",
 +
      source-credit: "",
 +
      begin: null,
 +
      target-type: "series",
 +
      ended: false,
 +
      series: {
 +
        type: "Catalogue",
 +
        type-id: "49482ff0-fc9e-3b8c-a2d0-30e84d9df002",
 +
        disambiguation: "",
 +
        id: "03531d5b-11e8-40c9-9fc3-d814e9886590",
 +
        name: "Johannes Brahms. Thematisch-Bibliographisches Werkverzeichnis"
 +
      },
 +
      attribute-ids: {
 +
        number: "a59c5830-5ec7-38fe-9a21-c7ea54f6650a"
 +
      },
 +
      attributes: [
 +
        "number"
 +
      ],
 +
      ordering-key: 114,
 +
      type: "part of",
 +
      attribute-values: {
 +
        number: "op. 68"
 +
      },
 +
      end: null
 +
    }
 +
  ],
 +
}
 +
</pre>
 +
</div>
 +
</div>
  
<code>
+
== Genres, tags and ratings ==
{
 
    "id": "275b01eb-8551-47ff-bd6b-2d142b4bf422",
 
    "title": "Kraftwerk Kover Kollection, Volume 1",
 
    "quality": "normal",
 
    "text-representation": { "language": "eng", "script": "Latn" },
 
    "date": "2012",
 
    "relations": [
 
        {
 
            "direction": "backward",
 
            "type": "download for free",
 
            "url": "http://soundcloud.com/strictly/kraftwerk-kover-kollection-vol"
 
        }
 
    ],
 
    "country": null,
 
    "status": null,
 
    "barcode": null,
 
    "disambiguation": null,
 
    "packaging": null,
 
    "asin": null
 
}
 
</code>
 
  
Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?inc=artist-rels+recording-rels&fmt=json<br />
+
You can include ''genres'', ''tags'' and ''ratings'' to get this secondary data. Below is an example of a request including all of the three.
Response:
 
  
<code>
+
Request: http://musicbrainz.org/ws/2/artist/db92a151-1ac2-438b-bc43-b82e149ddd50?inc=aliases+genres+tags+ratings
{
 
  "id": "b1df2cf3-69a9-3bc0-be44-f71e79b27a22",
 
  "title": "HELLO! また会おうね",
 
  "language": "jpn",
 
  "iswcs": [ "T-101.690.320-9" ],
 
  "relations": [
 
        {
 
            "direction": "backward",
 
            "type": "composer",
 
            "artist": {
 
                "id": "d997d399-355e-4c49-9c7b-75a93d76bc0e",
 
                "name": "つんく♂",
 
                "sort-name": "Tsunku",
 
                "disambiguation": null
 
            }
 
        },
 
        {
 
            "direction": "backward",
 
            "type": "lyricist",
 
            "artist": {
 
                "id": "d997d399-355e-4c49-9c7b-75a93d76bc0e",
 
                "name": "つんく♂",
 
                "sort-name": "Tsunku",
 
                "disambiguation": null
 
            }
 
        },
 
        {
 
            "direction": "backward",
 
            "type": "performance",
 
            "recording": {
 
                "id": "487cac92-eed5-4efa-8563-c9a818079b9a",
 
                "title": "HELLO! また会おうね (7人祭 version)",
 
                "length": 283600,
 
                "disambiguation": null
 
            }
 
        },
 
        {
 
            "type": "performance",
 
            "direction": "backward",
 
            "recording": {
 
                "id": "fd3061c1-cb9a-4698-bc5f-f6e0e6a36272",
 
                "title": "HELLO! また会おうね (20人祭 version)",
 
                "length": 283600,
 
                "disambiguation": "PV"
 
            }
 
        }
 
    ]
 
}
 
  
==External Links==
+
<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="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>
  
View or parse JSON data in a spreadsheet using a [https://json-csv.com JSON to CSV] converter.
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    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
 +
    }
 +
  }
 +
</pre>
 +
</div>
 +
</div>

Latest revision as of 19:51, 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
    }
  }


See below for an example of a relationship with relationship attributes (in this case, the work is part of a work catalogue series, and it is assigned a specific number for that series, stored as an attribute):

Request: https://musicbrainz.org/ws/2/work/c1b0e8a2-2461-4d48-9a89-f4e6d624d342?inc=series-rels

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <work id="c1b0e8a2-2461-4d48-9a89-f4e6d624d342" type="Symphony" type-id="174314aa-0aa4-30cf-96a6-50b281d8d208">
    <title>Sinfonie Nr. 1 c-Moll, op. 68</title>
    <language>zxx</language>
    <language-list>
      <language>zxx</language>
    </language-list>
    <attribute-list>
      <attribute value-id="d3d0b554-d3f4-3995-b995-5113f3771295" type="Key" type-id="7526c19d-3be4-3420-b6cc-9fb6e49fa1a9">C minor</attribute>
    </attribute-list>
    <relation-list target-type="series">
      <relation type="part of" type-id="b0d44366-cdf0-3acb-bee6-0f65a77a6ef0">
        <target>03531d5b-11e8-40c9-9fc3-d814e9886590</target>
        <ordering-key>114</ordering-key>
        <direction>backward</direction>
        <attribute-list>
          <attribute type-id="a59c5830-5ec7-38fe-9a21-c7ea54f6650a" value="op. 68">number</attribute>
        </attribute-list>
        <series id="03531d5b-11e8-40c9-9fc3-d814e9886590" type="Catalogue" type-id="49482ff0-fc9e-3b8c-a2d0-30e84d9df002">
          <name>Johannes Brahms. Thematisch-Bibliographisches Werkverzeichnis</name>
        </series>
      </relation>
    </relation-list>
  </work>
</metadata>
JSON Response
{
  id: "c1b0e8a2-2461-4d48-9a89-f4e6d624d342",
  title: "Sinfonie Nr. 1 c-Moll, op. 68"
  type-id: "174314aa-0aa4-30cf-96a6-50b281d8d208",
  type: "Symphony",
  disambiguation: "",
  language: "zxx",
  languages: ["zxx"],
  iswcs: [],
  attributes: [
    {
      value-id: "d3d0b554-d3f4-3995-b995-5113f3771295",
      type-id: "7526c19d-3be4-3420-b6cc-9fb6e49fa1a9",
      type: "Key",
      value: "C minor",
    }
  ],
  relations: [
    {
      direction: "backward",
      target-credit: "",
      type-id: "b0d44366-cdf0-3acb-bee6-0f65a77a6ef0",
      source-credit: "",
      begin: null,
      target-type: "series",
      ended: false,
      series: {
        type: "Catalogue",
        type-id: "49482ff0-fc9e-3b8c-a2d0-30e84d9df002",
        disambiguation: "",
        id: "03531d5b-11e8-40c9-9fc3-d814e9886590",
        name: "Johannes Brahms. Thematisch-Bibliographisches Werkverzeichnis"
      },
      attribute-ids: {
        number: "a59c5830-5ec7-38fe-9a21-c7ea54f6650a"
      },
      attributes: [
        "number"
      ],
      ordering-key: 114,
      type: "part of",
      attribute-values: {
        number: "op. 68"
      },
      end: null
    }
  ],
}

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
    }
  }