MusicBrainz API/Search/ReleaseSearch: Difference between revisions
From MusicBrainz Wiki
< MusicBrainz API | Search
Jump to navigationJump to search
(→Search Fields: Improve release’s format search field for https://tickets.metabrainz.org/browse/SEARCH-574) |
(→Search Fields: warn about the bug SEARCH-666) |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
====Search Fields==== |
====Search Fields==== |
||
The [[Release |
The [[Release]] index contains the following fields you can search |
||
{| border="1" class="wikitable sortable" |
{| border="1" class="wikitable sortable" |
||
|- |
|- |
||
! Field !! Description |
|||
|- |
|- |
||
| alias || (part of) any [[Aliases|alias]] attached to the release (diacritics are ignored) |
|||
| arid || artist id |
|||
|- |
|- |
||
| |
| 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 [[ASIN|Amazon ASIN]] for the release |
||
|- |
|- |
||
| barcode || the barcode for the release |
|||
⚫ | |||
|- |
|- |
||
⚫ | |||
| comment || Disambiguation comment |
|||
|- |
|- |
||
| comment || (part of) the release's disambiguation comment |
|||
| country || The [https://www.iso.org/obp/ui/#search/code/ two letter country code] for the release country |
|||
|- |
|- |
||
| country || the 2-letter code (ISO 3166-1 alpha-2) for any country the release was released in |
|||
| creditname || name credit on the release, each artist added as a separate field |
|||
|- |
|- |
||
| creditname || (part of) the credited name of any of the release artists on this particular release |
|||
| date || The release date (format: YYYY-MM-DD) |
|||
|- |
|- |
||
| |
| date || a release date for the release (e.g. "1980-01-22") |
||
|- |
|- |
||
| |
| discids || the total number of [[Disc_ID|disc IDs]] attached to all mediums on the release |
||
|- |
|- |
||
| discidsmedium || the number of [[Disc_ID|disc IDs]] attached to any one medium on the release |
|||
⚫ | |||
|- |
|- |
||
⚫ | |||
| 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 |
|||
|- |
|- |
||
| laid || the MBID of any of the release labels |
|||
| 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) |
|||
|- |
|- |
||
| |
| label || (part of) the name of any of the release labels |
||
|- |
|- |
||
| lang || the [https://iso639-3.sil.org/code_tables/639/data ISO 639-3 code] for the release language |
|||
⚫ | |||
|- |
|- |
||
| |
| mediums || the number of mediums on the release |
||
|- |
|- |
||
| packaging || the [[Release/Packaging|format]] of the release (insensitive to case, spaces, and separators) |
|||
| reid || release id |
|||
|- |
|- |
||
⚫ | |||
| release || release name |
|||
|- |
|- |
||
| 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]) |
|||
| releaseaccent || name of the release with any accent characters retained |
|||
|- |
|- |
||
| |
| reid || the release's MBID |
||
|- |
|- |
||
| release || (part of) the release's title (diacritics are ignored) |
|||
| script || The [http://unicode.org/iso15924/iso15924-codes.html 4 character script code] (e.g. latn) used for this release |
|||
|- |
|- |
||
| |
| releaseaccent || (part of) the release's title (with the specified diacritics) |
||
|- |
|- |
||
| |
| rgid || the MBID of the release group for this release |
||
|- |
|- |
||
| |
| script || the [http://unicode.org/iso15924/iso15924-codes.html ISO 15924 code] for the release script |
||
|- |
|- |
||
| secondarytype || any of the [[Release_Group/Type#Secondary_types|secondary types]] of the release group for this release |
|||
⚫ | |||
|- |
|- |
||
| |
| status || the [[Release#Status|status]] of the release |
||
|- |
|- |
||
| tag || (part of) a tag attached to the release |
|||
| type || type of the release group, old type mapping for when we did not have separate primary and secondary types |
|||
⚫ | |||
⚫ | |||
|- |
|||
| 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 ([https://github.com/metabrainz/musicbrainz-server/blob/f8bd7e9366eb6e836dfcee9b626e1ca969db1c4f/lib/MusicBrainz/Server/WebService/XMLSerializer.pm#L305-L326 see calculation code]) |
|||
|} |
|} |
||
If you don't specify a field, the terms will be searched for in the ''release'' field. |
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.