# Gracenote GMD API v3 (Beta)

**Canonical:** https://apis.io/apis/gracenote/gmd-api-v3/  
**Provider:** Gracenote — https://apis.io/providers/gracenote/  
**Base URL:** https://api.gmd.music.gracenote.com/v3  
**Documentation:** https://devportal.gracenote.com/audio/gmd-api-v3/overview

Gracenote GMD API v3 (Beta) is one of 21 APIs that [Gracenote](https://apis.io/providers/gracenote/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Beta, Entitlements, Music, and Music Metadata. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

The beta third generation of the Global Music Data API, adding album masters, descriptor correlations, descriptor hierarchies and an entitlements lookup that lets a key ask what it is licensed for. Gracenote states in the specification itself that interfaces are subject to change, and it is the only Gracenote API that declares a full 400/401/403/404/429/500 error surface.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/artists/search` | Artist Text Search |
| GET | `/artists/lookup` | Lookup Artist(s) by ID |
| GET | `/artists/explore` | Explore Artist(s) |
| GET | `/recordings/search` | Recording Text Search |
| GET | `/recordings/lookup` | Lookup Recording(s) by ID |
| GET | `/recordings/explore` | Explore Recordings(s) |
| GET | `/albumEditions/search` | AlbumEdition Text Search |
| GET | `/albumEditions/lookup` | Lookup AlbumEdition(s) by ID |
| GET | `/albumEditions/explore` | Explore Album Edition(s) |
| GET | `/albumMasters/explore` | Explore Album Master(s) |
| GET | `/entitlements/lookup` | Lookup Entitlements |
| GET | `/descriptorCorrelations/lookup` | Calculate Artist and Recording similarity |
| GET | `/descriptorHierarchy/lookup` | Retrieve Structured Music Descriptor Taxonomies |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gracenote/refs/heads/main/openapi/gracenote-gmd-api-v3-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/gracenote/refs/heads/main/overlays/gracenote-gmd-api-v3-overlay.yaml
- **APIReference** — https://devportal.gracenote.com/catalog/gmd-v3
- **ErrorCatalog** — https://devportal.gracenote.com/audio/gmd-api-v3/error-codes

## Other Gracenote APIs (12)

- [Gracenote OnConnect API](https://apis.io/apis/gracenote/onconnect-api/)
- [Gracenote OnConnect Data API](https://apis.io/apis/gracenote/onconnect-data-api/)
- [Gracenote Celebrities API](https://apis.io/apis/gracenote/gracenote-celebrities-api/)
- [Gracenote Lineups API](https://apis.io/apis/gracenote/gracenote-lineups-api/)
- [Gracenote Movies API](https://apis.io/apis/gracenote/gracenote-movies-api/)
- [Gracenote Programs API](https://apis.io/apis/gracenote/gracenote-programs-api/)
- [Gracenote Series API](https://apis.io/apis/gracenote/gracenote-series-api/)
- [Gracenote Sports API](https://apis.io/apis/gracenote/gracenote-sports-api/)
- [Gracenote Stations API](https://apis.io/apis/gracenote/gracenote-stations-api/)
- [Gracenote On API](https://apis.io/apis/gracenote/on-api/)
- [Gracenote OnConnect Lookup APIs](https://apis.io/apis/gracenote/onconnect-lookup-apis/)
- [Gracenote GVD API](https://apis.io/apis/gracenote/gvd-api/)

## Tags

Beta, Entitlements, Music, Music Metadata

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gracenote/gmd-api-v3/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gracenote/.