Duaer

Get started

MusicBrainz music in Duaer

In Duaer: MusicBrainz: artists, albums and releases, and recordings with dates, countries, labels, and tags. One successful search uses 1 credit.

What you get

Duaer MusicBrainz music searches the open MusicBrainz database for artists, releases, or recordings, best match first.

Pick Duaer Data → MusicBrainz music in the node creator, or open the data market. Related: Open Library, Wikipedia.

When to use it

  • Get an artist’s country, start year, and genres.
  • List the editions of an album with labels.

When not to use it

Search on the canvas

  1. Open the node creator and pick Duaer Data → MusicBrainz music.
  2. Fill Words (such as Radiohead). Optional: Type (release or recording).
  3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

  • GET https://api.duaer.com/v1/data/musicbrainz?words=Radiohead
  • Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-musicbrainz
description: >-
  Duaer MusicBrainz music. MusicBrainz: artists, albums and releases, and recordings with dates, countries, labels, and tags.
  One successful search uses 1 Duaer credit.
---

# Duaer MusicBrainz music

Duaer MusicBrainz music searches the open MusicBrainz database for artists, releases, or recordings, best match first.

## When to use

- Get an artist’s country, start year, and genres.
- List the editions of an album with labels.

## When not to use

- Books. Use https://skills.duaer.com/open-library.md.
- Museum objects. Use https://skills.duaer.com/vam-museum.md.

## Call

`GET https://api.duaer.com/v1/data/musicbrainz?words=Radiohead`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words`.

- `words` — Artist, album, or song such as Radiohead.
- `type` — Optional. `artist`, `release`, or `recording`. Default artist.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/musicbrainz?words=Radiohead` — the band and similar names.
- `GET https://api.duaer.com/v1/data/musicbrainz?words=OK%20Computer&type=release` — releases of OK Computer.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `mbid`, `name`, `type`, `score` — MusicBrainz ID, name, kind, and match score.
- `country`, `area`, `begin`, `end`, `tags` — for artists.
- `release`, `artist`, `date`, `label`, `tracks`, `status`, `releaseType` — for releases.
- `recording`, `artist`, `lengthSec`, `firstReleaseDate`, `release` — for recordings.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/open-library.md — Duaer Open Library
- https://skills.duaer.com/wikipedia.md — Duaer Wikipedia

Questions

How many credits does a MusicBrainz music search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Can Duaer MusicBrainz music play songs?

No. Duaer returns catalog data only, no audio.

In this section

Get started

Open Library in Duaer

In Duaer: Books from Open Library by title, author, or subject: authors, first publication year, edition count, ISBN, subjects, e-book access, and cover image. One successful search uses 1 credit.

Get started

Wikipedia in Duaer

In Duaer: Wikipedia articles in any language edition with the short description, a text excerpt, and a thumbnail, for quick background on a term. One successful search uses 1 credit.