# MusicBrainz on Onekey

> 16 endpoints for MusicBrainz (16 stable, 0 beta), 1 to 5 credits each. Category: Music & audio. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/musicbrainz
Reference (Markdown): https://onekey.dev/docs/api/musicbrainz.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 16 mapped MusicBrainz endpoints return each:

- `entity.id` (string): 16
- `entity.name` (string): 16
- `entity.type` (string): 11
- `author.displayName` (string): 8
- `entity.releaseDate` (ISO 8601 date): 8
- `entity.country` (string): 7
- `event.startDate` (ISO 8601 date): 4
- `entity.status` (string): 3
- `listing.barcode` (string): 3
- `entity.language` (string): 2
- plus 2 platform-specific fields under `ext.`

## Endpoints

### musicbrainz.area

MusicBrainz area by MBID.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/area?mbid=f03d09b3-39dc-4083-afd6-159e3f0d462f` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `entity.type`
- Reference: https://onekey.dev/docs/api/musicbrainz/area.md

### musicbrainz.area_search

Search MusicBrainz areas.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/area_search?q=london` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Lucene search query (e.g. radiohead or artist:radiohead)
- Fields returned: `entity.id`, `entity.name`, `entity.type`
- Reference: https://onekey.dev/docs/api/musicbrainz/area_search.md

### musicbrainz.artist

MusicBrainz artist by MBID.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/artist?mbid=a74b1b7f-71a5-4011-9441-d0b5e4122711` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.country`, `event.startDate`, `ext.disambiguation`
- Reference: https://onekey.dev/docs/api/musicbrainz/artist.md

### musicbrainz.artist_release_groups

Release groups (albums, EPs, singles) by a MusicBrainz artist.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/artist_release_groups?mbid=a74b1b7f-71a5-4011-9441-d0b5e4122711` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.releaseDate`, `author.displayName`
- Reference: https://onekey.dev/docs/api/musicbrainz/artist_release_groups.md

### musicbrainz.artist_releases

Releases by a MusicBrainz artist.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/artist_releases?mbid=a74b1b7f-71a5-4011-9441-d0b5e4122711` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `entity.status`, `entity.releaseDate`, `entity.country`, `author.displayName`, `listing.barcode`
- Reference: https://onekey.dev/docs/api/musicbrainz/artist_releases.md

### musicbrainz.artist_search

Search MusicBrainz artists.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/artist_search?q=radiohead` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Lucene search query (e.g. radiohead or artist:radiohead)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.country`, `event.startDate`, `ext.disambiguation`
- Reference: https://onekey.dev/docs/api/musicbrainz/artist_search.md

### musicbrainz.label

MusicBrainz label by MBID.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/label?mbid=46f0f4cd-8aab-4b33-b698-f459faf64190` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.country`, `event.startDate`
- Reference: https://onekey.dev/docs/api/musicbrainz/label.md

### musicbrainz.label_search

Search MusicBrainz labels.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/label_search?q=warp` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Lucene search query (e.g. radiohead or artist:radiohead)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.country`, `event.startDate`
- Reference: https://onekey.dev/docs/api/musicbrainz/label_search.md

### musicbrainz.recording

MusicBrainz recording by MBID.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/recording?mbid=f3f032af-a693-40e8-af93-878ad0d00397` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `author.displayName`, `entity.releaseDate`, `ext.lengthMs`
- Reference: https://onekey.dev/docs/api/musicbrainz/recording.md

### musicbrainz.recording_search

Search MusicBrainz recordings.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/recording_search?q=creep` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Lucene search query (e.g. radiohead or artist:radiohead)
- Fields returned: `entity.id`, `entity.name`, `author.displayName`, `entity.releaseDate`, `ext.lengthMs`
- Reference: https://onekey.dev/docs/api/musicbrainz/recording_search.md

### musicbrainz.release

MusicBrainz release by MBID.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/release?mbid=4b3d18cc-8937-36f4-8de0-481088be58e6` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `entity.status`, `entity.releaseDate`, `entity.country`, `author.displayName`, `listing.barcode`
- Reference: https://onekey.dev/docs/api/musicbrainz/release.md

### musicbrainz.release_group

MusicBrainz release group by MBID.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/release_group?mbid=a5e4bd1a-63c9-4dfc-9e63-ed0c3dc049be` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.releaseDate`, `author.displayName`
- Reference: https://onekey.dev/docs/api/musicbrainz/release_group.md

### musicbrainz.release_group_search

Search MusicBrainz release groups.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/release_group_search?q=ok%20computer` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Lucene search query (e.g. radiohead or artist:radiohead)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.releaseDate`, `author.displayName`
- Reference: https://onekey.dev/docs/api/musicbrainz/release_group_search.md

### musicbrainz.release_search

Search MusicBrainz releases.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/release_search?q=ok%20computer` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Lucene search query (e.g. radiohead or artist:radiohead)
- Fields returned: `entity.id`, `entity.name`, `entity.status`, `entity.releaseDate`, `entity.country`, `author.displayName`, `listing.barcode`
- Reference: https://onekey.dev/docs/api/musicbrainz/release_search.md

### musicbrainz.work

MusicBrainz work by MBID.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/work?mbid=fa80b137-ebd1-3177-8fa4-416eb3ee52a2` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `mbid` (string, required): MusicBrainz id (UUID)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.language`
- Reference: https://onekey.dev/docs/api/musicbrainz/work.md

### musicbrainz.work_search

Search MusicBrainz works.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/musicbrainz/work_search?q=creep` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Lucene search query (e.g. radiohead or artist:radiohead)
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.language`
- Reference: https://onekey.dev/docs/api/musicbrainz/work_search.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/musicbrainz/area?mbid=f03d09b3-39dc-4083-afd6-159e3f0d462f" \
  -H "x-api-key: YOUR_API_KEY"
```