MusicBrainz API/Search/ReleaseSearch: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
No edit summary
(→‎Search Fields: warn about the bug SEARCH-666)
 
(2 intermediate revisions by one other user not shown)
Line 24: Line 24:
| country || the 2-letter code (ISO 3166-1 alpha-2) for any country the release was released in
| 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 recording
| 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")
| date || a release date for the release (e.g. "1980-01-22")
Line 46: Line 46:
| primarytype || the [[Release_Group/Type#Primary_types|primary type]] of the release group for this release
| primarytype || the [[Release_Group/Type#Primary_types|primary type]] of the release group for this release
|-
|-
| quality || the listed [[Release#Data_quality|quality]] of the data for the release (one of "low", "normal", "high")
| quality || the listed [[Release#Data_quality|quality]] of the data for the release (2 for “high”, 1 for “normal”; cannot search for “low” at the moment; see the related [https://tickets.metabrainz.org/browse/SEARCH-666 bug report])
|-
|-
| reid || the release's MBID
| reid || the release's MBID
Line 68: Line 68:
| tracksmedium || the number of tracks on any one medium on the release
| tracksmedium || the number of tracks on any one medium on the release
|-
|-
| type || legacy [[Release_Group/Type|release group type]] field that predates the ability to set multiple 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])
|}
|}



Latest revision as of 12:12, 30 January 2023

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.