Difference between revisions of "MusicBrainz API/Search/RecordingSearch"
From MusicBrainz Wiki
< MusicBrainz API | Search
Jump to navigationJump to searchReosarevok (talk | contribs) |
Reosarevok (talk | contribs) |
||
| (6 intermediate revisions by the same user not shown) | |||
| Line 13: | Line 13: | ||
|- |
|- |
||
| artistname || (part of) the name of any of the recording artists |
| 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 |
| comment || (part of) the recording's disambiguation comment |
||
| Line 20: | Line 18: | ||
| country || the 2-letter code (ISO 3166-1 alpha-2) for the country any release of this recording was released in |
| 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 |
| dur || the recording duration in milliseconds |
||
|- |
|- |
||
| − | | firstreleasedate || the release date of the earliest release including this recording |
+ | | 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 |
+ | | format || the [[Release/Format|format]] of any medium including this recording (insensitive to case, spaces, and separators) |
|- |
|- |
||
| isrc || any [[ISRC]] associated to the recording |
| isrc || any [[ISRC]] associated to the recording |
||
| Line 38: | Line 38: | ||
| qdur || the recording duration, quantized (duration in milliseconds / 2000) |
| qdur || the recording duration, quantized (duration in milliseconds / 2000) |
||
|- |
|- |
||
| − | | recording || (part of) the recording's name (diacritics are ignored) |
+ | | 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 (with the specified diacritics) |
+ | | 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 |
| reid || the MBID of any release including this recording |
||
| Line 52: | Line 52: | ||
| secondarytype || any of the [[Release_Group/Type#Secondary_types|secondary types]] of any release group including this recording |
| 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 |
+ | | status || the [[Release#Status|status]] of any release including this recording |
|- |
|- |
||
| tag || (part of) a tag attached to the recording |
| tag || (part of) a tag attached to the recording |
||
| Line 64: | Line 64: | ||
| tracksrelease || the number of tracks on any release (as a whole) 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 |
+ | | 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 |
| video || a boolean flag (true/false) indicating whether or not the recording is a video recording |
||
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.
