This is documentation for version 20140520 which is deprecated. The current version is 20220401. We will continue to make deprecated versions available to customers who still use them, but new customers should use the latest version.

Querying images

GET /20140520/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

A Discogs image lookup is of the form:

GET /20140520/images/discogs/[discogs release id]/1

This returns the primary image for the specified Discogs release, using the Discogs release ID. If there is no primary image for this release, or the release doesn't exist, returns a HTTP 404 error code.

Examples

/20140520/images/discogs/1806152/1

Retrieves the primary image for 13 by Blur.

MusicBrainz images

MusicBrainz image lookups are of the form:

GET /20140520/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

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

Retrieves the first image for Now Dance 98.

comments powered by Disqus
© 2012-2024 elsten software limited, Unit 4934, PO Box 6945, London, W1A 6US, UK | terms and conditions | privacy policy