# Discogs Music Database API

> Discogs artists, releases, master releases and labels by id: tracklists, credits, formats, images

- Vendor: `discogsmusicdatabaseapi` · version 1.0 · category Music · tags discogs api, music database api, vinyl records api, album tracklist api, record label api, discography api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/discogsmusicdatabaseapi
- This document: https://apiclay.com/docs/discogsmusicdatabaseapi.md
- OpenAPI 3.1: https://apiclay.com/api/discogsmusicdatabaseapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `discogsmusicdatabaseapi`
- Updated: 2026-11-18

## About

## Discogs Music Database API

Look up the Discogs music database by id: artists (profile, members, aliases, images), releases (title, year, country, formats, labels, tracklist, credits, community have/want and rating), master releases, labels, and an artist's discography.

Data comes from **discogs.com** (https://www.discogs.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/artist?id=1`, `/artist-releases?id=1`, then `/release?id=249504`.

### Routes

#### GET `/artist` - Artist
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Discogs artist id. |

Returns: `name`, `realname`, `profile`, `members`, `aliases`, `urls`, `images`.

#### GET `/artist-releases` - Artist releases
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Artist id. |
| page | query | number | no | Page. |
| per_page | query | number | no | Up to 100. |

Returns: `pagination`, `releases[]` (`title`, `year`, `role`, `type`, `id`).

#### GET `/release` - Release
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Release id. |

Returns: `title`, `year`, `country`, `formats`, `labels`, `tracklist`, `extraartists`, `community`.

#### GET `/master` - Master release
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Master id. |

Returns: `title`, `year`, `tracklist`, `main_release`.

#### GET `/label` - Label
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Label id. |

Returns: `name`, `profile`, `sublabels`, `urls`.

### Caveats

- Database search needs a Discogs token, so lookups are by id only.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by discogs.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /artist — Artist
- Gateway: `GET https://api.apiclay.com/v1/api/discogsmusicdatabaseapi/artist`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /artist-releases — Artist releases
- Gateway: `GET https://api.apiclay.com/v1/api/discogsmusicdatabaseapi/artist-releases`
- Public query params: `page` (number), `per_page` (number), `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /release — Release
- Gateway: `GET https://api.apiclay.com/v1/api/discogsmusicdatabaseapi/release`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /master — Master release
- Gateway: `GET https://api.apiclay.com/v1/api/discogsmusicdatabaseapi/master`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /label — Label
- Gateway: `GET https://api.apiclay.com/v1/api/discogsmusicdatabaseapi/label`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/discogsmusicdatabaseapi/artist?id=<id>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
