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

From MusicBrainz Wiki
m
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
====Search Fields====
 
====Search Fields====
The [[Artist|artist]] index contains the following fields you can search:
+
The [[Artist]] index contains the following fields you can search
 
{| border="1" class="wikitable sortable"
 
{| border="1" class="wikitable sortable"
 
|-
 
|-
! Field       !! Description
+
! Field !! Description
 +
 
 
|-
 
|-
| alias || an alias attached to the artist
+
| alias || (part of) any [[Aliases|alias]] attached to the artist (diacritics are ignored)
 
|-
 
|-
| area || the artist's main associated area
+
| primary_alias || (part of) any primary alias attached to the artist (diacritics are ignored)
 +
|-
 +
| area || (part of) the name of the artist's main associated area
 
|-
 
|-
 
| arid || the artist's MBID
 
| arid || the artist's MBID
 
|-
 
|-
| artist || the artist's name (without accented characters)
+
| artist || (part of) the artist's name (diacritics are ignored)
 
|-
 
|-
| artistaccent || the artist's name (with accented characters)
+
| artistaccent || (part of) the artist's name (with the specified diacritics)
 
|-
 
|-
| begin || the artist's begin date
+
| begin || the artist's begin date (e.g. "1980-01-22")
 
|-
 
|-
| beginarea || the artist's begin area
+
| beginarea || (part of) the name of the artist's begin area
 
|-
 
|-
| comment || the artist's disambiguation comment
+
| comment || (part of) the artist's disambiguation comment
 
|-
 
|-
| country || the 2-letter code (ISO 3166-1 alpha-2) for the artist's main associated country, or “unknown”
+
| country || the 2-letter code (ISO 3166-1 alpha-2) for the artist's main associated country
 
|-
 
|-
| end || the artist's end date
+
| end || the artist's end date (e.g. "1980-01-22")
 
|-
 
|-
| endarea || the artist's end area
+
| endarea || (part of) the name of the artist's end area
 
|-
 
|-
| ended || a flag indicating whether or not the artist has ended
+
| ended || a boolean flag (true/false) indicating whether or not the artist has ended (is dissolved/deceased)
 
|-
 
|-
| gender || the artist's gender (“male”, “female”, or “other”)
+
| gender || the artist's gender (“male”, “female”, “other” or “not applicable”)
 
|-
 
|-
 
| ipi || an IPI code associated with the artist
 
| ipi || an IPI code associated with the artist
 
|-
 
|-
| sortname || the artist's sort name
+
| isni || an ISNI code associated with the artist
 +
|-
 +
| sortname || (part of) the artist's [[Artist#Sort_name|sort name]]
 
|-
 
|-
| tag || a tag attached to the artist
+
| tag || (part of) a tag attached to the artist
 
|-
 
|-
| type || the artist's type (“person”, “group”, ...)
+
| type || the artist's [[Artist#Type|type]] (“person”, “group”, etc.)
 
|}
 
|}
  
Artist search terms with no fields specified search the ''artist'', ''sortname'' and ''alias'' fields.
+
If you don't specify a field, the terms will be searched for in the ''alias'', ''artist'' and ''sortname'' fields.

Latest revision as of 12:19, 22 January 2021

Search Fields

The Artist index contains the following fields you can search

Field Description
alias (part of) any alias attached to the artist (diacritics are ignored)
primary_alias (part of) any primary alias attached to the artist (diacritics are ignored)
area (part of) the name of the artist's main associated area
arid the artist's MBID
artist (part of) the artist's name (diacritics are ignored)
artistaccent (part of) the artist's name (with the specified diacritics)
begin the artist's begin date (e.g. "1980-01-22")
beginarea (part of) the name of the artist's begin area
comment (part of) the artist's disambiguation comment
country the 2-letter code (ISO 3166-1 alpha-2) for the artist's main associated country
end the artist's end date (e.g. "1980-01-22")
endarea (part of) the name of the artist's end area
ended a boolean flag (true/false) indicating whether or not the artist has ended (is dissolved/deceased)
gender the artist's gender (“male”, “female”, “other” or “not applicable”)
ipi an IPI code associated with the artist
isni an ISNI code associated with the artist
sortname (part of) the artist's sort name
tag (part of) a tag attached to the artist
type the artist's type (“person”, “group”, etc.)

If you don't specify a field, the terms will be searched for in the alias, artist and sortname fields.