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

From MusicBrainz Wiki
(Search Fields: Add recording’s first release date search field for https://tickets.metabrainz.org/browse/SEARCH-218)
Line 1: Line 1:
 
====Search Fields====
 
====Search Fields====
The [[Recording|recording]] index contains the following fields you can search
+
The [[Recording]] index contains the following fields you can search
 
{| border="1" class="wikitable sortable"
 
{| border="1" class="wikitable sortable"
 
|-
 
|-
|  '''field'''  ||  '''Description'''
+
! Field !! Description
 +
 
 
|-
 
|-
| arid  || artist id
+
| alias || (part of) any [[Aliases|alias]] attached to the recording (diacritics are ignored)
 
|-
 
|-
| artist  || artist name is name(s) as it appears on the recording  
+
| arid || the MBID of any of the recording artists
 
|-
 
|-
| artistname  || an artist on the recording, each artist added as a separate field
+
| artist || (part of) the combined credited artist name for the recording, including join phrases (e.g. "Artist X feat.")
 
|-
 
|-
| creditname  || name credit on the recording, each artist added as a separate field
+
| artistname || (part of) the name of any of the recording artists
 
|-
 
|-
| comment  || recording disambiguation comment
+
| creditname || (part of) the credited name of any of the recording artists on this particular recording
 
|-
 
|-
| country  || recording release country
+
| comment || (part of) the recording's disambiguation comment
 
|-
 
|-
| date  || recording release date
+
| country || the 2-letter code (ISO 3166-1 alpha-2) for the country any release of this recording was released in
 
|-
 
|-
| dur  || duration of track in milliseconds
+
| date || the release date of any release including this recording
 
|-
 
|-
| firstreleasedate  || date of the earliest release the recording appears on
+
| dur || the recording duration in milliseconds
 
|-
 
|-
| format  || recording release format
+
| firstreleasedate || the release date of the earliest release including this recording
 
|-
 
|-
| isrc  || [[ISRC]] of recording  
+
| format || the [[Release/Format|format]] of any medium including this recording
 
|-
 
|-
| number  || free text track number
+
| isrc || any [[ISRC]] associated to the recording
 
|-
 
|-
| position  || the medium that the recording should be found on, first medium is position 1
+
| number || the free-text number of the track on any medium including this recording (e.g. "A4")
 
|-
 
|-
| primarytype || primary type of the release group (album, single, ep, other)
+
| position || the position inside its release of any medium including this recording (starts at 1)
 
|-
 
|-
| qdur  || quantized duration (duration / 2000)
+
| primarytype || the [[Release_Group/Type#Primary_types|primary type]] of any release group including this recording
 
|-
 
|-
| recording  || name of recording or a track associated with the recording
+
| qdur || the recording duration, quantized (duration in milliseconds / 2000)
 
|-
 
|-
| recordingaccent  || name of the recording with any accent characters retained
+
| recording || (part of) the recording's name (diacritics are ignored)
 
|-
 
|-
| reid  || release id
+
| recordingaccent || (part of) the recordings's name (with the specified diacritics)
 
|-
 
|-
| release  || release name
+
| reid || the MBID of any release including this recording
 
|-
 
|-
| rgid  || release group id
+
| release || (part of) the name of any release including this recording
 
|-
 
|-
| rid  || recording id
+
| rgid || the MBID of any release group including this recording
 
|-
 
|-
| secondarytype || secondary type of the release group (audiobook, compilation, interview, live, remix soundtrack, spokenword)
+
| rid || the recording's MBID
 
|-
 
|-
| status  || [[Release]] status (official, promotion, Bootleg, Pseudo-Release)
+
| secondarytype || any of the [[Release_Group/Type#Secondary_types|secondary types]] of any release group including this recording
 
|-
 
|-
| tid  || track id
+
| status || the [[Release#Status|status] of any release including this recording
 
|-
 
|-
| tnum  || track number on medium
+
| tag || (part of) a tag attached to the recording
 
|-
 
|-
| tracks  || number of tracks in the medium on release
+
| tid || the MBID of a track connected to this recording
 
|-
 
|-
| tracksrelease  || number of tracks on release as a whole
+
| tnum || the position of the track on any medium including this recording (starts at 1, pre-gaps at 0)
 
|-
 
|-
| tag  || folksonomy tag
+
| tracks || the number of tracks on any medium including this recording
 
|-
 
|-
| type || type of the release group, old type mapping for when we did not have separate primary and secondary types or use standalone for standalone recordings
+
| tracksrelease || the number of tracks on any release (as a whole) including this recording
 
|-
 
|-
| video || true to only show video tracks
+
| type || legacy [[Release_Group/Type|release group type] field that predates the ability to set multiple types
 
+
|-
 +
| video || a boolean flag (true/false) indicating whether or not the recording is a video recording
 
|}
 
|}
  
Recording search terms with no fields search the ''recording'' field only
+
If you don't specify a field, the terms will be searched for in the ''recording'' field.

Revision as of 13:36, 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
creditname (part of) the credited name of any of the recording artists on this particular recording
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
date the release date of any release including this recording
dur the recording duration in milliseconds
firstreleasedate the release date of the earliest release including this recording
format the format of any medium including this 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")
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 (diacritics are ignored)
recordingaccent (part of) the recordings's name (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 [[Release#Status|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|release group type] field that predates the ability to set multiple types
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.