MusicBrainz API/Search/RecordingSearch: Difference between revisions
From MusicBrainz Wiki
< MusicBrainz API | Search
Jump to navigationJump to search
Reosarevok (talk | contribs) |
|||
(18 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
====Search Fields==== |
====Search Fields==== |
||
Recording |
The [[Recording]] 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 recording (diacritics are ignored) |
|||
| arid || artist id |
|||
|- |
|- |
||
| |
| 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 |
|||
| creditname || name credit on the recording, each artist added as a seperate field |
|||
|- |
|- |
||
| |
| 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 [[Release/Format|format]] of any medium including this recording (insensitive to case, spaces, and separators) |
||
|- |
|- |
||
⚫ | |||
⚫ | |||
|- |
|- |
||
| number || the free-text number of the track on any medium including this recording (e.g. "A4") |
|||
| qdur || quantized duration (duration / 2000) |
|||
|- |
|- |
||
| position || the position inside its release of any medium including this recording (starts at 1) |
|||
⚫ | |||
|- |
|- |
||
⚫ | |||
| recordingaccent || name of the recording with any accent characters retained |
|||
|- |
|- |
||
⚫ | |||
| reid || release id |
|||
|- |
|- |
||
⚫ | |||
| release || release name |
|||
|- |
|- |
||
| recordingaccent || (part of) the recordings's name, or the name of a track connected to this recording (with the specified diacritics) |
|||
| rid || recording id |
|||
|- |
|- |
||
| reid || the MBID of any release including this recording |
|||
| secondarytype || secondary type of the release group (audiobook, compilation, interview, live, remix soundtrack, spokenword) |
|||
|- |
|- |
||
| release || (part of) the name of any release including this recording |
|||
| status || [[Release]] status (official, promotion, Bootleg, Pseudo-Release) |
|||
|- |
|- |
||
| rgid || the MBID of any release group including this recording |
|||
| tnum || track number on medium |
|||
|- |
|- |
||
⚫ | |||
⚫ | |||
|- |
|- |
||
| secondarytype || any of the [[Release_Group/Type#Secondary_types|secondary types]] of any release group including this recording |
|||
⚫ | |||
|- |
|- |
||
| status || the [[Release#Status|status]] of any release including this recording |
|||
| tag || folksonomy tag |
|||
|- |
|- |
||
| tag || (part of) a tag attached to the recording |
|||
| type || type of the release group, old type mapping for when we did not have separate primary and secondary types |
|||
|- |
|||
| 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) |
|||
|- |
|||
⚫ | |||
|- |
|||
⚫ | |||
|- |
|||
| 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]) |
|||
|- |
|||
| 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. |
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.