MusicBrainz API/Search/RecordingSearch: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
No edit summary
 
(20 intermediate revisions by 7 users not shown)
Line 1: Line 1:
====Search Fields====
====Search Fields====
Recording searches can contain 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

|-
| 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
|-
| 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")
| 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
|-
|-
| artistname || an artist on the recording, each artist added as a seperate field
| 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)
| comment || recording disambuguation comment
|-
|-
| primarytype || the [[Release_Group/Type#Primary_types|primary type]] of any release group including this recording
| country || recording release country
|-
|-
| date || recording release date
| 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)
| dur || duration of track in milliseconds
|-
|-
| 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)
|-
|-
| recording || name of recording or a track associated with the recording
| 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 || track number on medium
| tnum || the position of the track on any medium including this recording (starts at 1, pre-gaps at 0)
|-
|-
| tracks || number of tracks in the medium on release
| tracks || the number of tracks on any medium including this recording
|-
|-
| tracksrelease || number of tracks on release as a whole
| 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
|}
|}


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.

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.