Release Lookup Parameters
The Release Lookup page (and the Release Actions page) accept the following query parameters:
url- Release URL from one of the supported providers. Can be specified multiple times to lookup multiple sources.
gtin- Barcode (GTIN, EAN or UPC) of the release. Can be specified instead of or in addition to
url. region- ISO 3166-1 alpha-2 country code for providers with region-specific pages or API. Multiple values can be specified as fallbacks. The default regions (GB, US, DE, JP) can be changed in the settings.
category- Category of the (additional) providers which should be looked up by barcode. Supported values:
default- Default providers which have digital music from many genres. Includes: deezer, itunes, spotify, tidal
preferred- Preferred providers from the user’s settings (your settings). Includes: ?
all- All providers. Not recommended to use as releases are usually not available from all providers. Includes: musicbrainz, deezer, itunes, spotify, tidal, bandcamp, beatport, mora
In addition to the predefined categories, any provider can be added to the combined lookup by appending its internal name as a query parameter without value (or even with a release ID as value).
Examples
- Lookup by URL and using your preferred providers:
/release?url=URL&category=preferred - Lookup by barcode on Deezer and Spotify using the region GB:
/release?gtin=BARCODE&deezer&spotify®ion=GB
Supported Providers
| Display Name | Internal Name | Supported URL Formats | Barcode Lookup | ||
|---|---|---|---|---|---|
| MusicBrainz | musicbrainz | {(beta|test).}?musicbrainz.(org|eu) | /:type(artist|release)/:id | ✓ | |
| Deezer | deezer | {www.}?deezer.com | /:language(\w{2})?/:type(album|artist|track)/:id(\d+) | ✓ | |
| iTunes | itunes | {geo.}?(itunes|music).apple.com | /:region(\w{2})?/:type(album|artist|song)/:slug?/{id}?:id(\d+) | ✓ | |
| Spotify | spotify | open.spotify.com | {/intl-:language}?/:type(artist|album|track)/:id | ✓ | |
| Tidal | tidal | {(www|listen).}?tidal.com | {/browse}?/:type(album|artist|track|video)/:id(\d+)/*? | ✓ | |
| Bandcamp | bandcamp | :artist.bandcamp.com | /:type(album|track)/:title | ✗ | |
| Beatport | beatport | www.beatport.com | /:language(\w{2})?/:type(artist|label|release|track)/:slug/:id | ✓ | |
| mora | mora | mora.jp | /package/:labelCode([0-9]+)/:packageId{/}? | ✗ | |
Supported URL formats are specified using the URL Pattern API