IMPORTANT

europeana4j has been promoted to the europeana account in github, and renamed to europeana-client.

We suggest europeana4j users to upgrade to the new project:

https://github.com/europeana/europeana-client

About europeana4j

europeana4j is a Java library wich allows applications to search and retrieve Europeana data, including millions of books, paintings, films, museum objects and archival records that have been digitised throughout Europe.

The library provides a clean Java interface to the Europeana API, with JavaBeans encapsulation, transparent pagination of results and utilities to copy and verify thumbnails.

More info

About Europeana: http://en.wikipedia.org/wiki/Europeana

Europeana portal: http://www.europeana.eu

About the Europeana API: http://www.europeana-libraries.eu/web/api

Note: The Europeana API is only available to Europeana network partners at the moment. You must have an API key in order to use the API, and in consequence, europeana4j library. Terms of use: http://www.europeana-libraries.eu/web/api/terms-of-use

How to use the library

The main class to access the API is EuropeanaConnection. This sample code retrieves the results of a query as JavaBeans.

EuropeanaQuery query = new EuropeanaQuery ("picasso"); query.setType ("IMAGE"); EuropeanaConnection europeana = new EuropeanaConnection (apiKey); EuropeanaResults res = europeana.search (query, 1000);

There's also an utility class to copy and verify thumbnails, ThumbnailsAccessor.