Logo

Docs

Resources

Resources

Canonical metadata resource types.

All resources share the same core shape.

type Type = "song" | "album" | "artist";

interface Resource {
  id: `omm:${Type}:${string}`;
  type: Type;
}

Relationships

Only these relationships exist, and they are always returned:

ResourceRelationships
songalbums, artists
albumartists

Value formats

  • releaseDate is YYYY, YYYY-MM or YYYY-MM-DD.
  • genres is omitted when empty, never an empty array.
  • artworkUrl may contain {w} and {h} placeholders, see API Specifications.
  • artistNames is ordered by name.

On this page