Difference between revisions of "MusicBrainz API/Search"
From MusicBrainz Wiki
| Line 37: | Line 37: | ||
{{:XML_Web_Service/Version_2/Search/AnnotationSearch}} | {{:XML_Web_Service/Version_2/Search/AnnotationSearch}} | ||
{{:XML_Web_Service/Version_2/Search/AnnotationSearchXmlOutput}} | {{:XML_Web_Service/Version_2/Search/AnnotationSearchXmlOutput}} | ||
| + | {{:XML_Web_Service/Version_2/Search/AnnotationSearchJsonOutput}} | ||
===Artist=== | ===Artist=== | ||
Revision as of 12:42, 5 February 2013
The Web Service provides a way to search for MusicBrainz Entities, the results are returned in Xml format matching the MMD. The results are provided By a Search Server built using Lucene technology.
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) |
| query | Lucene search query, this is mandatory |
| 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. |
The query field supports the full Lucene Search syntax; you can find a detailed guide at Lucene Search Syntax. For example, you can set conditions while searching for a name with the AND operator.
Example: http://www.musicbrainz.org/ws/2/recording?query=%22we%20will%20rock%20you%22%20AND%20arid:0383dadf-2a4e-4d10-a46a-e9e041da8eb3 will find any recordings of "We Will Rock You" by Queen.
When searching fields that come from a defined set of possible values such as country and gender, find matches where these fields have not been set by searching for unknown.
Example: http://musicbrainz.org/ws/2/release/?query=country:unknown
Most other textual fields can be searched on by looking for value - (need escaping to \-)
Example: http://musicbrainz.org/ws/2/release/?query=format:\-
Numeric count based fields can be searched for by looking for 0
Example: http://musicbrainz.org/ws/2/release-group/?query=releases:0
Contents
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 |
|---|---|
| name | the annotated entity's name or title |
| entity | the annotated entity's MBID |
| text | the annotation's content (includes wiki formatting) |
| type | the annotated entity's entity type |
Query terms without a field specifier will search 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>
XML Web Service/Version 2/Search/AnnotationSearchJsonOutput
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 | an alias attached to the artist |
| area | the artist's main associated area |
| arid | the artist's MBID |
| artist | the artist's name (without accented characters) |
| artistaccent | the artist's name (with accented characters) |
| begin | the artist's begin date |
| beginarea | the artist's begin area |
| comment | the artist's disambiguation comment |
| country | the 2-letter code (ISO 3166-1 alpha-2) for the artist's main associated country, or “unknown” |
| end | the artist's end date |
| endarea | the artist's end area |
| ended | a flag indicating whether or not the artist has ended |
| gender | the artist's gender (“male”, “female”, or “other”) |
| ipi | an IPI code associated with the artist |
| sortname | the artist's sort name |
| tag | a tag attached to the artist |
| type | the artist's type (“person”, “group”, ...) |
Artist search terms with no fields specified search the artist, sortname and alias 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 |
|---|---|
| artist | the artist name set on the CD stub |
| barcode | the barcode set on the CD stub |
| comment | the comment set on the CD stub |
| discid | the CD stub's Disc ID |
| title | the release title set on the CD stub |
| tracks | the CD stub's number of tracks |
Query terms without a field specifier will search 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 | the aliases/misspellings for this label |
| area | label area |
| begin | label founding date |
| code | label code (only the figures part, i.e. without "LC") |
| comment | label comment to differentiate similar labels |
| country | The two letter country code of the label country |
| end | label dissolution date |
| ended | true if know ended even if do not know end date |
| ipi | ipi |
| label | label name |
| labelaccent | name of the label with any accent characters retained |
| laid | MBID of the label |
| sortname | label sortname |
| type | label type |
| tag | folksonomy tag |
Label search terms with no fields specified search the label, sortname and alias 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>
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 |
| arid | artist id |
| artist | artist name is name(s) as it appears on the recording |
| artistname | an artist on the recording, each artist added as a separate field |
| creditname | name credit on the recording, each artist added as a separate field |
| comment | recording disambiguation comment |
| country | recording release country |
| date | recording release date |
| dur | duration of track in milliseconds |
| firstreleasedate | date of the earliest release the recording appears on |
| format | recording release format |
| isrc | ISRC of recording |
| number | free text track number |
| position | the medium that the recording should be found on, first medium is position 1 |
| primarytype | primary type of the release group (album, single, ep, other) |
| qdur | quantized duration (duration / 2000) |
| recording | name of recording or a track associated with the recording |
| recordingaccent | name of the recording with any accent characters retained |
| reid | release id |
| release | release name |
| rgid | release group id |
| rid | recording id |
| secondarytype | secondary type of the release group (audiobook, compilation, interview, live, remix soundtrack, spokenword) |
| status | Release status (official, promotion, Bootleg, Pseudo-Release) |
| tid | track id |
| tnum | track number on medium |
| tracks | number of tracks in the medium on release |
| tracksrelease | number of tracks on release as a whole |
| tag | folksonomy tag |
| type | type of the release group, old type mapping for when we did not have separate primary and secondary types or use standalone for standalone recordings |
| video | true to only show video tracks |
Recording search terms with no fields search the recording field only
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.
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 |
|---|---|
| arid | MBID of the release group’s artist |
| artist | release group artist as it appears on the cover (Artist Credit) |
| artistname | “real name” of any artist that is included in the release group’s artist credit |
| comment | release group comment to differentiate similar release groups |
| creditname | name of any artist in multi-artist credits, as it appears on the cover. |
| firstreleasedate | date of the earliest release that appears in the release group |
| primarytype | primary type of the release group (album, single, ep, other) |
| rgid | MBID of the release group |
| releasegroup | name of the release group |
| releasegroupaccent | name of the releasegroup with any accent characters retained |
| releases | number of releases in this release group |
| release | name of a release that appears in the release group |
| reid | MBID of a release that appears in the release group |
| secondarytype | secondary type of the release group (audiobook, compilation, interview, live, remix soundtrack, spokenword) |
| status | status of a release that appears within the release group |
| tag | a tag that appears on the release group |
| type | type of the release group, old type mapping for when we did not have separate primary and secondary types |
Release group search terms with no fields search the releasegroup field only.
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 these fields you can search:
| field | Description |
| arid | artist id |
| artist | complete artist name(s) as it appears on the release |
| artistname | an artist on the release, each artist added as a separate field |
| asin | the Amazon ASIN for this release |
| barcode | The barcode of this release |
| catno | The catalog number for this release, can have multiples when major using an imprint |
| comment | Disambiguation comment |
| country | The two letter country code for the release country |
| creditname | name credit on the release, each artist added as a separate field |
| date | The release date (format: YYYY-MM-DD) |
| discids | total number of cd ids over all mediums for the release |
| discidsmedium | number of cd ids for the release on a medium in the release |
| format | format of a medium in the release (insensitive to letter case, spaces, and separators), see Release/Format |
| laid | The label id for this release, a release can have multiples when major using an imprint |
| label | The name of the label for this release, can have multiples when major using an imprint |
| lang | The language for this release. Use the three character ISO 639-3 codes to search for a specific language. (e.g. lang:eng) |
| mediums | number of mediums in the release |
| packaging | packaging type name (insensitive to letter case, spaces, and separators), see Release/Packaging |
| primarytype | primary type of the release group (album, single, ep, other) |
| quality | The quality of the release (low, normal, high) |
| reid | release id |
| release | release name |
| releaseaccent | name of the release with any accent characters retained |
| rgid | release group id |
| script | The 4 character script code (e.g. latn) used for this release |
| secondarytype | secondary type of the release group (audiobook, compilation, interview, live, remix, soundtrack, spokenword) |
| status | release status (e.g official) |
| tag | a tag that appears on the release |
| tracks | total number of tracks over all mediums on the release |
| tracksmedium | number of tracks on a medium in the release |
| type | type of the release group, old type mapping for when we did not have separate primary and secondary types |
Release search terms with no fields search the release field only.
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>
Tag
Example
http://musicbrainz.org/ws/2/tag/?query=shoegaze
Search Fields
The tag index contains these fields you can search:
| Field | Description |
|---|---|
| tag | the tag's text |
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
Search Fields
The work index contains these fields you can search:
| field | Description |
| alias | the aliases/misspellings for this work |
| arid | artist id |
| artist | artist name, an artist in the context of a work is an artist-work relation such as composer or lyricist |
| comment | disambiguation comment |
| iswc | ISWC of work |
| lang | Lyrics language of work |
| tag | folksonomy tag |
| type | work type |
| wid | work id |
| work | name of work |
| workaccent | name of the work with any accent characters retained |
Work search terms with no fields specified search the work and alias 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>
