MusicBrainz

MusicBrainz

Search music metadata.

Parameters

Example response

{"project":"music:musicbrainz",  "data": {"ok":true,"count":72529,"entity":"recording","offset":0,"created":"2026-05-27T13:19:06.668Z",    "recordings": [      {"id":"9a73ed57-8a52-438e-94da-1e019a8c2211","score":100,"title":"Blinding Lights","video":null,"length":240000,        "releases": [          {"id":"90211794-84af-4673-9b9e-7c0f577b00b2","count":1,            "media": [              {"id":"431f93b4-fa84-325e-9e89-f5db901483c3",                "track": [                  {"id":"e3be20b8-47d9-397e-8163-94a3ed883e71","title":"Blinding Lights","length":240000,"number":"5"                  }                ],"format":"CD","position":1,"track-count":9,"track-offset":4              }            ],"title":"Mathematica","status":"Official","status-id":"4e304316-386d-3409-af2e-78857eec5cfe","track-count":9,            "release-group": {"id":"d676856c-dd2b-4df8-90d4-59635ee0419c","title":"Mathematica","type-id":"f529b476-6e62-324f-b0aa-1f3e33d313fc","primary-type":"Album","primary-type-id":"f529b476-6e62-324f-b0aa-1f3e33d313fc"            }          }        ],        "artist-credit": [          {"name":"Makeshift Prodigy",            "artist": {"id":"3859c8ab-ea0f-4182-b447-041dacb4155e","name":"Makeshift Prodigy","sort-name":"Makeshift Prodigy"            }          }        ],"artist-credit-id":"5976c408-90df-371d-b5b3-ac3804d35af5","first-release-date":"2010-04-06"      },      {"id":"f8c7eed9-68c7-440e-a067-d1e8c35242d8",        "isrcs": [          "NLK072000301"        ],"score":100,"title":"Blinding Lights","video":null,"length":152452,        "releases": [          {"id":"723509b6-f787-4a78-bdd1-5c1069cc428a","date":"2021-05-14","count":1,            "media": [              {"id":"1bd8985d-0981-3206-98a5-261622958428",                "track": [                  {"id":"06db80d0-a0a5-4b92-8741-63d47672cdc3","title":"Blinding Lights","length":152452,"number":"1"                  }                ],"format":"Digital Media","position":1,"track-count":1,"track-offset":0              }            ],"title":"Blinding Lights","status":"Official","country":"XW","status-id":"4e304316-386d-3409-af2e-78857eec5cfe","track-count":1,            "artist-credit": [              {"name":"Yori",                "artist": {"id":"1d8a7caf-bcab-4f73-abc1-2448f0d0d547","name":"Yori Swart","sort-name":"Swart, Yori","disambiguation":"Blues/Americana singer and guitar player"                }              }            ],            "release-group": {"id":"2edfa703-f2ad-4be2-81a4-d4fe2a313dd2","title":"Blinding Lights","type-id":"d6038452-8ee0-3f68-affc-2de9a1ede0b9","primary-type":"Single","primary-type-id":"d6038452-8ee0-3f68-affc-2de9a1ede0b9"            },            "release-events": [              {                "area": {"id":"525d4e18-3d00-31b9-a58b-a146a916de8f","name":"[Worldwide]","sort-name":"[Worldwide]",                  "iso-3166-1-codes": [                    "XW"                  ]                },"date":"2021-05-14"              }            ],"artist-credit-id":"dd085fd9-a024-30e3-b189-5513ebf52693"          }        ],        "artist-credit": [          {"name":"Yori",            "artist": {"id":"1d8a7caf-bcab-4f73-abc1-2448f0d0d547","name":"Yori Swart",              "aliases": [                {"name":"Yori Devi Swart","type":"Legal name","locale":null,"primary":null,"type-id":"d4dcd0c0-b341-3612-a332-c0ce797b25cf","end-date":null,"sort-name":"Swart, Yori Devi","begin-date":null                },                {"name":"YORI","type":"Artist name","locale":null,"primary":null,"type-id":"894afba6-2816-3c24-8072-eadb66bd04bc","end-date":null,"sort-name":"YORI","begin-date":"2017"                }              ],"sort-name":"Swart, Yori","disambiguation":"Blues/Americana singer and guitar player"            }          }        ],"artist-credit-id":"dd085fd9-a024-30e3-b189-5513ebf52693","first-release-date":"2021-05-14"      },      {"id":"116fdd78-b1c4-45a9-a6ea-950748a2f0f3","score":100,"title":"Blinding Lights","video":null,"length":61000,        "releases": [          {"id":"06cc23b4-e6fe-485a-83ab-c1908f17c991","date":"2016-10-28","count":1,            "media": [              {"id":"1205a7b7-340d-3775-bd39-570df1c319e0",                "track": [                  {"id":"c0b63be1-6756-430c-9ede-084ade7b1b62","title":"Blinding Lights","length":61000,"number":"5"                  }                ],"format":"Digital Media","position":1,"track-count":13,"track-offset":4              }            ],"title":"Heartbeats","status":"Official","country":"XW","status-id":"4e304316-386d-3409-af2e-78857eec5cfe","track-count":13,            "release-group": {"id":"43a468fc-cef9-4e4a-b3f6-bc7172176dbe","title":"Heartbeats","type-id":"f529b476-6e62-324f-b0aa-1f3e33d313fc","primary-type":"Album","primary-type-id":"f529b476-6e62-324f-b0aa-1f3e33d313fc"            },            "release-events": [              {                "area": {"id":"525d4e18-3d00-31b9-a58b-a146a916de8f","name":"[Worldwide]","sort-name":"[Worldwide]",                  "iso-3166-1-codes": [                    "XW"                  ]                },"date":"2016-10-28"              }            ]          }        ],        "artist-credit": [          {"name":"Vigo Thieves",            "artist": {"id":"dec7ba06-15d1-4a78-a993-638ff0f8b954","name":"Vigo Thieves","sort-name":"Vigo Thieves"            }          }        ],"artist-credit-id":"2e852c66-c3a1-33b8-949d-9817a0cce14d","first-release-date":"2016-10-28"      }    ]  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

• 401Missing or invalid x-api-key
• 404Not found or private
• 429Rate limit or monthly quota reached

Code

const data = await client.run(  "music:musicbrainz",  "search",  { query: "blinding lights", entity: "recording", limit: 25 });