MusicBrainz

Look up music metadata in MusicBrainz, the open music encyclopedia: search for artists, albums, recordings, works and labels; read an artist's full discography or a label's catalogue; follow the relationships that record who played on what and where a release streams; identify a CD from its disc ID or a recording from its ISRC; fetch cover art; read your own collections; and submit tags, ratings, ISRCs and barcodes.

Actions

Action	What it does
Add a barcode to a release	Attach the EAN or UPC printed on a release's packaging.
Add ISRCs to a recording	Attach one or more ISRCs to a recording.
Find recordings by ISRC	Find every recording carrying an ISRC.
Find what a web address is linked to	Give an artist's homepage, a Discogs page, a Wikidata item or a streaming link, and MusicBrainz answers with what it is attached to.
Find works by ISWC	Find every work carrying an ISWC.
Get a label	Look up one record label, with its LC code, country and the years it operated.
Get a recording	Look up one recording: a single performance of a song, as it appears as a track, with its length and ISRCs.
Get a release	Look up one release: a specific issue of an album, with its own barcode, catalogue number, country, packaging and track list.
Get a release group	Look up one release group: an album, single or EP as a thing in its own right, with its type and the date it first came out.
Get a work	Look up one work: the composition itself, which every recording of it points back to, with its ISWCs and lyrics languages.
Get an artist	Look up everything MusicBrainz holds about one artist: their type, country, the years they were active, their aliases in other scripts, and their IPI and ISNI codes.
Get any entity by ID	Look up any MusicBrainz entity by its kind and ID.
Get cover art	Fetch the artwork the Cover Art Archive holds for a release or an album.
Get my MusicBrainz account	Report which MusicBrainz account this integration is connected as.
Identify a CD by disc ID	Turn a CD in a drive into the release it actually is.
List artists linked to something	List the artists linked to an area, a release, a recording, a work or a collection.
List collections	List an editor's collections with how many things are in each, and which kind of thing each one holds.
List events linked to something	List the concerts and festivals linked to an artist, a venue, an area or a collection.
List genres	List MusicBrainz's own genre vocabulary, alphabetically, with the ID of each.
List labels linked to something	List the labels based in an area, the labels that issued one release, or the contents of a collection of labels.
List places linked to something	List the venues, studios and stadiums in an area, or the contents of a collection of places.
List recordings linked to something	List the recordings linked to an artist, the tracks on a release, every recording of one work, or the contents of a collection.
List release groups linked to something	List an artist's albums, singles and EPs, the release groups one release belongs to, or the contents of a collection.
List releases linked to something	List every release directly linked to one thing: an artist's discography, a label's catalogue, every issue of an album, or the contents of a collection.
List works linked to something	List the works linked to an artist, or the contents of a collection of works.
Rate something	Rate a MusicBrainz entity out of five stars as the connected account.
Search any index	Search any MusicBrainz index with a query you write yourself.
Search for artists	Find artists by name and narrow the match by type, country, gender, area, genre or the years they were active.
Search for labels	Find record labels by name, LC code, country or type.
Search for recordings	Find individual performances of a song by title, artist, the release they appear on, or ISRC.
Search for release groups	Find albums, singles and EPs as things in their own right, independent of how many times they have been reissued.
Search for releases	Find specific issues of an album by title, artist, barcode, catalogue number, label, country, format or release date.
Search for works	Find compositions by title, the artist who wrote or performed them, ISWC or type.
Tag something	Add tags to a MusicBrainz entity, hide ones you disagree with, or take back a vote you cast before.

Add a barcode to a release

Attach the EAN or UPC printed on a release's packaging. Only GTIN codes are accepted, and the check digit is verified before sending so a typo is caught here rather than refused there. Unlike a tag or a rating this changes the database for everyone, so it opens an edit: it applies once it goes unopposed or its voting period expires.

Inputs

Release IDrelease_idtextRequired: The release's MusicBrainz ID, or the address of its page. A release is one issue of an album; the ID of the album itself is a release group ID and will not be found here.
BarcodebarcodetextRequired: The 8, 12, 13 or 14 digit GTIN. Spaces and hyphens are ignored. Codes with a 2 or 5 digit add-on are not accepted by MusicBrainz.

Outputs

barcodetext
entity_typetext
mbidtext
nametext
opens_edittrue/false
submittedtext
urltext

Example output

{
  "barcode": "720642442524",
  "entity_type": "release",
  "mbid": "8e061dc4-790e-4587-ba53-011e7852f88d",
  "name": "Nevermind",
  "opens_edit": true,
  "submitted": "a barcode",
  "url": "https://musicbrainz.org/release/8e061dc4-790e-4587-ba53-011e7852f88d"
}

Add ISRCs to a recording

Attach one or more ISRCs to a recording. Each code is checked against the ISRC format first, and the hyphens a printed ISRC carries are dropped. Like a barcode this opens an edit rather than applying at once.

Inputs

Recording IDrecording_idtextRequired: The recording's MusicBrainz ID, or the address of its page. A recording is one performance, as it appears as a track.
ISRCsisrcslistRequired: The codes to attach: one per line, comma-separated, or a list from an earlier step. Hyphens are optional.

Outputs

entity_typetext
isrcslist
mbidtext
nametext
opens_edittrue/false
submittedtext
urltext

Example output

{
  "entity_type": "recording",
  "isrcs": [
    "USGF19942501"
  ],
  "mbid": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
  "name": "Smells Like Teen Spirit",
  "opens_edit": true,
  "submitted": "1 ISRC",
  "url": "https://musicbrainz.org/recording/5fb524f1-8cc8-4c04-a921-e34c0a911ea7"
}

Find recordings by ISRC

Find every recording carrying an ISRC. An ISRC is how a streaming service, a label or a royalty statement names a recording, so this is the bridge from those systems into MusicBrainz. Hyphens are optional. One code can be attached to more than one recording, so the answer is a list.

Inputs

ISRCisrctextRequired: The 12-character ISRC, with or without hyphens: two letters for the country, three for the registrant, two for the year and five for the recording.
Also includeincludelist: Extra data to bring back with each recording.One or more of: releases (Its releases), release-groups (Its release groups), discids (Disc IDs of each release), media (Discs, formats and track lists), isrcs (ISRCs of each recording), artist-credits (Who each one is credited to), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. 'Also the song's own relationships' reaches through to the work, which is where the composer and lyricist are recorded.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 4 more.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
isrctext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "recording",
  "isrc": "USGF19942501",
  "offset": 0,
  "output_detail": "full",
  "query": "ISRC USGF19942501",
  "result_count": 1,
  "results": [
    {
      "artist_credit": "Nirvana",
      "artists": [
        {
          "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "join_phrase": "",
          "name": "Nirvana",
          "sort_name": "Nirvana"
        }
      ],
      "disambiguation": null,
      "entity_type": "recording",
      "first_release_date": "1991-09-10",
      "id": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
      "isrcs": [
        "USGF19942501"
      ],
      "length": "5:01",
      "length_ms": 301133,
      "name": "Smells Like Teen Spirit",
      "requested_includes": [
        "isrcs",
        "artist-credits"
      ],
      "title": "Smells Like Teen Spirit",
      "type": null,
      "url": "https://musicbrainz.org/recording/5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
      "video": false
    }
  ],
  "total_matches": 1
}

Find what a web address is linked to

Give an artist's homepage, a Discogs page, a Wikidata item or a streaming link, and MusicBrainz answers with what it is attached to. Ask for relationships as well and the answer names the artist, release or label on the other end - which is how an outside link becomes a MusicBrainz ID. Up to 100 addresses in one step.

Inputs

Web addressresourcetextRequired: The address to look up. Several can be given, one per line or comma-separated, up to 100.
Also includeincludelist: A URL entity carries nothing but the address itself, so these rarely add anything.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of entity the address is linked to. This is the point of the step: without it you get the URL and nothing about what it points at. Pick 'Artists' for an artist page, 'Releases' for a release one.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
offsetnumber
output_detailtext
querytext
requestedlist
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "url",
  "offset": 0,
  "output_detail": "full",
  "query": "https://www.discogs.com/artist/125246",
  "requested": [
    "https://www.discogs.com/artist/125246"
  ],
  "requested_includes": [
    "artist-rels"
  ],
  "result_count": 1,
  "results": [
    {
      "disambiguation": null,
      "entity_type": "url",
      "id": "81846eca-af41-43d0-bcae-b62dbf5cfa2f",
      "name": "https://www.discogs.com/artist/125246",
      "relations": [
        {
          "attributes": [],
          "begin_date": null,
          "direction": "backward",
          "end_date": null,
          "target_id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "target_name": "Nirvana",
          "target_type": "artist",
          "type": "discogs"
        }
      ],
      "resource": "https://www.discogs.com/artist/125246",
      "type": null,
      "url": "https://musicbrainz.org/url/81846eca-af41-43d0-bcae-b62dbf5cfa2f"
    }
  ],
  "total_matches": 1
}

Find works by ISWC

Find every work carrying an ISWC. An ISWC names a composition rather than a recording of it, which is the level publishers and performing-rights societies work at. The punctuation is optional: T0702436916 and T-070.243.691-6 both work.

Inputs

ISWCiswctextRequired: The work's ISWC, with or without its punctuation.
Also includeincludelist: Extra data to bring back with each work.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
iswctext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "work",
  "iswc": "T-070.243.691-6",
  "offset": 0,
  "output_detail": "full",
  "query": "ISWC T-070.243.691-6",
  "result_count": 1,
  "results": [
    {
      "attributes": [
        {
          "type": "ASCAP ID",
          "type-id": "d833318c-6c6a-370e-8b16-9cb15873ba76",
          "value": "905650303"
        }
      ],
      "disambiguation": null,
      "entity_type": "work",
      "id": "9840e142-269d-3fa3-9805-041a9235c18a",
      "iswcs": [
        "T-070.243.691-6"
      ],
      "language": "eng",
      "languages": [
        "eng"
      ],
      "name": "Smells Like Teen Spirit",
      "relations": [
        {
          "attributes": [],
          "begin_date": null,
          "direction": "backward",
          "end_date": null,
          "target_id": "60a1f832-8ca6-4d75-ac59-cd8f7c9f0b3d",
          "target_name": "Kurt Cobain",
          "target_type": "artist",
          "type": "composer"
        }
      ],
      "requested_includes": [
        "artist-rels"
      ],
      "title": "Smells Like Teen Spirit",
      "type": "Song",
      "url": "https://musicbrainz.org/work/9840e142-269d-3fa3-9805-041a9235c18a"
    }
  ],
  "total_matches": 1
}

Get a label

Look up one record label, with its LC code, country and the years it operated. Use "List a label's releases" to page through its catalogue.

Inputs

Label IDlabel_idtextRequired: The label's MusicBrainz ID, or the address of its page.
Also includeincludelist: Extra data to bring back with the label.One or more of: releases (Its releases), discids (Disc IDs of each release), media (Discs, formats and track lists), isrcs (ISRCs of each recording), artist-credits (Who each one is credited to), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.

Outputs

addresstext
aliaseslist
annotationtext
areatext
artist_credittext
artistslist
attributeslist
barcodetext
begin_areatext
begin_datetext
cancelledtrue/false
collection_entity_typetext
countrytext
datetext
disambiguationtext
editortext
end_areatext
end_datetext
endedtrue/false
entity_typetext
first_release_datetext
gendertext
genreslist
idtext
ipislist
isnislist
iso_3166_1_codeslist
iso_3166_2_codeslist
isrcslist
iswcslist
item_countnumber
label_codenumber
labelslist
languagetext
languageslist
latitudenumber
lengthtext
length_msnumber
longitudenumber
medialist
nametext
packagingtext
primary_typetext
ratingobject
recordingslist
relationslist
release_group_idtext
release_groupslist
releaseslist
requested_includeslist
resourcetext
scorenumber
scripttext
secondary_typeslist
setlisttext
sort_nametext
statustext
tagslist
timetext
titletext
track_countnumber
typetext
urltext
user_genreslist
user_ratingobject
user_tagslist
videotrue/false
workslist

Example output

{
  "area": "United States",
  "begin_date": null,
  "country": "US",
  "disambiguation": null,
  "end_date": null,
  "ended": false,
  "entity_type": "label",
  "id": "0fadc2ce-f7de-4e27-bbe6-612b317e716b",
  "ipis": [],
  "isnis": [],
  "label_code": 7266,
  "name": "Geffen Records",
  "requested_includes": [],
  "sort_name": "Geffen Records",
  "type": "Production",
  "url": "https://musicbrainz.org/label/0fadc2ce-f7de-4e27-bbe6-612b317e716b"
}

Get a recording

Look up one recording: a single performance of a song, as it appears as a track, with its length and ISRCs. Ask for relationships to works to reach the composition, and for 'Also the song's own relationships' to get its composer and lyricist in the same request.

Inputs

Recording IDrecording_idtextRequired: The recording's MusicBrainz ID, or the address of its page. A recording is one performance, as it appears as a track.
Also includeincludelist: Extra data to bring back with the recording.One or more of: releases (Its releases), release-groups (Its release groups), discids (Disc IDs of each release), media (Discs, formats and track lists), isrcs (ISRCs of each recording), artist-credits (Who each one is credited to), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. 'Also the song's own relationships' reaches through to the work, which is where the composer and lyricist are recorded.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 4 more.

Outputs

addresstext
aliaseslist
annotationtext
areatext
artist_credittext
artistslist
attributeslist
barcodetext
begin_areatext
begin_datetext
cancelledtrue/false
collection_entity_typetext
countrytext
datetext
disambiguationtext
editortext
end_areatext
end_datetext
endedtrue/false
entity_typetext
first_release_datetext
gendertext
genreslist
idtext
ipislist
isnislist
iso_3166_1_codeslist
iso_3166_2_codeslist
isrcslist
iswcslist
item_countnumber
label_codenumber
labelslist
languagetext
languageslist
latitudenumber
lengthtext
length_msnumber
longitudenumber
medialist
nametext
packagingtext
primary_typetext
ratingobject
recordingslist
relationslist
release_group_idtext
release_groupslist
releaseslist
requested_includeslist
resourcetext
scorenumber
scripttext
secondary_typeslist
setlisttext
sort_nametext
statustext
tagslist
timetext
titletext
track_countnumber
typetext
urltext
user_genreslist
user_ratingobject
user_tagslist
videotrue/false
workslist

Example output

{
  "artist_credit": "Nirvana",
  "artists": [
    {
      "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
      "join_phrase": "",
      "name": "Nirvana",
      "sort_name": "Nirvana"
    }
  ],
  "disambiguation": null,
  "entity_type": "recording",
  "first_release_date": "1991-09-10",
  "id": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
  "isrcs": [
    "USGF19942501"
  ],
  "length": "5:01",
  "length_ms": 301133,
  "name": "Smells Like Teen Spirit",
  "requested_includes": [
    "isrcs",
    "artist-credits"
  ],
  "title": "Smells Like Teen Spirit",
  "type": null,
  "url": "https://musicbrainz.org/recording/5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
  "video": false
}

Get a release

Look up one release: a specific issue of an album, with its own barcode, catalogue number, country, packaging and track list. Include "Discs, formats and track lists" to get the tracks themselves. For the album as a thing in its own right, across every issue of it, use "Get a release group" instead.

Inputs

Release IDrelease_idtextRequired: The release's MusicBrainz ID, or the address of its page. A release is one issue of an album; the ID of the album itself is a release group ID and will not be found here.
Also includeincludelist: Extra data to bring back with the release. 'Discs, formats and track lists' is what returns the tracks.One or more of: collections (Collections it appears in), labels (The labels that issued it), recordings (Its recordings), release-groups (Its release groups), discids (Disc IDs of each release), media (Discs, formats and track lists), isrcs (ISRCs of each recording), artist-credits (Who each one is credited to), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. The last three options follow the relationships one hop further, into the release's tracks, its release group, and the songs those tracks are performances of - which is how 'who played guitar on track 4' is answered.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 6 more.

Outputs

addresstext
aliaseslist
annotationtext
areatext
artist_credittext
artistslist
attributeslist
barcodetext
begin_areatext
begin_datetext
cancelledtrue/false
collection_entity_typetext
countrytext
datetext
disambiguationtext
editortext
end_areatext
end_datetext
endedtrue/false
entity_typetext
first_release_datetext
gendertext
genreslist
idtext
ipislist
isnislist
iso_3166_1_codeslist
iso_3166_2_codeslist
isrcslist
iswcslist
item_countnumber
label_codenumber
labelslist
languagetext
languageslist
latitudenumber
lengthtext
length_msnumber
longitudenumber
medialist
nametext
packagingtext
primary_typetext
ratingobject
recordingslist
relationslist
release_group_idtext
release_groupslist
releaseslist
requested_includeslist
resourcetext
scorenumber
scripttext
secondary_typeslist
setlisttext
sort_nametext
statustext
tagslist
timetext
titletext
track_countnumber
typetext
urltext
user_genreslist
user_ratingobject
user_tagslist
videotrue/false
workslist

Example output

{
  "artist_credit": "Nirvana",
  "artists": [
    {
      "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
      "join_phrase": "",
      "name": "Nirvana",
      "sort_name": "Nirvana"
    }
  ],
  "barcode": "0720642442524",
  "country": "US",
  "date": "1991-09-24",
  "disambiguation": null,
  "entity_type": "release",
  "id": "8e061dc4-790e-4587-ba53-011e7852f88d",
  "labels": [
    {
      "catalog_number": "GED24425",
      "label": "Geffen Records",
      "label_id": "0fadc2ce-f7de-4e27-bbe6-612b317e716b"
    }
  ],
  "language": "eng",
  "media": [
    {
      "disc_ids": [
        "2y0jFMwYQP7gb9iSUKagmoT6DIw-"
      ],
      "format": "CD",
      "position": 1,
      "title": null,
      "track_count": 12,
      "tracks": [
        {
          "length": "5:01",
          "length_ms": 301133,
          "number": "1",
          "position": 1,
          "recording_id": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
          "title": "Smells Like Teen Spirit"
        }
      ]
    }
  ],
  "name": "Nevermind",
  "packaging": "Jewel Case",
  "release_group_id": "1b022e01-4da6-387b-8658-8678046e4cef",
  "requested_includes": [
    "recordings",
    "release-groups",
    "media",
    "labels",
    "artist-credits"
  ],
  "script": "Latn",
  "status": "Official",
  "title": "Nevermind",
  "track_count": 12,
  "type": null,
  "url": "https://musicbrainz.org/release/8e061dc4-790e-4587-ba53-011e7852f88d"
}

Get a release group

Look up one release group: an album, single or EP as a thing in its own right, with its type and the date it first came out. This is what to use when you mean 'the album' rather than one particular pressing of it.

Inputs

Release group IDrelease_group_idtextRequired: The release group's MusicBrainz ID, or the address of its page. A release group is the album itself, across every issue of it.
Also includeincludelist: Extra data to bring back with the release group.One or more of: releases (Its releases), discids (Disc IDs of each release), media (Discs, formats and track lists), isrcs (ISRCs of each recording), artist-credits (Who each one is credited to), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.

Outputs

addresstext
aliaseslist
annotationtext
areatext
artist_credittext
artistslist
attributeslist
barcodetext
begin_areatext
begin_datetext
cancelledtrue/false
collection_entity_typetext
countrytext
datetext
disambiguationtext
editortext
end_areatext
end_datetext
endedtrue/false
entity_typetext
first_release_datetext
gendertext
genreslist
idtext
ipislist
isnislist
iso_3166_1_codeslist
iso_3166_2_codeslist
isrcslist
iswcslist
item_countnumber
label_codenumber
labelslist
languagetext
languageslist
latitudenumber
lengthtext
length_msnumber
longitudenumber
medialist
nametext
packagingtext
primary_typetext
ratingobject
recordingslist
relationslist
release_group_idtext
release_groupslist
releaseslist
requested_includeslist
resourcetext
scorenumber
scripttext
secondary_typeslist
setlisttext
sort_nametext
statustext
tagslist
timetext
titletext
track_countnumber
typetext
urltext
user_genreslist
user_ratingobject
user_tagslist
videotrue/false
workslist

Example output

{
  "artist_credit": "Nirvana",
  "artists": [
    {
      "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
      "join_phrase": "",
      "name": "Nirvana",
      "sort_name": "Nirvana"
    }
  ],
  "disambiguation": null,
  "entity_type": "release-group",
  "first_release_date": "1991-09-24",
  "id": "1b022e01-4da6-387b-8658-8678046e4cef",
  "name": "Nevermind",
  "primary_type": "Album",
  "requested_includes": [],
  "secondary_types": [],
  "title": "Nevermind",
  "type": null,
  "url": "https://musicbrainz.org/release-group/1b022e01-4da6-387b-8658-8678046e4cef"
}

Get a work

Look up one work: the composition itself, which every recording of it points back to, with its ISWCs and lyrics languages. Ask for relationships to artists to get the composer, lyricist and publisher.

Inputs

Work IDwork_idtextRequired: The work's MusicBrainz ID, or the address of its page. A work is the song as written, which every recording of it points back to.
Also includeincludelist: Extra data to bring back with the work.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.

Outputs

addresstext
aliaseslist
annotationtext
areatext
artist_credittext
artistslist
attributeslist
barcodetext
begin_areatext
begin_datetext
cancelledtrue/false
collection_entity_typetext
countrytext
datetext
disambiguationtext
editortext
end_areatext
end_datetext
endedtrue/false
entity_typetext
first_release_datetext
gendertext
genreslist
idtext
ipislist
isnislist
iso_3166_1_codeslist
iso_3166_2_codeslist
isrcslist
iswcslist
item_countnumber
label_codenumber
labelslist
languagetext
languageslist
latitudenumber
lengthtext
length_msnumber
longitudenumber
medialist
nametext
packagingtext
primary_typetext
ratingobject
recordingslist
relationslist
release_group_idtext
release_groupslist
releaseslist
requested_includeslist
resourcetext
scorenumber
scripttext
secondary_typeslist
setlisttext
sort_nametext
statustext
tagslist
timetext
titletext
track_countnumber
typetext
urltext
user_genreslist
user_ratingobject
user_tagslist
videotrue/false
workslist

Example output

{
  "attributes": [
    {
      "type": "ASCAP ID",
      "type-id": "d833318c-6c6a-370e-8b16-9cb15873ba76",
      "value": "905650303"
    }
  ],
  "disambiguation": null,
  "entity_type": "work",
  "id": "9840e142-269d-3fa3-9805-041a9235c18a",
  "iswcs": [
    "T-070.243.691-6"
  ],
  "language": "eng",
  "languages": [
    "eng"
  ],
  "name": "Smells Like Teen Spirit",
  "relations": [
    {
      "attributes": [],
      "begin_date": null,
      "direction": "backward",
      "end_date": null,
      "target_id": "60a1f832-8ca6-4d75-ac59-cd8f7c9f0b3d",
      "target_name": "Kurt Cobain",
      "target_type": "artist",
      "type": "composer"
    }
  ],
  "requested_includes": [
    "artist-rels"
  ],
  "title": "Smells Like Teen Spirit",
  "type": "Song",
  "url": "https://musicbrainz.org/work/9840e142-269d-3fa3-9805-041a9235c18a"
}

Get an artist

Look up everything MusicBrainz holds about one artist: their type, country, the years they were active, their aliases in other scripts, and their IPI and ISNI codes. Ask for relationships to URLs to get their official site, streaming pages and Discogs entry, or to artists to get the band's membership. Needs the artist's MusicBrainz ID, which "Search for artists" returns.

Inputs

Artist IDartist_idtextRequired: The artist's MusicBrainz ID, or the musicbrainz.org address of their page. 'Search for artists' returns the ID of each match.
Also includeincludelist: Extra data to bring back with the artist. The linked lists are capped at 25 by MusicBrainz however many there are; use "List an artist's releases" and its siblings to page through them all.One or more of: recordings (Its recordings), releases (Its releases), release-groups (Its release groups), works (Its works), discids (Disc IDs of each release), media (Discs, formats and track lists), isrcs (ISRCs of each recording), artist-credits (Who each one is credited to), various-artists (Only various-artist appearances), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.

Outputs

addresstext
aliaseslist
annotationtext
areatext
artist_credittext
artistslist
attributeslist
barcodetext
begin_areatext
begin_datetext
cancelledtrue/false
collection_entity_typetext
countrytext
datetext
disambiguationtext
editortext
end_areatext
end_datetext
endedtrue/false
entity_typetext
first_release_datetext
gendertext
genreslist
idtext
ipislist
isnislist
iso_3166_1_codeslist
iso_3166_2_codeslist
isrcslist
iswcslist
item_countnumber
label_codenumber
labelslist
languagetext
languageslist
latitudenumber
lengthtext
length_msnumber
longitudenumber
medialist
nametext
packagingtext
primary_typetext
ratingobject
recordingslist
relationslist
release_group_idtext
release_groupslist
releaseslist
requested_includeslist
resourcetext
scorenumber
scripttext
secondary_typeslist
setlisttext
sort_nametext
statustext
tagslist
timetext
titletext
track_countnumber
typetext
urltext
user_genreslist
user_ratingobject
user_tagslist
videotrue/false
workslist

Example output

{
  "area": "United States",
  "begin_area": "Aberdeen",
  "begin_date": "1987",
  "country": "US",
  "disambiguation": "1980s-1990s US grunge band",
  "end_area": null,
  "end_date": "1994-04-05",
  "ended": true,
  "entity_type": "artist",
  "gender": null,
  "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
  "ipis": [],
  "isnis": [
    "0000000123486830"
  ],
  "name": "Nirvana",
  "rating": {
    "value": 4.6,
    "votes": 46
  },
  "requested_includes": [
    "tags",
    "ratings"
  ],
  "sort_name": "Nirvana",
  "tags": [
    {
      "count": 12,
      "name": "grunge"
    },
    {
      "count": 9,
      "name": "alternative rock"
    }
  ],
  "type": "Group",
  "url": "https://musicbrainz.org/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da"
}

Get any entity by ID

Look up any MusicBrainz entity by its kind and ID. The dedicated steps cover artists, releases, release groups, recordings, works and labels with options of their own; this one reaches the rest - areas, events, places, instruments, series, genres, URLs and collections.

Inputs

Kind of thingentity_typetextRequired: Which kind of MusicBrainz entity the ID names.One of: area (Area - a country, city or region), artist (Artist - a person, group or orchestra), event (Event - a concert or festival), genre (Genre - one of MusicBrainz's genre entries), instrument, label (Label - a record label or imprint), place (Place - a venue, studio or stadium), recording (Recording - one performance, as a track), release (Release - one issue of an album, with its own barcode), release-group (Release group - an album, across all its issues), and 4 more.
MusicBrainz IDmbidtextRequired: The entity's MusicBrainz ID, or the musicbrainz.org address of its page. It must be an ID of the kind chosen above: MusicBrainz IDs are not shared between kinds of entity.
Also includeincludelist: Extra data to bring back with the entity. These two are what every kind of entity accepts.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.

Outputs

addresstext
aliaseslist
annotationtext
areatext
artist_credittext
artistslist
attributeslist
barcodetext
begin_areatext
begin_datetext
cancelledtrue/false
collection_entity_typetext
countrytext
datetext
disambiguationtext
editortext
end_areatext
end_datetext
endedtrue/false
entity_typetext
first_release_datetext
gendertext
genreslist
idtext
ipislist
isnislist
iso_3166_1_codeslist
iso_3166_2_codeslist
isrcslist
iswcslist
item_countnumber
label_codenumber
labelslist
languagetext
languageslist
latitudenumber
lengthtext
length_msnumber
longitudenumber
medialist
nametext
packagingtext
primary_typetext
ratingobject
recordingslist
relationslist
release_group_idtext
release_groupslist
releaseslist
requested_includeslist
resourcetext
scorenumber
scripttext
secondary_typeslist
setlisttext
sort_nametext
statustext
tagslist
timetext
titletext
track_countnumber
typetext
urltext
user_genreslist
user_ratingobject
user_tagslist
videotrue/false
workslist

Example output

{
  "address": "3 Abbey Road, St John\u2019s Wood, London",
  "area": "St John's Wood",
  "begin_date": "1931-11-12",
  "disambiguation": null,
  "end_date": null,
  "ended": false,
  "entity_type": "place",
  "id": "bd55aeb7-19d1-4607-a500-14b8479d3fed",
  "latitude": 51.53192,
  "longitude": -0.17835,
  "name": "Abbey Road Studios",
  "requested_includes": [],
  "type": "Studio",
  "url": "https://musicbrainz.org/place/bd55aeb7-19d1-4607-a500-14b8479d3fed"
}

Get cover art

Fetch the artwork the Cover Art Archive holds for a release or an album. The archive is MusicBrainz's own image companion, keyed by the same IDs, and is where MusicBrainz's cover images come from. Each image comes back with its full-size address and both thumbnail sizes, so a workflow can put a cover straight into a message or a document without downloading it.

Inputs

Artwork forentity_typetext: Ask about a release group to get the album's representative artwork, whichever pressing it comes from; ask about a release to get that one issue's.One of: release (Release - the artwork of one specific issue), release-group (Release group - the album's representative artwork). Default: release.
MusicBrainz IDmbidtextRequired: The release or release group's MusicBrainz ID, or the address of its page.
Only this kind of imageimage_typetext: Return only images the archive labels this way. Leave blank for all of them; the front cover is reported separately either way.One of: Front, Back, Booklet, Medium, Tray, Obi, Spine, Track, Liner, Sticker, and 4 more.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
front_image_urltext
front_thumbnail_urltext
image_countnumber
image_typetext
imageslist
mbidtext
output_detailtext
urltext

Example output

{
  "entity_type": "release",
  "front_image_url": "https://coverartarchive.org/release/8e061dc4-790e-4587-ba53-011e7852f88d/1675283488.jpg",
  "front_thumbnail_url": "https://coverartarchive.org/release/8e061dc4-790e-4587-ba53-011e7852f88d/1675283488-500.jpg",
  "image_count": 1,
  "image_type": null,
  "images": [
    {
      "approved": true,
      "comment": null,
      "id": "1675283488",
      "image_url": "https://coverartarchive.org/release/8e061dc4-790e-4587-ba53-011e7852f88d/1675283488.jpg",
      "is_back": false,
      "is_front": true,
      "thumbnail_large_url": "https://coverartarchive.org/release/8e061dc4-790e-4587-ba53-011e7852f88d/1675283488-500.jpg",
      "thumbnail_small_url": "https://coverartarchive.org/release/8e061dc4-790e-4587-ba53-011e7852f88d/1675283488-250.jpg",
      "types": [
        "Front"
      ]
    }
  ],
  "mbid": "8e061dc4-790e-4587-ba53-011e7852f88d",
  "output_detail": "full",
  "url": "https://musicbrainz.org/release/8e061dc4-790e-4587-ba53-011e7852f88d"
}

Get my MusicBrainz account

Report which MusicBrainz account this integration is connected as. The account name identifies an editor everywhere else in the API: it owns your collections, and it is whose tags and ratings the 'your tags' and 'your rating' includes return.

Inputs

None.

Outputs

emailtext
gendertext
metabrainz_user_idnumber
profile_urltext
timezonetext
usernametext
websitetext

Example output

{
  "email": null,
  "gender": null,
  "metabrainz_user_id": 1234567,
  "profile_url": "https://musicbrainz.org/user/lodol_qa",
  "timezone": "UTC",
  "username": "lodol_qa",
  "website": null
}

Identify a CD by disc ID

Turn a CD in a drive into the release it actually is. A disc ID is a hash of the disc's track layout, which every CD ripper computes; MusicBrainz matches it against the pressings it knows. Supply the table of contents as well and a disc MusicBrainz has never seen can still be matched against discs of a similar shape.

Inputs

Disc IDdisc_idtext: The disc ID your CD ripper reported. Leave blank to match on the table of contents alone.
Table of contentstoctext: The disc's table of contents: the first track number, the number of tracks, the leadout offset, then each track's offset. Space- or plus-separated. Used to match a disc MusicBrainz does not hold the ID for.
Also includeincludelist: Extra data to bring back with each release. A disc ID lookup already carries each release's discs and track counts, which is what the disc was matched against.One or more of: collections (Collections it appears in), labels (The labels that issued it), recordings (Its recordings), release-groups (Its release groups), discids (Disc IDs of each release), isrcs (ISRCs of each recording), artist-credits (Who each one is credited to), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. The last three options follow the relationships one hop further, into the release's tracks, its release group, and the songs those tracks are performances of - which is how 'who played guitar on track 4' is answered.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 6 more.
Include CD stubsinclude_cd_stubstrue/false: Also return CD stubs: bare tracklists submitted for discs that have no release in MusicBrainz yet. On by default, which is MusicBrainz's own behaviour.Default: true.
Match any mediumany_media_formattrue/false: When matching on the table of contents, also consider media that are not CDs. Off by default.Default: false.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

cd_stubslist
disc_idtext
entity_typetext
offsetnumber
offsetslist
output_detailtext
querytext
result_countnumber
resultslist
sectorsnumber
total_matchesnumber

Example output

{
  "cd_stubs": [],
  "disc_id": "2y0jFMwYQP7gb9iSUKagmoT6DIw-",
  "entity_type": "release",
  "offset": 0,
  "offsets": [
    150,
    22767,
    41887
  ],
  "output_detail": "full",
  "query": "disc ID 2y0jFMwYQP7gb9iSUKagmoT6DIw-",
  "result_count": 1,
  "results": [
    {
      "artist_credit": "Nirvana",
      "artists": [
        {
          "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "join_phrase": "",
          "name": "Nirvana",
          "sort_name": "Nirvana"
        }
      ],
      "barcode": "0720642442524",
      "country": "US",
      "date": "1991-09-24",
      "disambiguation": null,
      "entity_type": "release",
      "id": "8e061dc4-790e-4587-ba53-011e7852f88d",
      "labels": [
        {
          "catalog_number": "GED24425",
          "label": "Geffen Records",
          "label_id": "0fadc2ce-f7de-4e27-bbe6-612b317e716b"
        }
      ],
      "language": "eng",
      "media": [
        {
          "disc_ids": [
            "2y0jFMwYQP7gb9iSUKagmoT6DIw-"
          ],
          "format": "CD",
          "position": 1,
          "title": null,
          "track_count": 12,
          "tracks": [
            {
              "length": "5:01",
              "length_ms": 301133,
              "number": "1",
              "position": 1,
              "recording_id": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
              "title": "Smells Like Teen Spirit"
            }
          ]
        }
      ],
      "name": "Nevermind",
      "packaging": "Jewel Case",
      "release_group_id": "1b022e01-4da6-387b-8658-8678046e4cef",
      "requested_includes": [
        "recordings",
        "release-groups",
        "media",
        "labels",
        "artist-credits"
      ],
      "script": "Latn",
      "status": "Official",
      "title": "Nevermind",
      "track_count": 12,
      "type": null,
      "url": "https://musicbrainz.org/release/8e061dc4-790e-4587-ba53-011e7852f88d"
    }
  ],
  "sectors": 267225,
  "total_matches": 1
}

List artists linked to something

List the artists linked to an area, a release, a recording, a work or a collection. Browsing an area's artists is how you get every act from a city.

Inputs

Artists linked tolinked_totextRequired: What to list the artists of.One of: area (An area), collection (A collection), recording (A recording), release (A release), release-group (A release group), work (A work).
Its MusicBrainz IDlinked_idtextRequired: The MusicBrainz ID of the thing chosen above, or the address of its page. Browsing needs the ID: it is a direct lookup of what is linked to that one thing, not a search by name.
Also includeincludelist: Extra data to bring back with each artist.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
linked_idtext
linked_totext
offsetnumber
output_detailtext
querytext
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "artist",
  "linked_id": "8e061dc4-790e-4587-ba53-011e7852f88d",
  "linked_to": "release",
  "offset": 0,
  "output_detail": "full",
  "query": "release 8e061dc4-790e-4587-ba53-011e7852f88d",
  "requested_includes": [],
  "result_count": 1,
  "results": [
    {
      "area": "United States",
      "begin_area": "Aberdeen",
      "begin_date": "1987",
      "country": "US",
      "disambiguation": "1980s-1990s US grunge band",
      "end_area": null,
      "end_date": "1994-04-05",
      "ended": true,
      "entity_type": "artist",
      "gender": null,
      "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
      "ipis": [],
      "isnis": [
        "0000000123486830"
      ],
      "name": "Nirvana",
      "rating": {
        "value": 4.6,
        "votes": 46
      },
      "requested_includes": [
        "tags",
        "ratings"
      ],
      "sort_name": "Nirvana",
      "tags": [
        {
          "count": 12,
          "name": "grunge"
        },
        {
          "count": 9,
          "name": "alternative rock"
        }
      ],
      "type": "Group",
      "url": "https://musicbrainz.org/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da"
    }
  ],
  "total_matches": 1
}

List collections

List an editor's collections with how many things are in each, and which kind of thing each one holds. Left blank, the editor is whichever account this integration is connected as. Name another editor to see their public collections; private ones are only ever visible to their owner. To read what is inside one, take its ID into a browse step and pick 'A collection' as what to list it for.

Inputs

Editoreditortext: A MusicBrainz account name. Leave blank for your own, which is read from the connection.
Include my private collectionsinclude_privatetrue/false: Include collections you have not made public. On by default, and it has no effect when another editor is named: theirs stay private to them.Default: true.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

editortext
entity_typetext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "editor": "lodol_qa",
  "entity_type": "collection",
  "offset": 0,
  "output_detail": "full",
  "query": "editor lodol_qa",
  "result_count": 1,
  "results": [
    {
      "collection_entity_type": "release",
      "disambiguation": null,
      "editor": "lodol_qa",
      "entity_type": "collection",
      "id": "f4784850-3844-11e0-9e42-0800200c9a66",
      "item_count": 42,
      "name": "Albums I own",
      "type": "Release",
      "url": "https://musicbrainz.org/collection/f4784850-3844-11e0-9e42-0800200c9a66"
    }
  ],
  "total_matches": 1
}

List events linked to something

List the concerts and festivals linked to an artist, a venue, an area or a collection. An event carries its date and, when an editor has added one, its setlist.

Inputs

Events linked tolinked_totextRequired: What to list the events of.One of: area (An area), artist (An artist), collection (A collection), place (A place).
Its MusicBrainz IDlinked_idtextRequired: The MusicBrainz ID of the thing chosen above, or the address of its page. Browsing needs the ID: it is a direct lookup of what is linked to that one thing, not a search by name.
Also includeincludelist: Extra data to bring back with each event.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
linked_idtext
linked_totext
offsetnumber
output_detailtext
querytext
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "event",
  "linked_id": "bd55aeb7-19d1-4607-a500-14b8479d3fed",
  "linked_to": "place",
  "offset": 0,
  "output_detail": "full",
  "query": "place bd55aeb7-19d1-4607-a500-14b8479d3fed",
  "requested_includes": [],
  "result_count": 1,
  "results": [
    {
      "begin_date": "1994-06-24",
      "cancelled": false,
      "disambiguation": null,
      "end_date": "1994-06-26",
      "ended": true,
      "entity_type": "event",
      "id": "fe4ba1b3-1c1a-4d0c-b0fa-4e4bf46b1e3e",
      "name": "Glastonbury Festival 1994",
      "setlist": null,
      "time": null,
      "type": "Festival",
      "url": "https://musicbrainz.org/event/fe4ba1b3-1c1a-4d0c-b0fa-4e4bf46b1e3e"
    }
  ],
  "total_matches": 12
}

List genres

List MusicBrainz's own genre vocabulary, alphabetically, with the ID of each. Genres are the curated part of the tag vocabulary, so these are the values worth filtering a search by. There are a couple of thousand, so the list is paged.

Inputs

Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
genreslist
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "genre",
  "genres": [
    {
      "disambiguation": null,
      "entity_type": "genre",
      "id": "ed7a92ce-25f6-4b4a-9d5b-1a3b9c9bd1cf",
      "name": "grunge",
      "type": null,
      "url": "https://musicbrainz.org/genre/ed7a92ce-25f6-4b4a-9d5b-1a3b9c9bd1cf"
    }
  ],
  "offset": 0,
  "output_detail": "full",
  "result_count": 1,
  "results": [
    {
      "disambiguation": null,
      "entity_type": "genre",
      "id": "ed7a92ce-25f6-4b4a-9d5b-1a3b9c9bd1cf",
      "name": "grunge",
      "type": null,
      "url": "https://musicbrainz.org/genre/ed7a92ce-25f6-4b4a-9d5b-1a3b9c9bd1cf"
    }
  ],
  "total_matches": 2192
}

List labels linked to something

List the labels based in an area, the labels that issued one release, or the contents of a collection of labels.

Inputs

Labels linked tolinked_totextRequired: What to list the labels of.One of: area (An area), collection (A collection), release (A release).
Its MusicBrainz IDlinked_idtextRequired: The MusicBrainz ID of the thing chosen above, or the address of its page. Browsing needs the ID: it is a direct lookup of what is linked to that one thing, not a search by name.
Also includeincludelist: Extra data to bring back with each label.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
linked_idtext
linked_totext
offsetnumber
output_detailtext
querytext
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "label",
  "linked_id": "8e061dc4-790e-4587-ba53-011e7852f88d",
  "linked_to": "release",
  "offset": 0,
  "output_detail": "full",
  "query": "release 8e061dc4-790e-4587-ba53-011e7852f88d",
  "requested_includes": [],
  "result_count": 1,
  "results": [
    {
      "area": "United States",
      "begin_date": null,
      "country": "US",
      "disambiguation": null,
      "end_date": null,
      "ended": false,
      "entity_type": "label",
      "id": "0fadc2ce-f7de-4e27-bbe6-612b317e716b",
      "ipis": [],
      "isnis": [],
      "label_code": 7266,
      "name": "Geffen Records",
      "requested_includes": [],
      "sort_name": "Geffen Records",
      "type": "Production",
      "url": "https://musicbrainz.org/label/0fadc2ce-f7de-4e27-bbe6-612b317e716b"
    }
  ],
  "total_matches": 1
}

List places linked to something

List the venues, studios and stadiums in an area, or the contents of a collection of places. Each place carries its address and coordinates.

Inputs

Places linked tolinked_totextRequired: What to list the places of.One of: area (An area), collection (A collection).
Its MusicBrainz IDlinked_idtextRequired: The MusicBrainz ID of the thing chosen above, or the address of its page. Browsing needs the ID: it is a direct lookup of what is linked to that one thing, not a search by name.
Also includeincludelist: Extra data to bring back with each place.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
linked_idtext
linked_totext
offsetnumber
output_detailtext
querytext
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "place",
  "linked_id": "f03d09b3-39dc-4083-afd6-159e3f0d462f",
  "linked_to": "area",
  "offset": 0,
  "output_detail": "full",
  "query": "area f03d09b3-39dc-4083-afd6-159e3f0d462f",
  "requested_includes": [],
  "result_count": 1,
  "results": [
    {
      "address": "3 Abbey Road, St John\u2019s Wood, London",
      "area": "St John's Wood",
      "begin_date": "1931-11-12",
      "disambiguation": null,
      "end_date": null,
      "ended": false,
      "entity_type": "place",
      "id": "bd55aeb7-19d1-4607-a500-14b8479d3fed",
      "latitude": 51.53192,
      "longitude": -0.17835,
      "name": "Abbey Road Studios",
      "requested_includes": [],
      "type": "Studio",
      "url": "https://musicbrainz.org/place/bd55aeb7-19d1-4607-a500-14b8479d3fed"
    }
  ],
  "total_matches": 2422
}

List recordings linked to something

List the recordings linked to an artist, the tracks on a release, every recording of one work, or the contents of a collection. Listing a work's recordings is how you find every cover and live version of a song.

Inputs

Recordings linked tolinked_totextRequired: What to list the recordings of.One of: artist (An artist), collection (A collection), release (A release), work (A work).
Its MusicBrainz IDlinked_idtextRequired: The MusicBrainz ID of the thing chosen above, or the address of its page. Browsing needs the ID: it is a direct lookup of what is linked to that one thing, not a search by name.
Also includeincludelist: Extra data to bring back with each recording.One or more of: artist-credits (Who each one is credited to), isrcs (ISRCs of each recording), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
linked_idtext
linked_totext
offsetnumber
output_detailtext
querytext
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "recording",
  "linked_id": "9840e142-269d-3fa3-9805-041a9235c18a",
  "linked_to": "work",
  "offset": 0,
  "output_detail": "full",
  "query": "work 9840e142-269d-3fa3-9805-041a9235c18a",
  "requested_includes": [],
  "result_count": 1,
  "results": [
    {
      "artist_credit": "Nirvana",
      "artists": [
        {
          "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "join_phrase": "",
          "name": "Nirvana",
          "sort_name": "Nirvana"
        }
      ],
      "disambiguation": null,
      "entity_type": "recording",
      "first_release_date": "1991-09-10",
      "id": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
      "isrcs": [
        "USGF19942501"
      ],
      "length": "5:01",
      "length_ms": 301133,
      "name": "Smells Like Teen Spirit",
      "requested_includes": [
        "isrcs",
        "artist-credits"
      ],
      "title": "Smells Like Teen Spirit",
      "type": null,
      "url": "https://musicbrainz.org/recording/5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
      "video": false
    }
  ],
  "total_matches": 318
}

List release groups linked to something

List an artist's albums, singles and EPs, the release groups one release belongs to, or the contents of a collection. Filter by type to get just the studio albums and leave out the singles and compilations.

Inputs

Release groups linked tolinked_totextRequired: What to list the release groups of.One of: artist (An artist), collection (A collection), release (A release).
Its MusicBrainz IDlinked_idtextRequired: The MusicBrainz ID of the thing chosen above, or the address of its page. Browsing needs the ID: it is a direct lookup of what is linked to that one thing, not a search by name.
Typerelease_typetext: Only list release groups of this kind.One of: album, single, ep, broadcast, other, audio drama, audiobook, compilation, demo, dj-mix, and 7 more.
Also includeincludelist: Extra data to bring back with each release group.One or more of: artist-credits (Who each one is credited to), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
linked_idtext
linked_totext
offsetnumber
output_detailtext
querytext
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "release-group",
  "linked_id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
  "linked_to": "artist",
  "offset": 0,
  "output_detail": "full",
  "query": "artist 5b11f4ce-a62d-471e-81fc-a69a8278c7da",
  "requested_includes": [],
  "result_count": 1,
  "results": [
    {
      "artist_credit": "Nirvana",
      "artists": [
        {
          "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "join_phrase": "",
          "name": "Nirvana",
          "sort_name": "Nirvana"
        }
      ],
      "disambiguation": null,
      "entity_type": "release-group",
      "first_release_date": "1991-09-24",
      "id": "1b022e01-4da6-387b-8658-8678046e4cef",
      "name": "Nevermind",
      "primary_type": "Album",
      "requested_includes": [],
      "secondary_types": [],
      "title": "Nevermind",
      "type": null,
      "url": "https://musicbrainz.org/release-group/1b022e01-4da6-387b-8658-8678046e4cef"
    }
  ],
  "total_matches": 433
}

List releases linked to something

List every release directly linked to one thing: an artist's discography, a label's catalogue, every issue of an album, or the contents of a collection. Filter to just the official albums, or just the live bootlegs. This is a direct lookup rather than a search, so it needs that thing's MusicBrainz ID.

Inputs

Releases linked tolinked_totextRequired: What to list the releases of. 'An artist credited on a track only' finds the compilations and guest spots an artist appears on without being credited for the release as a whole.One of: area (An area), artist (An artist), collection (A collection), label (A label), track (A track), track_artist (An artist credited on a track only), recording (A recording), release-group (A release group).
Its MusicBrainz IDlinked_idtextRequired: The MusicBrainz ID of the thing chosen above, or the address of its page. Browsing needs the ID: it is a direct lookup of what is linked to that one thing, not a search by name.
Statusstatustext: Only list releases of this status. 'Official' is what excludes bootlegs and promos.One of: official, promotion (Promotional), bootleg, pseudo-release (Pseudo-release (a translation or transliteration)), withdrawn, cancelled.
Typerelease_typetext: Only list releases of this kind.One of: album, single, ep, broadcast, other, audio drama, audiobook, compilation, demo, dj-mix, and 7 more.
Also includeincludelist: Extra data to bring back with each release.One or more of: artist-credits (Who each one is credited to), labels (The labels that issued it), recordings (Its recordings), release-groups (Its release groups), media (Discs, formats and track lists), discids (Disc IDs of each release), isrcs (ISRCs of each recording), aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
linked_idtext
linked_totext
offsetnumber
output_detailtext
querytext
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "release",
  "linked_id": "1b022e01-4da6-387b-8658-8678046e4cef",
  "linked_to": "release-group",
  "offset": 0,
  "output_detail": "full",
  "query": "release-group 1b022e01-4da6-387b-8658-8678046e4cef",
  "requested_includes": [],
  "result_count": 1,
  "results": [
    {
      "artist_credit": "Nirvana",
      "artists": [
        {
          "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "join_phrase": "",
          "name": "Nirvana",
          "sort_name": "Nirvana"
        }
      ],
      "barcode": "0720642442524",
      "country": "US",
      "date": "1991-09-24",
      "disambiguation": null,
      "entity_type": "release",
      "id": "8e061dc4-790e-4587-ba53-011e7852f88d",
      "labels": [
        {
          "catalog_number": "GED24425",
          "label": "Geffen Records",
          "label_id": "0fadc2ce-f7de-4e27-bbe6-612b317e716b"
        }
      ],
      "language": "eng",
      "media": [
        {
          "disc_ids": [
            "2y0jFMwYQP7gb9iSUKagmoT6DIw-"
          ],
          "format": "CD",
          "position": 1,
          "title": null,
          "track_count": 12,
          "tracks": [
            {
              "length": "5:01",
              "length_ms": 301133,
              "number": "1",
              "position": 1,
              "recording_id": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
              "title": "Smells Like Teen Spirit"
            }
          ]
        }
      ],
      "name": "Nevermind",
      "packaging": "Jewel Case",
      "release_group_id": "1b022e01-4da6-387b-8658-8678046e4cef",
      "requested_includes": [
        "recordings",
        "release-groups",
        "media",
        "labels",
        "artist-credits"
      ],
      "script": "Latn",
      "status": "Official",
      "title": "Nevermind",
      "track_count": 12,
      "type": null,
      "url": "https://musicbrainz.org/release/8e061dc4-790e-4587-ba53-011e7852f88d"
    }
  ],
  "total_matches": 92
}

List works linked to something

List the works linked to an artist, or the contents of a collection of works. An artist's works are the songs they wrote or performed, as compositions rather than recordings.

Inputs

Works linked tolinked_totextRequired: What to list the works of.One of: artist (An artist), collection (A collection).
Its MusicBrainz IDlinked_idtextRequired: The MusicBrainz ID of the thing chosen above, or the address of its page. Browsing needs the ID: it is a direct lookup of what is linked to that one thing, not a search by name.
Also includeincludelist: Extra data to bring back with each work.One or more of: aliases (Alternate and localised names), annotation (The editors' annotation).
Include community datacommunitylist: What other MusicBrainz editors have said about it. 'Your' tags, genres and rating are the ones this connected account submitted, and are the only way to read those back.One or more of: tags (Tags everyone has applied), genres (Genres everyone has applied), ratings (The community's average rating), user-tags (Tags you applied), user-genres (Genres you applied), user-ratings (Your own rating).
Include relationships torelationshipslist: Which kinds of linked entity to bring back. Relationships are how MusicBrainz records who played on what, which label released it, and where its official site and streaming pages are; pick 'URLs' to get the links out to other services.One or more of: area (Areas), artist (Artists (members, producers, performers)), event (Events), genre (Genres), instrument (Instruments), label (Labels), place (Places), recording (Recordings), release (Releases), release-group (Release groups), and 3 more.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
linked_idtext
linked_totext
offsetnumber
output_detailtext
querytext
requested_includeslist
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "work",
  "linked_id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
  "linked_to": "artist",
  "offset": 0,
  "output_detail": "full",
  "query": "artist 5b11f4ce-a62d-471e-81fc-a69a8278c7da",
  "requested_includes": [],
  "result_count": 1,
  "results": [
    {
      "attributes": [
        {
          "type": "ASCAP ID",
          "type-id": "d833318c-6c6a-370e-8b16-9cb15873ba76",
          "value": "905650303"
        }
      ],
      "disambiguation": null,
      "entity_type": "work",
      "id": "9840e142-269d-3fa3-9805-041a9235c18a",
      "iswcs": [
        "T-070.243.691-6"
      ],
      "language": "eng",
      "languages": [
        "eng"
      ],
      "name": "Smells Like Teen Spirit",
      "relations": [
        {
          "attributes": [],
          "begin_date": null,
          "direction": "backward",
          "end_date": null,
          "target_id": "60a1f832-8ca6-4d75-ac59-cd8f7c9f0b3d",
          "target_name": "Kurt Cobain",
          "target_type": "artist",
          "type": "composer"
        }
      ],
      "requested_includes": [
        "artist-rels"
      ],
      "title": "Smells Like Teen Spirit",
      "type": "Song",
      "url": "https://musicbrainz.org/work/9840e142-269d-3fa3-9805-041a9235c18a"
    }
  ],
  "total_matches": 118
}

Rate something

Rate a MusicBrainz entity out of five stars as the connected account. Ratings take effect at once and feed the community average. Choosing no rating removes yours rather than recording a bad one. Areas, places, releases and series cannot be rated: rate the release group rather than one of its issues.

Inputs

Kind of thingentity_typetextRequired: Which kind of entity the ID names.One of: artist (Artist - a person, group or orchestra), event (Event - a concert or festival), instrument, label (Label - a record label or imprint), recording (Recording - one performance, as a track), release-group (Release group - an album, across all its issues), work (Work - the composition itself, behind its recordings).
MusicBrainz IDmbidtextRequired: The entity's MusicBrainz ID, or the musicbrainz.org address of its page. It must be an ID of the kind chosen above: MusicBrainz IDs are not shared between kinds of entity.
RatingratingtextRequired: How many stars to give it. MusicBrainz stores this out of 100 behind the scenes; whole stars are all it ever collects.One of: 5 (5 stars), 4 (4 stars), 3 (3 stars), 2 (2 stars), 1 (1 star), 0 (No rating (removes mine)).

Outputs

entity_typetext
mbidtext
nametext
ratingnumber
starsnumber
submittedtrue/false
urltext

Example output

{
  "entity_type": "release-group",
  "mbid": "1b022e01-4da6-387b-8658-8678046e4cef",
  "name": "Nevermind",
  "rating": 100,
  "stars": 5,
  "submitted": true,
  "url": "https://musicbrainz.org/release-group/1b022e01-4da6-387b-8658-8678046e4cef"
}

Search any index

Search any MusicBrainz index with a query you write yourself. The dedicated searches build the query from labelled fields; this one takes MusicBrainz's own search syntax and reaches the indexes they do not cover - areas, events, places, instruments, series, URLs, annotations, tags and CD stubs. The query is sent exactly as written, so its syntax is yours to get right; MusicBrainz documents the fields each index accepts.

Inputs

Search which indexentity_typetextRequired: Which MusicBrainz index to search.One of: annotation (Annotation - an editor's free-text note), area (Area - a country, city or region), artist (Artist - a person, group or orchestra), cdstub (CD stub - a tracklist submitted without a release), event (Event - a concert or festival), instrument, label (Label - a record label or imprint), place (Place - a venue, studio or stadium), recording (Recording - one performance, as a track), release (Release - one issue of an album, with its own barcode), and 5 more.
Search queryquerytextRequired: A MusicBrainz search query. Plain words search the index's default fields; 'field:value' searches one field, and clauses can be joined with AND, OR and NOT.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "place",
  "offset": 0,
  "output_detail": "full",
  "query": "place:\"Abbey Road Studios\"",
  "result_count": 1,
  "results": [
    {
      "address": "3 Abbey Road, St John\u2019s Wood, London",
      "area": "St John's Wood",
      "begin_date": "1931-11-12",
      "disambiguation": null,
      "end_date": null,
      "ended": false,
      "entity_type": "place",
      "id": "bd55aeb7-19d1-4607-a500-14b8479d3fed",
      "latitude": 51.53192,
      "longitude": -0.17835,
      "name": "Abbey Road Studios",
      "requested_includes": [],
      "type": "Studio",
      "url": "https://musicbrainz.org/place/bd55aeb7-19d1-4607-a500-14b8479d3fed"
    }
  ],
  "total_matches": 9
}

Search for artists

Find artists by name and narrow the match by type, country, gender, area, genre or the years they were active. Searching is how a workflow gets its first MusicBrainz ID: every other step needs one, and only a search works from a name. Each filter is combined with AND, and every value is escaped, so a band called AC/DC or !!! searches for itself.

Inputs

Artist namenametext: All or part of the artist's name. Accents are ignored, so 'bjork' finds Bjork.
Aliasaliastext: Match a name the artist is also known by, including their name in other scripts.
Typeartist_typetext: Only match artists of this kind.One of: person, group, orchestra, choir, character (Character (a fictional performer)), other.
Gendergendertext: Only match artists recorded with this gender. Groups and ensembles are recorded as 'not applicable'.One of: male, female, non-binary, not applicable (Not applicable (a group or an ensemble)).
Countrycountrytext: The two-letter country code the artist is mainly associated with.
Areaareatext: The name of the area the artist is associated with, which can be narrower than a country.
Genregenretext: Only match things carrying this genre, chosen from MusicBrainz's own genre list. Genres are the curated part of the tag vocabulary.
Tagtagtext: Only match things carrying this tag. Tags are free text applied by editors, so anything from 'seattle' to 'guilty pleasure' may be there.
Formed or born on or afterbegan_fromdate: Only match artists whose begin date falls on or after this. For a person that is their date of birth; for a group, when it formed.
Formed or born on or beforebegan_todate: Only match artists whose begin date falls on or before this.
Extra search syntaxquerytext: An optional raw search clause, combined with the fields above using AND. Use it for anything the fields do not cover, e.g. 'ended:false' or 'comment:tribute'. Written as-is, so its syntax is yours to get right.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "artist",
  "offset": 0,
  "output_detail": "full",
  "query": "artist:Nirvana AND country:US",
  "result_count": 1,
  "results": [
    {
      "area": "United States",
      "begin_area": "Aberdeen",
      "begin_date": "1987",
      "country": "US",
      "disambiguation": "1980s-1990s US grunge band",
      "end_area": null,
      "end_date": "1994-04-05",
      "ended": true,
      "entity_type": "artist",
      "gender": null,
      "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
      "ipis": [],
      "isnis": [
        "0000000123486830"
      ],
      "name": "Nirvana",
      "rating": {
        "value": 4.6,
        "votes": 46
      },
      "requested_includes": [
        "tags",
        "ratings"
      ],
      "sort_name": "Nirvana",
      "tags": [
        {
          "count": 12,
          "name": "grunge"
        },
        {
          "count": 9,
          "name": "alternative rock"
        }
      ],
      "type": "Group",
      "url": "https://musicbrainz.org/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da"
    }
  ],
  "total_matches": 4
}

Search for labels

Find record labels by name, LC code, country or type. The LC code may be given with or without its 'LC' prefix and leading zeros.

Inputs

Label namenametext: All or part of the label's name.
Label code (LC)label_codetext: The label's LC code, as printed on a release. 'LC 07266', '07266' and '7266' all work.
Countrycountrytext: The two-letter code of the label's country.
Typelabel_typetext: Only match labels of this kind, e.g. Imprint, Distributor, Publisher or Original Production.
Tagtagtext: Only match things carrying this tag. Tags are free text applied by editors, so anything from 'seattle' to 'guilty pleasure' may be there.
Extra search syntaxquerytext: An optional raw search clause, combined with the fields above using AND. Use it for anything the fields do not cover, e.g. 'ended:false' or 'comment:tribute'. Written as-is, so its syntax is yours to get right.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "label",
  "offset": 0,
  "output_detail": "full",
  "query": "label:\"Geffen Records\"",
  "result_count": 1,
  "results": [
    {
      "area": "United States",
      "begin_date": null,
      "country": "US",
      "disambiguation": null,
      "end_date": null,
      "ended": false,
      "entity_type": "label",
      "id": "0fadc2ce-f7de-4e27-bbe6-612b317e716b",
      "ipis": [],
      "isnis": [],
      "label_code": 7266,
      "name": "Geffen Records",
      "requested_includes": [],
      "sort_name": "Geffen Records",
      "type": "Production",
      "url": "https://musicbrainz.org/label/0fadc2ce-f7de-4e27-bbe6-612b317e716b"
    }
  ],
  "total_matches": 5
}

Search for recordings

Find individual performances of a song by title, artist, the release they appear on, or ISRC. A popular song has hundreds of recordings - studio, live, remixed, remastered - so filter by the release or the date to reach the one you mean.

Inputs

Recording titletitletext: All or part of the recording's title.
Artist nameartisttext: Only match recordings credited to this artist.
Appears onreleasetext: Only match recordings that appear on a release with this title.
ISRCisrctext: An exact ISRC. Hyphens are optional. To go straight from a code to its recordings, use "Find recordings by ISRC" instead.
Countrycountrytext: The two-letter code of a country the recording was released in.
Videos onlyvideotrue/false: On to match only video recordings, off to match only audio ones. Leave unset to match both.
Genregenretext: Only match things carrying this genre, chosen from MusicBrainz's own genre list. Genres are the curated part of the tag vocabulary.
Tagtagtext: Only match things carrying this tag. Tags are free text applied by editors, so anything from 'seattle' to 'guilty pleasure' may be there.
First released on or afterfirst_released_fromdate: Only match recordings first released on or after this day.
First released on or beforefirst_released_todate: Only match recordings first released on or before this day.
Extra search syntaxquerytext: An optional raw search clause, combined with the fields above using AND. Use it for anything the fields do not cover, e.g. 'ended:false' or 'comment:tribute'. Written as-is, so its syntax is yours to get right.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "recording",
  "offset": 0,
  "output_detail": "full",
  "query": "recording:\"Smells Like Teen Spirit\" AND artist:Nirvana",
  "result_count": 1,
  "results": [
    {
      "artist_credit": "Nirvana",
      "artists": [
        {
          "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "join_phrase": "",
          "name": "Nirvana",
          "sort_name": "Nirvana"
        }
      ],
      "disambiguation": null,
      "entity_type": "recording",
      "first_release_date": "1991-09-10",
      "id": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
      "isrcs": [
        "USGF19942501"
      ],
      "length": "5:01",
      "length_ms": 301133,
      "name": "Smells Like Teen Spirit",
      "requested_includes": [
        "isrcs",
        "artist-credits"
      ],
      "title": "Smells Like Teen Spirit",
      "type": null,
      "url": "https://musicbrainz.org/recording/5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
      "video": false
    }
  ],
  "total_matches": 481
}

Search for release groups

Find albums, singles and EPs as things in their own right, independent of how many times they have been reissued. Filter by artist, type, genre, or when the album first came out. This is usually the right search for 'what albums are there called X'.

Inputs

Album titletitletext: All or part of the release group's title.
Artist nameartisttext: Only match albums credited to this artist.
Typeprimary_typetext: Only match release groups of this kind.One of: album, single, ep, broadcast, other.
Also tagged assecondary_typeslist: Only match release groups carrying every one of these secondary types. A live album is an Album that is also Live, so both are recorded.One or more of: audio drama, audiobook, compilation, demo, dj-mix, field recording, interview, live, mixtape/street (Mixtape / street), remix, soundtrack, spokenword (Spoken word).
Genregenretext: Only match things carrying this genre, chosen from MusicBrainz's own genre list. Genres are the curated part of the tag vocabulary.
Tagtagtext: Only match things carrying this tag. Tags are free text applied by editors, so anything from 'seattle' to 'guilty pleasure' may be there.
First released on or afterfirst_released_fromdate: Only match albums whose first release falls on or after this day.
First released on or beforefirst_released_todate: Only match albums whose first release falls on or before this day.
Extra search syntaxquerytext: An optional raw search clause, combined with the fields above using AND. Use it for anything the fields do not cover, e.g. 'ended:false' or 'comment:tribute'. Written as-is, so its syntax is yours to get right.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "release-group",
  "offset": 0,
  "output_detail": "full",
  "query": "releasegroup:Nevermind AND artist:Nirvana",
  "result_count": 1,
  "results": [
    {
      "artist_credit": "Nirvana",
      "artists": [
        {
          "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "join_phrase": "",
          "name": "Nirvana",
          "sort_name": "Nirvana"
        }
      ],
      "disambiguation": null,
      "entity_type": "release-group",
      "first_release_date": "1991-09-24",
      "id": "1b022e01-4da6-387b-8658-8678046e4cef",
      "name": "Nevermind",
      "primary_type": "Album",
      "requested_includes": [],
      "secondary_types": [],
      "title": "Nevermind",
      "type": null,
      "url": "https://musicbrainz.org/release-group/1b022e01-4da6-387b-8658-8678046e4cef"
    }
  ],
  "total_matches": 6
}

Search for releases

Find specific issues of an album by title, artist, barcode, catalogue number, label, country, format or release date. Searching by barcode is how a scanned product becomes a MusicBrainz release. For the album itself, rather than one pressing of it, use "Search for release groups".

Inputs

Release titletitletext: All or part of the release's title.
Artist nameartisttext: Only match releases credited to this artist.
Barcodebarcodetext: The EAN or UPC printed on the packaging. An exact match, and usually the fastest way to the one release you have in your hand.
Catalogue numbercatalog_numbertext: The number the label printed on the release.
Labellabeltext: Only match releases issued by this label.
Countrycountrytext: The two-letter code of the country it was released in.
Statusstatustext: Only match releases of this status. 'Official' excludes bootlegs and promos.One of: official, promotion (Promotional), bootleg, pseudo-release (Pseudo-release (a translation or transliteration)), withdrawn, cancelled.
Typeprimary_typetext: Only match releases of this kind.One of: album, single, ep, broadcast, other.
Formatmedia_formattext: Only match releases on this medium. MusicBrainz records around a hundred formats, so this is free text rather than a list.
Genregenretext: Only match things carrying this genre, chosen from MusicBrainz's own genre list. Genres are the curated part of the tag vocabulary.
Tagtagtext: Only match things carrying this tag. Tags are free text applied by editors, so anything from 'seattle' to 'guilty pleasure' may be there.
Released on or afterreleased_fromdate: Only match releases dated on or after this day.
Released on or beforereleased_todate: Only match releases dated on or before this day.
Extra search syntaxquerytext: An optional raw search clause, combined with the fields above using AND. Use it for anything the fields do not cover, e.g. 'ended:false' or 'comment:tribute'. Written as-is, so its syntax is yours to get right.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "release",
  "offset": 0,
  "output_detail": "full",
  "query": "release:Nevermind AND artist:Nirvana",
  "result_count": 1,
  "results": [
    {
      "artist_credit": "Nirvana",
      "artists": [
        {
          "id": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
          "join_phrase": "",
          "name": "Nirvana",
          "sort_name": "Nirvana"
        }
      ],
      "barcode": "0720642442524",
      "country": "US",
      "date": "1991-09-24",
      "disambiguation": null,
      "entity_type": "release",
      "id": "8e061dc4-790e-4587-ba53-011e7852f88d",
      "labels": [
        {
          "catalog_number": "GED24425",
          "label": "Geffen Records",
          "label_id": "0fadc2ce-f7de-4e27-bbe6-612b317e716b"
        }
      ],
      "language": "eng",
      "media": [
        {
          "disc_ids": [
            "2y0jFMwYQP7gb9iSUKagmoT6DIw-"
          ],
          "format": "CD",
          "position": 1,
          "title": null,
          "track_count": 12,
          "tracks": [
            {
              "length": "5:01",
              "length_ms": 301133,
              "number": "1",
              "position": 1,
              "recording_id": "5fb524f1-8cc8-4c04-a921-e34c0a911ea7",
              "title": "Smells Like Teen Spirit"
            }
          ]
        }
      ],
      "name": "Nevermind",
      "packaging": "Jewel Case",
      "release_group_id": "1b022e01-4da6-387b-8658-8678046e4cef",
      "requested_includes": [
        "recordings",
        "release-groups",
        "media",
        "labels",
        "artist-credits"
      ],
      "script": "Latn",
      "status": "Official",
      "title": "Nevermind",
      "track_count": 12,
      "type": null,
      "url": "https://musicbrainz.org/release/8e061dc4-790e-4587-ba53-011e7852f88d"
    }
  ],
  "total_matches": 21
}

Search for works

Find compositions by title, the artist who wrote or performed them, ISWC or type. A work is the song as written, which is the level royalties and publishing are tracked at.

Inputs

Work titletitletext: All or part of the work's title.
Artist nameartisttext: Only match works linked to this artist, as writer or performer.
ISWCiswctext: An exact ISWC, e.g. T-070.243.691-6. To go straight from a code to its works, use "Find works by ISWC".
Typework_typetext: Only match works of this kind. MusicBrainz records around thirty, mostly classical forms, so this is free text.
Tagtagtext: Only match things carrying this tag. Tags are free text applied by editors, so anything from 'seattle' to 'guilty pleasure' may be there.
Extra search syntaxquerytext: An optional raw search clause, combined with the fields above using AND. Use it for anything the fields do not cover, e.g. 'ended:false' or 'comment:tribute'. Written as-is, so its syntax is yours to get right.
Number of resultslimitnumber: How many results to return (1 to 100). MusicBrainz caps a page at 100 and defaults to 25.From 1 to 100. Default: 25.
Skip this manyoffsetnumber: How many results to skip, for reading past the first page. Leave at 0 for the first page, set to 25 for the second, and so on.At least 0. Default: 0.
Show in the runoutput_detailtext: How much to print into the run output for a person to read. This only changes what is displayed, never what is saved: a later step reads every result either way. Defaults to every result.One of: summary (The first few results), full (Every result). Default: full.

Outputs

entity_typetext
offsetnumber
output_detailtext
querytext
result_countnumber
resultslist
total_matchesnumber

Example output

{
  "entity_type": "work",
  "offset": 0,
  "output_detail": "full",
  "query": "work:\"Smells Like Teen Spirit\"",
  "result_count": 1,
  "results": [
    {
      "attributes": [
        {
          "type": "ASCAP ID",
          "type-id": "d833318c-6c6a-370e-8b16-9cb15873ba76",
          "value": "905650303"
        }
      ],
      "disambiguation": null,
      "entity_type": "work",
      "id": "9840e142-269d-3fa3-9805-041a9235c18a",
      "iswcs": [
        "T-070.243.691-6"
      ],
      "language": "eng",
      "languages": [
        "eng"
      ],
      "name": "Smells Like Teen Spirit",
      "relations": [
        {
          "attributes": [],
          "begin_date": null,
          "direction": "backward",
          "end_date": null,
          "target_id": "60a1f832-8ca6-4d75-ac59-cd8f7c9f0b3d",
          "target_name": "Kurt Cobain",
          "target_type": "artist",
          "type": "composer"
        }
      ],
      "requested_includes": [
        "artist-rels"
      ],
      "title": "Smells Like Teen Spirit",
      "type": "Song",
      "url": "https://musicbrainz.org/work/9840e142-269d-3fa3-9805-041a9235c18a"
    }
  ],
  "total_matches": 2
}

Tag something

Add tags to a MusicBrainz entity, hide ones you disagree with, or take back a vote you cast before. Tags are public and attributed to your account, and take effect at once. Genres are submitted the same way: a tag drawn from MusicBrainz's genre list counts as a genre.

Inputs

Kind of thingentity_typetextRequired: Which kind of entity the ID names.One of: area (Area - a country, city or region), artist (Artist - a person, group or orchestra), event (Event - a concert or festival), genre (Genre - one of MusicBrainz's genre entries), instrument, label (Label - a record label or imprint), place (Place - a venue, studio or stadium), recording (Recording - one performance, as a track), release (Release - one issue of an album, with its own barcode), release-group (Release group - an album, across all its issues), and 3 more.
MusicBrainz IDmbidtextRequired: The entity's MusicBrainz ID, or the musicbrainz.org address of its page. It must be an ID of the kind chosen above: MusicBrainz IDs are not shared between kinds of entity.
TagstagslistRequired: The tags to submit: one per line, comma-separated, or a list from an earlier step. Tags are stored in lower case.
What to do with themvotetext: Adding is the default. Hiding a tag subtracts a vote from it and hides it from you; if its total falls to zero it is hidden from everyone.One of: upvote (Add the tags (upvote)), downvote (Hide the tags (downvote)), withdraw (Take back my earlier vote). Default: upvote.

Outputs

entity_typetext
mbidtext
nametext
submittedtrue/false
tagslist
urltext
votetext

Example output

{
  "entity_type": "artist",
  "mbid": "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
  "name": "Nirvana",
  "submitted": true,
  "tags": [
    "grunge",
    "seattle"
  ],
  "url": "https://musicbrainz.org/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da",
  "vote": "upvote"
}

ActionsCopy Anchor Link

Add a barcode to a releaseCopy Anchor Link

Inputs

Outputs

Add ISRCs to a recordingCopy Anchor Link

Inputs

Outputs

Find recordings by ISRCCopy Anchor Link

Inputs

Outputs

Find what a web address is linked toCopy Anchor Link

Inputs

Outputs

Find works by ISWCCopy Anchor Link

Inputs

Outputs

Get a labelCopy Anchor Link

Inputs

Outputs

Get a recordingCopy Anchor Link

Inputs

Outputs

Get a releaseCopy Anchor Link

Inputs

Outputs

Get a release groupCopy Anchor Link

Inputs

Outputs

Get a workCopy Anchor Link

Inputs

Outputs

Get an artistCopy Anchor Link

Inputs

Outputs

Get any entity by IDCopy Anchor Link

Inputs

Outputs

Get cover artCopy Anchor Link

Inputs

Outputs

Get my MusicBrainz accountCopy Anchor Link

Inputs

Outputs

Identify a CD by disc IDCopy Anchor Link

Inputs

Outputs

List artists linked to somethingCopy Anchor Link

Inputs

Outputs

List collectionsCopy Anchor Link

Inputs

Outputs

List events linked to somethingCopy Anchor Link

Inputs

Outputs

List genresCopy Anchor Link

Inputs

Outputs

List labels linked to somethingCopy Anchor Link

Inputs

Outputs

List places linked to somethingCopy Anchor Link

Inputs

Outputs

List recordings linked to somethingCopy Anchor Link

Inputs

Outputs

List release groups linked to somethingCopy Anchor Link

Inputs

Outputs

List releases linked to somethingCopy Anchor Link

Inputs

Outputs

List works linked to somethingCopy Anchor Link

Inputs

Outputs

Rate somethingCopy Anchor Link

Inputs

Outputs

Actions

Add a barcode to a release

Add ISRCs to a recording

Find recordings by ISRC

Find what a web address is linked to

Find works by ISWC

Get a label

Get a recording

Get a release

Get a release group

Get a work

Get an artist

Get any entity by ID

Get cover art

Get my MusicBrainz account

Identify a CD by disc ID

List artists linked to something

List collections

List events linked to something

List genres

List labels linked to something

List places linked to something

List recordings linked to something

List release groups linked to something

List releases linked to something

List works linked to something

Rate something

Search any index

Search for artists

Search for labels

Search for recordings

Search for release groups

Search for releases

Search for works

Tag something