Base URLCopy Anchor Link

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

Resource idsCopy Anchor Link

Resource ids are OpenMusicMetadata ids in the form omm:TYPE:ID, where ID is 16 lowercase alphanumeric characters.

omm:song:0a1b2c3d4e5f6g7h
omm:album:1a2b3c4d5e6f7g8h
omm:artist:2a3b4c5d6e7f8g9h

Each resource has an id, a singular type, attributes, and for songs and albums relationships.

RelationshipsCopy Anchor Link

Every response contains all available attributes and relationships. There is nothing to opt into.

Relationships are one level deep. Albums nested in a song's relationships don't have relationships of their own.

ArtworkCopy Anchor Link

artworkUrl may contain {w} and {h} placeholders. Replace them with the width and height in pixels you want.

https://example.com/image/{w}x{h}.jpg

Rate limitsCopy Anchor Link

Requests are rate limited per client IP with a burst of 20 requests, refilling one request every 50 ms. Exceeding the limit returns 429, see Error Response.

CORSCopy Anchor Link

Browser requests are only allowed from an allowlist of origins. Call the API from a server or native app.