Search Server

From MusicBrainz Wiki
Jump to navigationJump to search

Search queries on musicbrainz.org are handled by an Apache Lucene server. This search server also handles searches performed on the web service and uses Lucene indexes in either case to return its results.

The MusicBrainz XML Meta Data (MMD schema) is used to determine the output returned from the search server.

Most mirror installations of MusicBrainz Server can simply use our public search server rather than setting up their own. For those curious, however, the search server code is available from our Subversion server at http://bugs.musicbrainz.org/browser/search_server.

Query parameters

Some of the entities provided by the Search Server are currently only returned by the webpage and not the web service, these are annotation, tags, cdstubs and freedb.

This sections lists the parameters common to all resource.

type Selects the index to be searched, artist, release, release-group, recording, work, label (track is supported but maps to recording)
format Selects the representation of the resource. Defaults to xml, but can also be json (for parsing to html)
query Lucene search query, this is mandatory. See Lucene Search Syntax.
limit An integer value defining how many entries should be returned. Only values between 1 and 100 (both inclusive) are allowed. If not given, this defaults to 25.
offset Return search results starting at a given offset. Used for paging through more than one page of results.
version MMD version, defaults to 2, can be set to 1 for backwards compatibility.

Annotation

Example: http://musicbrainz.org/ws/2/annotation/?query=entity:bdb24cb5-404b-4f60-bba4-7b730325ae47

Search Fields

The Annotation index contains the following fields you can search

Field Description
entity the annotated entity's MBID
id the numeric ID of the annotation (e.g. 703027)
name the annotated entity's name or title (diacritics are ignored)
text the annotation's content (includes wiki formatting)
type the annotated entity's entity type

If you don't specify a field, the terms will be searched for in the name, text and type fields.

Xml

<metadata created="2013-02-05T04:41:32.273Z" xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
    <annotation-list count="1" offset="0">
        <annotation type="release" ext:score="100">
            <entity>bdb24cb5-404b-4f60-bba4-7b730325ae47</entity>
            <name>Pieds nus sur la braise</name>
            <text>Lyrics and music by Merzhin except:
04, 08, 09, 10 (V. L'hour - Merzhin),
03 (V. L'hour - P. Le Bourdonnec - Merzhin),
05 & 13 (P. Le Bourdonnec - Merzhin),
06 ([http://musicbrainz.org/artist/38cfa519-21bb-4e79-8388-3bf798b8c076.html|JM. Poisson] - Merzhin),
07 ([http://musicbrainz.org/artist/f2d7c07c-a8e7-45c9-a888-0b2e6e3a240d.html|Ignatus] - V. L'hour - Merzhin),
11 ([http://musicbrainz.org/artist/f2d7c07c-a8e7-45c9-a888-0b2e6e3a240d.html|Ignatus] - Merzhin),
12 ([http://musicbrainz.org/artist/38cfa519-21bb-4e79-8388-3bf798b8c076.html|JM. Poisson]).</text>
        </annotation>
    </annotation-list>
</metadata>

Json

{

    "created": "2013-02-05T04:41:32.273Z",
    "annotation-list": {
        "count": 1,
        "offset": 0,
        "annotation": [
            {
                "type": "release",
                "score": "100",
                "entity": "bdb24cb5-404b-4f60-bba4-7b730325ae47",
                "name": "Pieds nus sur la braise",
                "text": "Lyrics and music by Merzhin except:\r\n
04, 08, 09, 10 (V. L'hour - Merzhin),\r\n
03(V. L'hour - P. Le Bourdonnec - Merzhin),\r\n05 & 13 (P. Le Bourdonnec - Merzhin),\r\n
06 ([http://musicbrainz.org/artist/38cfa519-21bb-4e79-8388-3bf798b8c076.html|JM. Poisson] - Merzhin),\r\n
07 ([http://musicbrainz.org/artist/f2d7c07c-a8e7-45c9-a888-0b2e6e3a240d.html|Ignatus] - V. L'hour - Merzhin),\r\n
11 ([http://musicbrainz.org/artist/f2d7c07c-a8e7-45c9-a888-0b2e6e3a240d.html|Ignatus] - Merzhin),\r\n
12 ([http://musicbrainz.org/artist/38cfa519-21bb-4e79-8388-3bf798b8c076.html|JM. Poisson])."
            }
        ]
    }

}

Artist

Example

http://musicbrainz.org/ws/2/artist/?query=artist:fred%20AND%20type:group%20AND%20country:US

Search Fields

The Artist index contains the following fields you can search

Field Description
alias (part of) any alias attached to the artist (diacritics are ignored)
primary_alias (part of) any primary alias attached to the artist (diacritics are ignored)
area (part of) the name of the artist's main associated area
arid the artist's MBID
artist (part of) the artist's name (diacritics are ignored)
artistaccent (part of) the artist's name (with the specified diacritics)
begin the artist's begin date (e.g. "1980-01-22")
beginarea (part of) the name of the artist's begin area
comment (part of) the artist's disambiguation comment
country the 2-letter code (ISO 3166-1 alpha-2) for the artist's main associated country
end the artist's end date (e.g. "1980-01-22")
endarea (part of) the name of the artist's end area
ended a boolean flag (true/false) indicating whether or not the artist has ended (is dissolved/deceased)
gender the artist's gender (“male”, “female”, “other” or “not applicable”)
ipi an IPI code associated with the artist
isni an ISNI code associated with the artist
sortname (part of) the artist's sort name
tag (part of) a tag attached to the artist
type the artist's type (“person”, “group”, etc.)

If you don't specify a field, the terms will be searched for in the alias, artist and sortname fields.

Xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metadata created="2017-03-12T16:54:57.165Z" xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
  <artist-list count="11" offset="0">
    <artist id="e56fd97e-c18f-4e5e-9b4d-f9fc21b4973f" type="Group" ext:score="100">
      <name>Fred</name>
      <sort-name>Fred</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <begin-area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </begin-area>
      <disambiguation>US progressive rock band</disambiguation>
      <life-span>
        <begin>1969</begin>
        <end>1974</end>
        <ended>true</ended>
      </life-span>
    </artist>
    <artist id="4a024fd4-305e-4fea-9d3f-4ec858766e6e" type="Group" ext:score="100">
      <name>Fred</name>
      <sort-name>Fred</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <disambiguation>US comic barbershop quartet</disambiguation>
      <life-span>
        <ended>false</ended>
      </life-span>
    </artist>
    <artist id="1065e6e0-b6b3-4224-9121-4502e52b9f9e" type="Group" ext:score="61">
      <name>A Halo Called Fred</name>
      <sort-name>A Halo Called Fred</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <life-span>
        <ended>false</ended>
      </life-span>
    </artist>
    <artist id="6c843bf3-a854-47ea-b1cf-ba40675710b7" type="Group" ext:score="61">
      <name>Fred Sherry String Quartet</name>
      <sort-name>Fred Sherry String Quartet</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <life-span>
        <ended>false</ended>
      </life-span>
    </artist>
    <artist id="be136e58-ccf5-47f0-a000-6e8d7eb3bae0" type="Group" ext:score="61">
      <name>The Color Fred</name>
      <sort-name>Color Fred, The</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <life-span>
        <begin>2003</begin>
        <ended>false</ended>
      </life-span>
    </artist>
    <artist id="2cea1456-daef-4bb1-b63c-4b6df03ebbd5" type="Group" ext:score="61">
      <name>The Fred Hersch Group</name>
      <sort-name>Hersch, Fred, The, Group</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <life-span>
        <ended>false</ended>
      </life-span>
    </artist>
    <artist id="28b020fa-d9b8-4d92-805c-54cd1b0197b7" type="Group" ext:score="61">
      <name>Jacob Fred Jazz Odyssey</name>
      <sort-name>Jacob Fred Jazz Odyssey</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <life-span>
        <begin>1994</begin>
        <ended>false</ended>
      </life-span>
      <alias-list>
        <alias sort-name="JFJO">JFJO</alias>
      </alias-list>
      <tag-list>
        <tag count="1">
          <name>jazz</name>
        </tag>
        <tag count="1">
          <name>jazz fusion</name>
        </tag>
        <tag count="1">
          <name>free jazz</name>
        </tag>
        <tag count="1">
          <name>oklahoma</name>
        </tag>
        <tag count="1">
          <name>us</name>
        </tag>
        <tag count="1">
          <name>tulsa</name>
        </tag>
      </tag-list>
    </artist>
    <artist id="4a903390-4381-4c32-90d0-803bd4f9ce34" type="Group" ext:score="56">
      <name>Fred Waring & His Pennsylvanians</name>
      <sort-name>Waring, Fred & His Pennsylvanians</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <life-span>
        <ended>false</ended>
      </life-span>
      <alias-list>
        <alias sort-name="Fred Waring and the Pennsylvanians">Fred Waring and the Pennsylvanians</alias>
        <alias sort-name="Fred Waring & Pennsylvanians">Fred Waring & Pennsylvanians</alias>
        <alias sort-name="Fred Waring's Pennsylvanians">Fred Waring's Pennsylvanians</alias>
        <alias sort-name="Fred Waring's Pennyslvanians">Fred Waring's Pennyslvanians</alias>
        <alias sort-name="Fred Waring & the Pennsylvanians">Fred Waring & the Pennsylvanians</alias>
        <alias sort-name="Waring, Fred & Pennsylvanians, The">Fred Waring & The Pennsylvanians</alias>
        <alias sort-name="Fred Warring & His Pennsylvanians">Fred Warring & His Pennsylvanians</alias>
        <alias sort-name="Waring's Pensylvanians">Waring's Pensylvanians</alias>
      </alias-list>
    </artist>
    <artist id="0980008b-f9cd-412e-b062-84212b756f4a" type="Group" ext:score="51">
      <name>Fred Williams & The Jewels Band</name>
      <sort-name>Williams, Fred & Jewels Band, The</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <life-span>
        <ended>false</ended>
      </life-span>
    </artist>
    <artist id="985bdbe7-ebf2-42b1-8ad6-5bb619385e67" type="Group" ext:score="51">
      <name>Fred Wesley and The J.B.’s</name>
      <sort-name>Wesley, Fred and J.B.’s, the</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <life-span>
        <ended>false</ended>
      </life-span>
      <alias-list>
        <alias sort-name="Fred and the New J.B.'s">Fred and the New J.B.'s</alias>
        <alias sort-name="Fred Wesley & The J.B.'s">Fred Wesley & The J.B.'s</alias>
        <alias sort-name="Fred Wesley & The JB's">Fred Wesley & The JB's</alias>
        <alias sort-name="Fred Wesley & The New J.B.'s">Fred Wesley & The New J.B.'s</alias>
        <alias sort-name="Fred Wesley & The New JB's">Fred Wesley & The New JB's</alias>
      </alias-list>
    </artist>
    <artist id="05cfb5c7-0152-41f4-a9c9-622e8f710dfa" type="Group" ext:score="51">
      <name>John Fred & His Playboy Band</name>
      <sort-name>Fred, John & His Playboy Band</sort-name>
      <country>US</country>
      <area id="489ce91b-6658-3307-9877-795b68554c98">
        <name>United States</name>
        <sort-name>United States</sort-name>
      </area>
      <begin-area id="34f02dc4-3173-4c68-86d1-c82504759342">
        <name>Baton Rouge</name>
        <sort-name>Baton Rouge</sort-name>
      </begin-area>
      <life-span>
        <begin>1956</begin>
        <end>1969</end>
        <ended>true</ended>
      </life-span>
      <alias-list>
        <alias sort-name="John Fred">John Fred</alias>
        <alias sort-name="John Fred and His Playboyband">John Fred and His Playboyband</alias>
        <alias sort-name="John Fred and His Play Boy Band">John Fred and His Play Boy Band</alias>
        <alias sort-name="John Fred And His Playboy Band">John Fred And His Playboy Band</alias>
        <alias sort-name="John Fred and His Playboys">John Fred and His Playboys</alias>
        <alias sort-name="John Fred and the Play Boy Band">John Fred and the Play Boy Band</alias>
        <alias sort-name="John Fred and the Playboys">John Fred and the Playboys</alias>
        <alias sort-name="John Fred & His Playboyband">John Fred & His Playboyband</alias>
        <alias sort-name="John Fred & His Playboys">John Fred & His Playboys</alias>
        <alias sort-name="John Fred & Hiss Playboy Band">John Fred & Hiss Playboy Band</alias>
        <alias sort-name="John Fred & Playboyband">John Fred & Playboyband</alias>
        <alias sort-name="John Fred & Playboy Band">John Fred & Playboy Band</alias>
        <alias sort-name="John Fred & the Play Boy Band">John Fred & the Play Boy Band</alias>
        <alias sort-name="John Fred & The Playboyband">John Fred & The Playboyband</alias>
        <alias sort-name="John Fred & The Playboy Band">John Fred & The Playboy Band</alias>
        <alias sort-name="John Fred & The Playboys">John Fred & The Playboys</alias>
      </alias-list>
    </artist>
  </artist-list>
</metadata>

CDStubs

Example

http://musicbrainz.org/ws/2/cdstub/?query=title:Doo

Search Fields

The CD stub index contains the following fields you can search:

Field Description
added the date the CD stub was added (e.g. "2020-01-22")
artist (part of) the artist name set on the CD stub
barcode the barcode set on the CD stub
comment (part of) the comment set on the CD stub
discid the CD stub's Disc ID
title (part of) the release title set on the CD stub
tracks the number of tracks on the CD stub

If you don't specify a field, the terms will be searched for in the artist and title fields.

Xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metadata created="2013-02-05T08:20:53.231Z" xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
    <cdstub-list count="1" offset="0">
        <cdstub id="NKpg6j_S6swmiKYEYsFhYrSwgQA-" ext:score="100">
            <title>Stupid Doo Doo Dumb</title>
            <artist>Mac Dre</artist>
            <barcode>618763105025</barcode>
            <comment>CD Baby id:macdremusic5</comment>
            <track-list count="15"/>
        </cdstub>
    </cdstub-list>
</metadata>

Json

{
    "created": "2017-02-14T11:00:32.046Z",
    "count": 53,
    "offset": 0,
    "cdstubs": [
        {
            "id": "NKpg6j_S6swmiKYEYsFhYrSwgQA-",
            "score": "100",
            "count": 15,
            "title": "Stupid Doo Doo Dumb",
            "artist": "Mac Dre",
            "barcode": "618763105025",
            "comment": "CD Baby id:macdremusic5"
        }
    ]
}


Freedb

Label

Example

http://musicbrainz.org/ws/2/label/?query=%22Devil's%20Records%22

Search Fields

The Label index contains the following fields you can search

Field Description
alias (part of) any alias attached to the label (diacritics are ignored)
area (part of) the name of the label's main associated area
begin the label's begin date (e.g. "1980-01-22")
code the label code for the label (only the numbers, without "LC")
comment (part of) the label's disambiguation comment
country the 2-letter code (ISO 3166-1 alpha-2) for the label's associated country
end the label's end date (e.g. "1980-01-22")
ended a boolean flag (true/false) indicating whether or not the label has ended (is dissolved)
ipi an IPI code associated with the label
isni an ISNI code associated with the label
label (part of) the label's name (diacritics are ignored)
labelaccent (part of) the label's name (with the specified diacritics)
laid the label's MBID
release_count the amount of releases related to the label
sortname equivalent to name (labels no longer have separate sort names)
tag (part of) a tag attached to the label
type the label's type

If you don't specify a field, the terms will be searched for in the alias and label fields.

Xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metadata created="2017-03-12T16:59:29.160Z" xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
  <label-list count="1" offset="0">
    <label id="d2c296e3-10a4-4ba9-97b9-5620ff8a3ce0" type="Original Production" ext:score="100">
      <name>Devil's Records</name>
      <sort-name>Devil's Records</sort-name>
      <country>FR</country>
      <area id="08310658-51eb-3801-80de-5a0739207115">
        <name>France</name>
        <sort-name>France</sort-name>
      </area>
      <life-span>
        <ended>false</ended>
      </life-span>
      <alias-list>
        <alias sort-name="Devil Records">Devil Records</alias>
        <alias sort-name="Devils Records">Devils Records</alias>
      </alias-list>
    </label>
  </label-list>
</metadata>

Release Group

Example

http://musicbrainz.org/ws/2/release-group/?query=release:Tenance

Search Fields

The release group index contains the following fields you can search:

Field Description
alias (part of) any alias attached to the release group (diacritics are ignored)
arid the MBID of any of the release group artists
artist (part of) the combined credited artist name for the release group, including join phrases (e.g. "Artist X feat.")
artistname (part of) the name of any of the release group artists
comment (part of) the release group's disambiguation comment
creditname (part of) the credited name of any of the release group artists on this particular release group
firstreleasedate the release date of the earliest release in this release group (e.g. "1980-01-22")
primarytype the primary type of the release group
reid the MBID of any of the releases in the release group
release (part of) the title of any of the releases in the release group
releasegroup (part of) the release group's title (diacritics are ignored)
releasegroupaccent (part of) the release group's title (with the specified diacritics)
releases the number of releases in the release group
rgid the release group's MBID
secondarytype any of the secondary types of the release group
status the status of any of the releases in the release group
tag (part of) a tag attached to the release group
type legacy release group type field that predates the ability to set multiple types (see calculation code)

If you don't specify a field, the terms will be searched for in the releasegroup field.

Xml

<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
      <release-group-list offset="0" count="1">
          <release-group ext:score="100" type="Single" id="70664047-2545-4e46-b75f-4556f2a7b83e">
              <title>Main Tenance</title>
              <first-release-date>1998</first-release-date>
              <artist-credit>
                  <name-credit> 
                      <artist id="a8fa58d8-f60b-4b83-be7c-aea1af11596b">
                          <name>Fred Giannelli</name>
                          <sort-name>Giannelli, Fred</sort-name>
                          <disambiguation>US electronic artist</disambiguation>
                      </artist>
                  </name-credit>
              </artist-credit>
              <release-list count="1">
                  <release id="9168f4cc-a852-4ba5-bf85-602996625651">
                      <title>Main Tenance</title>
                  </release>
              </release-list>
          </release-group>
    </release-group-list>
</metadata>

Release

Example

http://musicbrainz.org/ws/2/release/?query=release:Schneider%20AND%20Shake

Search Fields

The Release index contains the following fields you can search

Field Description
alias (part of) any alias attached to the release (diacritics are ignored)
arid the MBID of any of the release artists
artist (part of) the combined credited artist name for the release, including join phrases (e.g. "Artist X feat.")
artistname (part of) the name of any of the release artists
asin an Amazon ASIN for the release
barcode the barcode for the release
catno any catalog number for this release (insensitive to case, spaces, and separators)
comment (part of) the release's disambiguation comment
country the 2-letter code (ISO 3166-1 alpha-2) for any country the release was released in
creditname (part of) the credited name of any of the release artists on this particular release
date a release date for the release (e.g. "1980-01-22")
discids the total number of disc IDs attached to all mediums on the release
discidsmedium the number of disc IDs attached to any one medium on the release
format the format of any medium in the release (insensitive to case, spaces, and separators)
laid the MBID of any of the release labels
label (part of) the name of any of the release labels
lang the ISO 639-3 code for the release language
mediums the number of mediums on the release
packaging the format of the release (insensitive to case, spaces, and separators)
primarytype the primary type of the release group for this release
quality the listed quality of the data for the release (2 for “high”, 1 for “normal”; cannot search for “low” at the moment; see the related bug report)
reid the release's MBID
release (part of) the release's title (diacritics are ignored)
releaseaccent (part of) the release's title (with the specified diacritics)
rgid the MBID of the release group for this release
script the ISO 15924 code for the release script
secondarytype any of the secondary types of the release group for this release
status the status of the release
tag (part of) a tag attached to the release
tracks the total number of tracks on the release
tracksmedium the number of tracks on any one medium on the release
type legacy release group type field that predates the ability to set multiple types (see calculation code)

If you don't specify a field, the terms will be searched for in the release field.

Xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metadata created="2017-03-12T17:20:00.235Z" xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
  <release-list count="1" offset="0">
    <release id="62d1c4ef-fc00-37af-8df7-485f6a31fcc4" ext:score="100">
      <title>Fred Schneider & The Shake Society</title>
      <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
      <packaging>Cardboard/Paper Sleeve</packaging>
      <text-representation>
        <language>eng</language>
        <script>Latn</script>
      </text-representation>
      <artist-credit>
        <name-credit>
          <artist id="43bcca8b-9edc-4997-8343-122350e790bf">
            <name>Fred Schneider</name>
            <sort-name>Schneider, Fred</sort-name>
            <alias-list>
              <alias sort-name="Schneider, Frederick William" type="Legal name">Frederick William Schneider</alias>
              <alias sort-name="Fred Schneider & the Shake Society">Fred Schneider & the Shake Society</alias>
            </alias-list>
          </artist>
        </name-credit>
      </artist-credit>
      <release-group id="0ef97d52-3f00-31bf-8413-f83ccb362675" type="Album">
        <primary-type>Album</primary-type>
      </release-group>
      <date>1984</date>
      <country>US</country>
      <release-event-list>
        <release-event>
          <date>1984</date>
          <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>
        </release-event>
      </release-event-list>
      <barcode>07599251581</barcode>
      <label-info-list>
        <label-info>
          <catalog-number>1-25158</catalog-number>
          <label id="c595c289-47ce-4fba-b999-b87503e8cb71">
            <name>Warner Bros. Records</name>
          </label>
        </label-info>
      </label-info-list>
      <medium-list count="1">
        <track-count>9</track-count>
        <medium>
          <format>12" Vinyl</format>
          <disc-list count="0"/>
          <track-list count="9"/>
        </medium>
      </medium-list>
    </release>
  </release-list>
</metadata>

Recording

Example

http://musicbrainz.org/ws/2/recording/?query=isrc:GBAHT1600302

Search Fields

The Recording index contains the following fields you can search

Field Description
alias (part of) any alias attached to the recording (diacritics are ignored)
arid the MBID of any of the recording artists
artist (part of) the combined credited artist name for the recording, including join phrases (e.g. "Artist X feat.")
artistname (part of) the name of any of the recording artists
comment (part of) the recording's disambiguation comment
country the 2-letter code (ISO 3166-1 alpha-2) for the country any release of this recording was released in
creditname (part of) the credited name of any of the recording artists on this particular recording
date the release date of any release including this recording (e.g. "1980-01-22")
dur the recording duration in milliseconds
firstreleasedate the release date of the earliest release including this recording (e.g. "1980-01-22")
format the format of any medium including this recording (insensitive to case, spaces, and separators)
isrc any ISRC associated to the recording
number the free-text number of the track on any medium including this recording (e.g. "A4")
position the position inside its release of any medium including this recording (starts at 1)
primarytype the primary type of any release group including this recording
qdur the recording duration, quantized (duration in milliseconds / 2000)
recording (part of) the recording's name, or the name of a track connected to this recording (diacritics are ignored)
recordingaccent (part of) the recordings's name, or the name of a track connected to this recording (with the specified diacritics)
reid the MBID of any release including this recording
release (part of) the name of any release including this recording
rgid the MBID of any release group including this recording
rid the recording's MBID
secondarytype any of the secondary types of any release group including this recording
status the status of any release including this recording
tag (part of) a tag attached to the recording
tid the MBID of a track connected to this recording
tnum the position of the track on any medium including this recording (starts at 1, pre-gaps at 0)
tracks the number of tracks on any medium including this recording
tracksrelease the number of tracks on any release (as a whole) including this recording
type legacy release group type field that predates the ability to set multiple types (see calculation code)
video a boolean flag (true/false) indicating whether or not the recording is a video recording

If you don't specify a field, the terms will be searched for in the recording field.

Xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metadata created="2017-02-23T14:31:36.889Z" xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
  <recording-list count="1" offset="0">
    <recording id="026fa041-3917-4c73-9079-ed16e36f20f8" ext:score="100">
      <title>Blow Your Mind (Mwah)</title>
      <length>178000</length>
      <artist-credit>
        <name-credit>
          <artist id="6f1a58bf-9b1b-49cf-a44a-6cefad7ae04f">
            <name>Dua Lipa</name>
            <sort-name>Lipa, Dua</sort-name>
          </artist>
        </name-credit>
      </artist-credit>
      <first-release-date>2016-08-26</first-release-date>
      <release-list>
        <release id="383be31c-37a0-4e08-8cda-cbcbbc587ae5">
          <title>Blow Your Mind (Mwah)</title>
          <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
          <release-group id="4a45bfa5-eb1e-49eb-a20c-1021389b2121" type="Single">
            <primary-type>Single</primary-type>
          </release-group>
          <date>2016-08-26</date>
          <country>XW</country>
          <release-event-list>
            <release-event>
              <date>2016-08-26</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>
          <medium-list>
            <track-count>1</track-count>
            <medium>
              <position>1</position>
              <format>Digital Media</format>
              <track-list count="1" offset="0">
                <track id="0ef6e647-4aeb-438e-8c8a-50c22c511203">
                  <number>1</number>
                  <title>Blow Your Mind (Mwah)</title>
                  <length>179000</length>
                </track>
              </track-list>
            </medium>
          </medium-list>
        </release>
        <release id="8bd42e63-46cb-43e3-8294-c9c3b9793581">
          <title>Now That’s What I Call Music! 95</title>
          <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
          <artist-credit>
            <name-credit>
              <artist id="89ad4ac3-39f7-470e-963a-56509c546377">
                <name>Various Artists</name>
                <sort-name>Various Artists</sort-name>
              </artist>
            </name-credit>
          </artist-credit>
          <release-group id="071a007b-b9cf-4e22-8646-03c30fc8dd87" type="Compilation">
            <primary-type>Album</primary-type>
            <secondary-type-list>
              <secondary-type>Compilation</secondary-type>
            </secondary-type-list>
          </release-group>
          <date>2016-11-18</date>
          <country>GB</country>
          <release-event-list>
            <release-event>
              <date>2016-11-18</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>
          <medium-list>
            <track-count>45</track-count>
            <medium>
              <position>1</position>
              <format>Digital Media</format>
              <track-list count="45" offset="35">
                <track id="e43cfb2f-fdd3-40a7-9396-25c9435ca8cb">
                  <number>36</number>
                  <title>Blow Your Mind (Mwah)</title>
                  <length>178000</length>
                </track>
              </track-list>
            </medium>
          </medium-list>
        </release>
        <release id="72a240b0-ca08-4d35-a15d-c1eded21c0ce">
          <title>Now That’s What I Call Music! 95</title>
          <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
          <artist-credit>
            <name-credit>
              <artist id="89ad4ac3-39f7-470e-963a-56509c546377">
                <name>Various Artists</name>
                <sort-name>Various Artists</sort-name>
              </artist>
            </name-credit>
          </artist-credit>
          <release-group id="071a007b-b9cf-4e22-8646-03c30fc8dd87" type="Compilation">
            <primary-type>Album</primary-type>
            <secondary-type-list>
              <secondary-type>Compilation</secondary-type>
            </secondary-type-list>
          </release-group>
          <date>2016-11-18</date>
          <country>GB</country>
          <release-event-list>
            <release-event>
              <date>2016-11-18</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>
          <medium-list>
            <track-count>45</track-count>
            <medium>
              <position>2</position>
              <format>CD</format>
              <track-list count="24" offset="14">
                <track id="8c193afa-a867-46fb-8745-5168a8e16a75">
                  <number>15</number>
                  <title>Blow Your Mind (Mwah)</title>
                  <length>178213</length>
                </track>
              </track-list>
            </medium>
          </medium-list>
        </release>
        <release id="6313b666-6042-486b-b2aa-614e7542ff68">
          <title>Life Is Music 2016.2</title>
          <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
          <artist-credit>
            <name-credit>
              <artist id="89ad4ac3-39f7-470e-963a-56509c546377">
                <name>Various Artists</name>
                <sort-name>Various Artists</sort-name>
              </artist>
            </name-credit>
          </artist-credit>
          <release-group id="406d765d-c5ca-43e9-b268-a33878927ff5" type="Compilation">
            <primary-type>Album</primary-type>
            <secondary-type-list>
              <secondary-type>Compilation</secondary-type>
            </secondary-type-list>
          </release-group>
          <date>2016-12-02</date>
          <country>BE</country>
          <release-event-list>
            <release-event>
              <date>2016-12-02</date>
              <area id="5b8a5ee5-0bb3-34cf-9a75-c27c44e341fc">
                <name>Belgium</name>
                <sort-name>Belgium</sort-name>
                <iso-3166-1-code-list>
                  <iso-3166-1-code>BE</iso-3166-1-code>
                </iso-3166-1-code-list>
              </area>
            </release-event>
          </release-event-list>
          <medium-list>
            <track-count>39</track-count>
            <medium>
              <position>1</position>
              <format>CD</format>
              <track-list count="20" offset="7">
                <track id="7e93e73c-e8f2-4218-af5e-baae4ce98882">
                  <number>8</number>
                  <title>Blow Your Mind (Mwah)</title>
                  <length>177266</length>
                </track>
              </track-list>
            </medium>
          </medium-list>
        </release>
        <release id="b3a2bca0-faec-4e67-8cf3-fd3d01755a2d">
          <title>Hits 2016</title>
          <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
          <artist-credit>
            <name-credit>
              <artist id="89ad4ac3-39f7-470e-963a-56509c546377">
                <name>Various Artists</name>
                <sort-name>Various Artists</sort-name>
              </artist>
            </name-credit>
          </artist-credit>
          <release-group id="7678ff0a-9446-4d5f-b46e-56c84fc68654" type="Compilation">
            <primary-type>Album</primary-type>
            <secondary-type-list>
              <secondary-type>Compilation</secondary-type>
            </secondary-type-list>
          </release-group>
          <date>2016-12-23</date>
          <country>MX</country>
          <release-event-list>
            <release-event>
              <date>2016-12-23</date>
              <area id="3e08b2cd-69f3-317c-b1e4-e71be581839e">
                <name>Mexico</name>
                <sort-name>Mexico</sort-name>
                <iso-3166-1-code-list>
                  <iso-3166-1-code>MX</iso-3166-1-code>
                </iso-3166-1-code-list>
              </area>
            </release-event>
          </release-event-list>
          <medium-list>
            <track-count>23</track-count>
            <medium>
              <position>1</position>
              <format>Digital Media</format>
              <track-list count="23" offset="22">
                <track id="3b466997-8bda-410f-82aa-02b703c931c5">
                  <number>23</number>
                  <title>Blow Your Mind (Mwah)</title>
                  <length>178583</length>
                </track>
              </track-list>
            </medium>
          </medium-list>
        </release>
        <release id="d02cce98-98fe-430c-b3c9-951c94f4fb1d">
          <title>Now That's What I Call Music! 95</title>
          <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
          <artist-credit>
            <name-credit>
              <artist id="89ad4ac3-39f7-470e-963a-56509c546377">
                <name>Various Artists</name>
                <sort-name>Various Artists</sort-name>
              </artist>
            </name-credit>
          </artist-credit>
          <release-group id="071a007b-b9cf-4e22-8646-03c30fc8dd87" type="Compilation">
            <primary-type>Album</primary-type>
            <secondary-type-list>
              <secondary-type>Compilation</secondary-type>
            </secondary-type-list>
          </release-group>
          <date>2016-11-18</date>
          <country>GB</country>
          <release-event-list>
            <release-event>
              <date>2016-11-18</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>
          <medium-list>
            <track-count>45</track-count>
            <medium>
              <position>2</position>
              <format>CD</format>
              <track-list count="24" offset="14">
                <track id="4ae11ffe-5ac8-42ae-a321-1535136ff05c">
                  <number>15</number>
                  <title>Blow Your Mind (Mwah)</title>
                  <length>178213</length>
                </track>
              </track-list>
            </medium>
          </medium-list>
        </release>
        <release id="5496dc5f-a282-422e-b7c6-78575e5f7944">
          <title>Dua Lipa (Deluxe)</title>
          <status id="518ffc83-5cde-34df-8627-81bff5093d92">Promotion</status>
          <release-group id="abbc4905-c25f-4c67-8e2d-19329ec48b1f" type="Album">
            <primary-type>Album</primary-type>
          </release-group>
          <date>2017-06-02</date>
          <country>XW</country>
          <release-event-list>
            <release-event>
              <date>2017-06-02</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>
          <medium-list>
            <track-count>17</track-count>
            <medium>
              <position>1</position>
              <format>Digital Media</format>
              <track-list count="17" offset="5">
                <track id="a2fcb379-7638-4f27-b2e4-5242a69ed09c">
                  <number>6</number>
                  <title>Blow Your Mind (Mwah)</title>
                  <length>178000</length>
                </track>
              </track-list>
            </medium>
          </medium-list>
        </release>
        <release id="eb66eaa0-acb6-4317-91ea-ff65b7813ec0">
          <title>Dua Lipa</title>
          <status id="518ffc83-5cde-34df-8627-81bff5093d92">Promotion</status>
          <release-group id="abbc4905-c25f-4c67-8e2d-19329ec48b1f" type="Album">
            <primary-type>Album</primary-type>
          </release-group>
          <date>2017-06-02</date>
          <country>XW</country>
          <release-event-list>
            <release-event>
              <date>2017-06-02</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>
          <medium-list>
            <track-count>12</track-count>
            <medium>
              <position>1</position>
              <format>Digital Media</format>
              <track-list count="12" offset="5">
                <track id="b74b2a35-900a-446c-8a63-7a5b01c82a5e">
                  <number>6</number>
                  <title>Blow Your Mind (Mwah)</title>
                  <length>178000</length>
                </track>
              </track-list>
            </medium>
          </medium-list>
        </release>
      </release-list>
      <isrc-list>
        <isrc id="GBAHT1600302"/>
      </isrc-list>
      <tag-list>
        <tag count="1">
          <name>electropop</name>
        </tag>
        <tag count="1">
          <name>dance-pop</name>
        </tag>
        <tag count="1">
          <name>contemporary r&b</name>
        </tag>
      </tag-list>
    </recording>
  </recording-list>
</metadata>

Note that if the recording belongs to a release that is a multiple-artist compilation then the release data incluses an artist credit.

Tag

Example

http://musicbrainz.org/ws/2/tag/?query=shoegaze

Search Fields

The tag index contains these fields you can search:

Field Description
tag (part of) the tag's name

Xml

<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
    <tag-list count="5" offset="0">
        <tag ext:score="100">
            <name>shoegaze</name>
        </tag>
        <tag ext:score="62">
            <name>rock shoegaze</name>
        </tag>
        <tag ext:score="62">
            <name>indie shoegaze</name>
        </tag>
        <tag ext:score="50">
            <name>doom metal ethereal shoegaze</name>
        </tag>
        <tag ext:score="31">
            <name>ambient folk classical electronic shoegaze alternative rock indie</name>
        </tag>
    </tag-list>
</metadata>

Json

{
  "created": "2013-02-05T08:20:52.180Z",
  "count": 5,
  "offset": 0,
  "tags": [
    {
      "score": "100",
      "name": "shoegaze"
    },
    {
      "score": "62",
      "name": "rock shoegaze"
    },
    {
      "score": "62",
      "name": "indie shoegaze"
    },
    {
      "score": "50",
      "name": "doom metal ethereal shoegaze"
    },
    {
      "score": "31",
      "name": "ambient folk classical electronic shoegaze alternative rock indie"
    }
  ]
}

Work

Example

https://beta.musicbrainz.org/ws/2/work/?query=work:Frozen%20AND%20arid:4c006444-ccbf-425e-b3e7-03a98bab5997

Search Fields

The Work index contains the following fields you can search

Field Description
alias (part of) any alias attached to the work (diacritics are ignored)
arid the MBID of an artist related to the event (e.g. a composer or lyricist)
artist (part of) the name of an artist related to the work (e.g. a composer or lyricist)
comment (part of) the work's disambiguation comment
iswc any ISWC associated to the work
lang the ISO 639-3 code for any of the languages of the work's lyrics
recording (part of) the title of a recording related to the work
recording_count the number of recordings related to the work
rid the MBID of a recording related to the work
tag (part of) a tag attached to the work
type the work's type (e.g. "opera", "song", "symphony")
wid the work's MBID
work (part of) the work's title (diacritics are ignored)
workaccent (part of) the work's title (with the specified diacritics)

If you don't specify a field, the terms will be searched for in the alias and work fields.

Xml

<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#" xmlns:ext="http://musicbrainz.org/ns/ext#-2.0">
    <work-list offset="0" count="1">
        <work ext:score="100" id="10c1a66a-8166-32ec-a00f-540f111ce7a3">
            <title>Frozen Fred</title>
            <relation-list>
                <relation type="composer">
                    <artist id="4c006444-ccbf-425e-b3e7-03a98bab5997">
                        <name>Michiel Peters</name>             
                        <sort-name>Peters, Michiel</sort-name>
                    </artist>
                </relation>
            </relation-list>
         </work>
    </work-list>
</metadata>