Logo

Docs

Overview

Canonical metadata for songs, albums, and artists.

Attention

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

OpenMusicMetadata is a free, read-only metadata API for canonical songs, albums, and artists. It is what Vleer uses to fix names, merge artists and fill in artwork, and you can use it in your own projects.

https://api.vleer.app/metadata/v1

Resource Types

  • song
  • album
  • artist

Main Workflows

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

GET /catalog/omm:song:0a1b2c3d4e5f6g7h
GET /catalog?ids=omm:song:0a1b2c3d4e5f6g7h,omm:album:1a2b3c4d5e6f7g8h
GET /catalog?isrc=USRC17607839
GET /catalog?upc=602455878540

Use /identify/{type} when you only have a name and need the best matching canonical resource.

GET /identify/song?name=blue&artist=example&album=example&duration=215000
GET /identify/album?name=blue&artist=example
GET /identify/artist?name=example

On this page