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

ids, isrc, and upc are separate lookup modes and cannot be combined in the same request.

Lookup requests support at most 100 values for ids, isrc, or upc.

Returned resources keep the request order. Missing values are omitted from data.

One Resource

GET /lookup/omm:song:1

The response is Single<Song | Album | Artist>.

Many by Id

GET /lookup?ids=omm:song:1,omm:album:2,omm:artist:3

The response is List<Song | Album | Artist>.

Many by ISRC

GET /lookup?isrc=USRC17607839

The response is List<Song>.

Many by UPC

GET /lookup?upc=602455878540

The response is List<Album>.

Includes

Includes are limited to one relationship level.

Songs can include albums and artists:

GET /lookup/omm:song:1?include=albums,artists

Albums can include artists:

GET /lookup/omm:album:2?include=artists