Querying images

GET /20220401/images/[source specific]

All image lookups are rooted at the /images/ path. Clients replace [source specific] with the query data specific to the image they are looking for.

Mandatory parameters for all queries

All queries must contain the following:

user_key: Your API key.

Discogs images

There are two types of Discogs image lookups. The first is using the Discogs image ID, the second allows an "indexed" lookup, returning the n^th image.

Discogs image lookups by ID

A Discogs image lookup, using the image ID, is of the form:

GET /20220401/images/discogs/[discogs release id]/[discogs image id]

This returns the specified image from Discogs, from our image cache if possible. If the images doesn't exist, returns a HTTP 404 error code.

Discogs image lookups by index

The n^th image for a given release can be returned using an index integer. /1 is reserved for the primary image for a Discogs release. If there is no primary image, the first secondary image is returned. There are no guarantees made about the order in which images are returned.

Examples

/20220401/images/discogs/1144968/1225188125

Retrieves the primary image for Elastica by Elastica.

/20220401/images/discogs/1144968/1

Retrieves the first image for Elastica by Elastica, which is a "primary" image.

MusicBrainz images

MusicBrainz image lookups are of the form:

GET /20220401/images/musicbrainz/[MusicBrainz Identifier]/[image index]

This returns the nth image (as denoted by the image index) for the MusicBrainz release identified by the MusicBrainz Identifier. If there is no image for this release, or the release doesn't exist, returns a HTTP 404 error code.

Examples

/20220401/images/musicbrainz/b627dd57-415c-4d77-91bb-bfe52b1e9990/1

Retrieves the first image for Now Dance 98.