Thumbnails

Retrieve image thumbnails from the Europeana API.

https://europeana.eu/api/v2/thumbnail-by-url.json

Request

The thumbnail API doesn't require any form of authentication, providing your API key is optional. The thumbnail API always returns an image, whether the thumbnail exists or not. To use the Search API to verify whether a thumbnail exists you can add has_thumbnail=true to your search query, or check if the edmPreview field in the search or record response has a value (which is the URL of the thumbnail).

ParameterDatatypeDescription
sizeStringThe size of the thumbnail, can either be w200 (width 200) or w400 (width 400).
typeStringType of the default thumbnail (media image) in case the thumbnail does not exists, can be: IMAGE, SOUND, VIDEO, TEXT or 3D.
uriStringThe URL of the media resource of which a thumbnail should be returned. Note that the URL should be encoded.

Return a 400px thumbnail from the image located at https://www.dropbox.com/s/8gpbipwr4ipwj37/Austria_Gerstl.jpg?raw=1:

https://www.europeana.eu/api/v2/thumbnail-by-url.json?size=w400&type=IMAGE&uri=https%3A%2F%2Fwww.dropbox.com%2Fs%2F8gpbipwr4ipwj37%2FAustria_Gerstl.jpg%3Fraw%3D1

Response

The thumbnail API call responds with an image in the given size. If the thumbnail does not exist, the API returns a 'default' image which is specific to the 'type' that is provided.