GMD API v2 Overview

Welcome to the GMD API v2. In addition to this documentation, you can find information and resources on the Gracenote Help Center.

The GMD API is a REST service that provides music understanding and enrichment to enable improved display, search, navigation, discovery, and recommendations. The API supports text searches and ID-based lookups of artists, albums, recordings, and tracks. These operations return descriptive metadata such as genre, origin, mood, and other related content items.

The GMD API has endpoints for getting following data objects:

• Artist
• AlbumEdition
• Recording
• Track

plus, additional data object to inform correlations between our rich descriptors:

• Descriptor Correlations

You can retrieve these data objects using lookup by ID or text search:

• Lookup
  • GNID (Gracenote ID): available for artist, album, and recording objects.
  • Streaming Service IDs: available only for albums and recordings.
  • GN TMS Person ID: available only for artists.
• Search
  • Text Search: available for artist, album, and recording objects.
• Explore
  • Retrieve a list of objects (artists, album editions, or recordings) sorted and filtered by properties such as genre and popularity.