Difference between revisions of "MusicBrainz API/Search/ReleaseSearch"

From MusicBrainz Wiki
(Search Fields: Fix links to release format & packaging)
m (Search Fields)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
====Search Fields====
 
====Search Fields====
The [[Release|release]] index contains these fields you can search:
+
The [[Release]] index contains the following fields you can search
 
{| border="1" class="wikitable sortable"
 
{| border="1" class="wikitable sortable"
 
|-
 
|-
| '''field'''  || '''Description'''
+
! Field !! Description
 +
 
 +
|-
 +
| alias || (part of) any [[Aliases|alias]] attached to the release (diacritics are ignored)
 +
|-
 +
| arid || the MBID of any of the release artists
 
|-
 
|-
| arid  || artist id
+
| artist || (part of) the combined credited artist name for the release, including join phrases (e.g. "Artist X feat.")
 
|-
 
|-
| artist  || complete artist name(s) as it appears on the release  
+
| artistname || (part of) the name of any of the release artists
 
|-
 
|-
| artistname  || an artist on the release, each artist added as a separate field
+
| asin || an [[ASIN|Amazon ASIN]] for the release
 
|-
 
|-
| asin  || the Amazon ASIN for this release
+
| barcode || the barcode for the release
 
|-
 
|-
| barcode  || The barcode of this release
+
| catno || any catalog number for this release (insensitive to case, spaces, and separators)
 
|-
 
|-
| catno  || The catalog number for this release, can have multiples when major using an imprint
+
| comment || (part of) the release's disambiguation comment
 
|-
 
|-
| comment  || Disambiguation comment
+
| country || the 2-letter code (ISO 3166-1 alpha-2) for any country the release was released in
 
|-
 
|-
| country  || The [https://www.iso.org/obp/ui/#search/code/ two letter country code] for the release country
+
| creditname || (part of) the credited name of any of the release artists on this particular release
 
|-
 
|-
| creditname  || name credit on the release, each artist added as a separate field
+
| date || a release date for the release (e.g. "1980-01-22")
 
|-
 
|-
| date  || The release date (format: YYYY-MM-DD)
+
| discids || the total number of [[Disc_ID|disc IDs]] attached to all mediums on the release
 
|-
 
|-
| discids  || total number of cd ids over all mediums for the release  
+
| discidsmedium || the number of [[Disc_ID|disc IDs]] attached to any one medium on the release
 
|-
 
|-
| discidsmedium  || number of cd ids for the release on a medium in the release  
+
| format || the [[Release/Format|format]] of any medium in the release (insensitive to case, spaces, and separators)
 
|-
 
|-
| format  || format of a medium in the release (insensitive to letter case, spaces, and separators), see [[Release/Format]]
+
| laid || the MBID of any of the release labels
 
|-
 
|-
| laid  ||  The label id for this release, a release can have multiples when major using an imprint
+
| label || (part of) the name of any of the release labels
|-
 
| 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 [http://www-01.sil.org/iso639-3/codes.asp three character ISO 639-3 codes] to search for a specific language. (e.g. lang:eng)
+
| lang || the [https://iso639-3.sil.org/code_tables/639/data ISO 639-3 code] for the release language
 
|-
 
|-
| mediums || number of mediums in the release
+
| mediums || the number of mediums on the release
 
|-
 
|-
| packaging || packaging type name (insensitive to letter case, spaces, and separators), see [[Release/Packaging]]
+
| packaging || the [[Release/Packaging|format]] of the release (insensitive to case, spaces, and separators)
 
|-
 
|-
| primarytype || primary type of the release group (album, single, ep, other)
+
| primarytype || the [[Release_Group/Type#Primary_types|primary type]] of the release group for this release
 
|-
 
|-
| quality || The quality of the release (low, normal, high)  
+
| quality || the listed [[Release#Data_quality|quality]] of the data for the release (one of "low", "normal", "high")
 
|-
 
|-
| reid || release id
+
| reid || the release's MBID
 
|-
 
|-
| release || release name
+
| release || (part of) the release's title (diacritics are ignored)
 
|-
 
|-
| releaseaccent || name of the release with any accent characters retained
+
| releaseaccent || (part of) the release's title (with the specified diacritics)
 
|-
 
|-
| rgid || release group id
+
| rgid || the MBID of the release group for this release
 
|-
 
|-
| script || The [http://unicode.org/iso15924/iso15924-codes.html 4 character script code] (e.g. latn) used for this release  
+
| script || the [http://unicode.org/iso15924/iso15924-codes.html ISO 15924 code] for the release script
 
|-
 
|-
| secondarytype || secondary type of the release group (audiobook, compilation, interview, live, remix, soundtrack, spokenword)
+
| secondarytype || any of the [[Release_Group/Type#Secondary_types|secondary types]] of the release group for this release
 
|-
 
|-
| status || release status (e.g official)
+
| status || the [[Release#Status|status]] of the release
 
|-
 
|-
| tag || a tag that appears on the release
+
| tag || (part of) a tag attached to the release
 
|-
 
|-
| tracks || total number of tracks over all mediums on the release  
+
| tracks || the total number of tracks on the release
 
|-
 
|-
| tracksmedium || number of tracks on a medium in the release  
+
| tracksmedium || the number of tracks on any one medium on the release
 
|-
 
|-
| type || type of the release group, old type mapping for when we did not have separate primary and secondary types
+
| type || legacy [[Release_Group/Type|release group type]] field that predates the ability to set multiple types ([https://github.com/metabrainz/musicbrainz-server/blob/f8bd7e9366eb6e836dfcee9b626e1ca969db1c4f/lib/MusicBrainz/Server/WebService/XMLSerializer.pm#L305-L326 see calculation code])
 
 
 
|}
 
|}
  
Release search terms with no fields search the ''release'' field only.
+
If you don't specify a field, the terms will be searched for in the ''release'' field.

Latest revision as of 15:29, 22 January 2021

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 (one of "low", "normal", "high")
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.