Logo

Docs

Overview

Canonical metadata for the OpenMusic ecosystem.

Attention

This is still in development. It is not final yet, and breaking changes can happen at any time.

OpenMusicMetadata is a read-only metadata API for canonical songs, albums, and artists. OpenMusic servers can use OpenMusicMetadata ids to map the same musical entity across different catalogs.

Resource Types

  • song
  • album
  • artist

Main Workflows

Use lookup when you already have OpenMusicMetadata ids, a song ISRC, or an album UPC.

GET /lookup/omm:song:1
GET /lookup?ids=omm:song:1,omm:album:2
GET /lookup?isrc=USRC17607839
GET /lookup?upc=602455878540

Use /match/{type} when you need to match metadata to one canonical OpenMusicMetadata resource.

GET /match/song?name=blue&artist=example
GET /match/album?name=blue&artist=example
GET /match/artist?name=example

On this page