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

From MusicBrainz Wiki
(Search Fields)
 
(15 intermediate revisions by 11 users not shown)
Line 1: Line 1:
 
====Search Fields====
 
====Search Fields====
The release index contains these fields you can search:  
+
The [[Release|release]] index contains these fields you can search:  
 
{| border="1" class="wikitable sortable"
 
{| border="1" class="wikitable sortable"
 
|-
 
|-
Line 9: Line 9:
 
|  artist  ||  complete artist name(s) as it appears on the release  
 
|  artist  ||  complete artist name(s) as it appears on the release  
 
|-
 
|-
|  artistname  ||  an artist on the release, each artist added as a seperate field  
+
|  artistname  ||  an artist on the release, each artist added as a separate field  
 
|-
 
|-
 
|  asin  ||  the Amazon ASIN for this release
 
|  asin  ||  the Amazon ASIN for this release
Line 19: Line 19:
 
|  comment  ||  Disambiguation comment
 
|  comment  ||  Disambiguation comment
 
|-
 
|-
|  country  ||  The [http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm two letter country code] for the release country
+
|  country  ||  The [https://www.iso.org/obp/ui/#search/code/ two letter country code] for the release country
 
|-
 
|-
|  creditname  ||  name credit on the release, each artist added as a seperate field  
+
|  creditname  ||  name credit on the release, each artist added as a separate field  
 
|-
 
|-
 
|  date  ||  The release date (format: YYYY-MM-DD)
 
|  date  ||  The release date (format: YYYY-MM-DD)
Line 29: Line 29:
 
|  discidsmedium  ||  number of cd ids for the release on a medium in the release  
 
|  discidsmedium  ||  number of cd ids for the release on a medium in the release  
 
|-
 
|-
|  format  ||  release format  
+
|  format  ||  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
 
|  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.loc.gov/standards/iso639-2/php/code_list.php three character ISO 639 codes] to search for a specific language. (e.g. lang:eng)
+
|  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)
 
|-
 
|-
 
|  mediums  ||  number of mediums in the release
 
|  mediums  ||  number of mediums in the release
 
|-
 
|-
puid ||  The release contains recordings with these puids
+
| primarytype || primary type of the release group (album, single, ep, other)
 +
|-
 +
quality ||  The quality of the release (low, normal, high)
 
|-
 
|-
 
|  reid  ||  release id  
 
|  reid  ||  release id  
Line 48: Line 52:
 
|-
 
|-
 
|  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 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)  
 
|  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  
 
|  tracks  ||  total number of tracks over all mediums on the release  
Line 55: Line 63:
 
|  tracksmedium  ||  number of tracks on a medium in the release  
 
|  tracksmedium  ||  number of tracks on a medium in the release  
 
|-
 
|-
| type || release group type (e.g album)
+
| 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.
 
Release search terms with no fields search the ''release'' field only.

Latest revision as of 00:13, 8 July 2020

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