MusicBrainz API/Search/RecordingSearch: Difference between revisions
From MusicBrainz Wiki
< MusicBrainz API | Search
Jump to navigationJump to search
(New page: Recording searches can contain you can search: {| border="1" |- | '''field''' || '''Description''' |- | arid || artist id |- | artist || artist name is name(s) as it appears o...) |
Reosarevok (talk | contribs) |
||
(21 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
====Search Fields==== |
|||
Recording searches can contain you can search: |
|||
The [[Recording]] index contains the following fields you can search |
|||
{| border="1" |
|||
{| border="1" class="wikitable sortable" |
|||
|- |
|- |
||
! Field !! Description |
|||
|- |
|||
| alias || (part of) any [[Aliases|alias]] attached to the recording (diacritics are ignored) |
|||
|- |
|||
| arid || the MBID of any of the recording artists |
|||
|- |
|||
| artist || (part of) the combined credited artist name for the recording, including join phrases (e.g. "Artist X feat.") |
|||
|- |
|||
| artistname || (part of) the name of any of the recording artists |
|||
|- |
|||
⚫ | |||
|- |
|||
| country || the 2-letter code (ISO 3166-1 alpha-2) for the country any release of this recording was released in |
|||
|- |
|||
| creditname || (part of) the credited name of any of the recording artists on this particular recording |
|||
|- |
|||
| date || the release date of any release including this recording (e.g. "1980-01-22") |
|||
|- |
|||
⚫ | |||
|- |
|- |
||
| firstreleasedate || the release date of the earliest release including this recording (e.g. "1980-01-22") |
|||
| arid || artist id |
|||
|- |
|- |
||
| format || the [[Release/Format|format]] of any medium including this recording (insensitive to case, spaces, and separators) |
|||
| artist || artist name is name(s) as it appears on the recording |
|||
|- |
|- |
||
| |
| isrc || any [[ISRC]] associated to the recording |
||
|- |
|- |
||
| number || the free-text number of the track on any medium including this recording (e.g. "A4") |
|||
| creditname || name credit on the recording, each artist added as a seperate field |
|||
|- |
|- |
||
| position || the position inside its release of any medium including this recording (starts at 1) |
|||
⚫ | |||
|- |
|- |
||
| primarytype || the [[Release_Group/Type#Primary_types|primary type]] of any release group including this recording |
|||
| country || recording release country |
|||
|- |
|- |
||
| |
| qdur || the recording duration, quantized (duration in milliseconds / 2000) |
||
|- |
|- |
||
| recording || (part of) the recording's name, or the name of a track connected to this recording (diacritics are ignored) |
|||
⚫ | |||
|- |
|- |
||
| recordingaccent || (part of) the recordings's name, or the name of a track connected to this recording (with the specified diacritics) |
|||
| format || recording release format |
|||
|- |
|- |
||
| reid || the MBID of any release including this recording |
|||
| isrc || [[ISRC]] of recording |
|||
|- |
|- |
||
| release || (part of) the name of any release including this recording |
|||
| position || the medium that the recording should be found on, first medium is position 1 |
|||
|- |
|- |
||
| rgid || the MBID of any release group including this recording |
|||
| qdur || quantized duration (duration / 2000) |
|||
|- |
|- |
||
| |
| rid || the recording's MBID |
||
|- |
|- |
||
| secondarytype || any of the [[Release_Group/Type#Secondary_types|secondary types]] of any release group including this recording |
|||
| reid || release id |
|||
|- |
|- |
||
| status || the [[Release#Status|status]] of any release including this recording |
|||
| release || release name |
|||
|- |
|- |
||
| tag || (part of) a tag attached to the recording |
|||
| rid || recording id |
|||
|- |
|- |
||
| tid || the MBID of a track connected to this recording |
|||
| status || [[Release]] status (official, promotion, Bootleg, Pseudo-Release) |
|||
|- |
|- |
||
| |
| tnum || the position of the track on any medium including this recording (starts at 1, pre-gaps at 0) |
||
|- |
|- |
||
| |
| tracks || the number of tracks on any medium including this recording |
||
|- |
|- |
||
| |
| tracksrelease || the number of tracks on any release (as a whole) including this recording |
||
|- |
|- |
||
| 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]) |
|||
| type || [[Release Group]] type (album, single, ep, compilation, soundtrack, spokenword, interview, audiobook, live, remix, other) |
|||
|- |
|- |
||
| video || a boolean flag (true/false) indicating whether or not the recording is a video recording |
|||
| tag || folksonomy tag |
|||
|} |
|} |
||
If you don't specify a field, the terms will be searched for in the ''recording'' field. |
Latest revision as of 15:28, 22 January 2021
Search Fields
The Recording index contains the following fields you can search
Field | Description |
---|---|
alias | (part of) any alias attached to the recording (diacritics are ignored) |
arid | the MBID of any of the recording artists |
artist | (part of) the combined credited artist name for the recording, including join phrases (e.g. "Artist X feat.") |
artistname | (part of) the name of any of the recording artists |
comment | (part of) the recording's disambiguation comment |
country | the 2-letter code (ISO 3166-1 alpha-2) for the country any release of this recording was released in |
creditname | (part of) the credited name of any of the recording artists on this particular recording |
date | the release date of any release including this recording (e.g. "1980-01-22") |
dur | the recording duration in milliseconds |
firstreleasedate | the release date of the earliest release including this recording (e.g. "1980-01-22") |
format | the format of any medium including this recording (insensitive to case, spaces, and separators) |
isrc | any ISRC associated to the recording |
number | the free-text number of the track on any medium including this recording (e.g. "A4") |
position | the position inside its release of any medium including this recording (starts at 1) |
primarytype | the primary type of any release group including this recording |
qdur | the recording duration, quantized (duration in milliseconds / 2000) |
recording | (part of) the recording's name, or the name of a track connected to this recording (diacritics are ignored) |
recordingaccent | (part of) the recordings's name, or the name of a track connected to this recording (with the specified diacritics) |
reid | the MBID of any release including this recording |
release | (part of) the name of any release including this recording |
rgid | the MBID of any release group including this recording |
rid | the recording's MBID |
secondarytype | any of the secondary types of any release group including this recording |
status | the status of any release including this recording |
tag | (part of) a tag attached to the recording |
tid | the MBID of a track connected to this recording |
tnum | the position of the track on any medium including this recording (starts at 1, pre-gaps at 0) |
tracks | the number of tracks on any medium including this recording |
tracksrelease | the number of tracks on any release (as a whole) including this recording |
type | legacy release group type field that predates the ability to set multiple types (see calculation code) |
video | a boolean flag (true/false) indicating whether or not the recording is a video recording |
If you don't specify a field, the terms will be searched for in the recording field.