Logo

Docs

Albums

Albums

Fetch albums, look them up, and request album relationships.

Albums group songs into releases. They expose release metadata and can include tracks and artists.

List Albums

GET /albums?limit=25&offset=0&sort=releaseDate

The response is a List<Album>.

Look Up Albums

Albums can be looked up by id or UPC.

GET /albums/lookup?ids=album_1,omm:album:album_2
GET /albums/lookup?upc=602547673951,888430877625

Lookup requests should contain at most 100 ids.

Fetch One Album

GET /album/album_123

The response is Single<Album>.

Include Relationships

GET /album/album_123?include=tracks,artists
GET /album/album_123?include=tracks,tracks.artists

Use scoped fields to keep large responses small:

GET /album/album_123?include=tracks&fields[album]=name,artworkUrl&fields[song]=name,durationMs

Relationship Endpoints

GET /album/album_123/rel/tracks
GET /album/album_123/rel/artists

Relationship endpoints return lists and support fields[...], limit, offset, and sort.

On this page