APIs

You can add a Europeana search box to your blog or website. Our simple wizard takes you through the process step-by-step and gives you a snippet of code to embed.

Configure the widget to search all collections and data providers within Europeana, or refine it to suit your website, e.g. to search only within Public Domain or Creative Commons, or only content from a specific country.

The Europeana Search Widget works with…

• Sites that you host yourself.
• Blogger/Blogspot
• Tumblr

The Europeana Search Widget doesn’t work with…

Blogs hosted on Wordpress.com

Set up your Europeana Search Widget

1. Go to the search widget page.
2. Introduction tab: The Europeana Search widget is presented. A progress bar shows you how far you are through the process. To start configuring your widget, tap ‘Next’ or the ‘Filter’ tab heading.
3. Filter tab: If you want your widget to include the entire Europeana dataset, you can go straight to the ‘Style’ tab. Tap ‘Next’ or the ‘Style’ tab heading. To tailor your search widget: Keyword search: By default, the widget searches the entire Europeana dataset. You can restrict the search to a key word or phrase. To do this, enter the key word(s) in the ‘Search for’ field. For example, if you are adding a widget to your First World War blog about military uniform, you might type ‘uniform’. All the normal search functions work in this field, for example, use double quotes for a phrase, e.g. “military uniform”, use ‘AND’ to include searches on two words or ‘NOT’ to hide results for a particular word, e.g. ‘uniform AND war’ or ‘uniform NOT school’.

Providers: By default, the widget returns results from all of Europeana’s providers. You can restrict it to your chosen providers. Tap ‘Change’ next to ‘All Providers’ and select the providers you need. You can search for a provider using the search field above the list. The providers are presented in order of the size of their contributions to Europeana. The number in brackets shows how many items from that provider are available. If the name of the provider is followed by an arrow, then they are a data aggregator, tap the arrow to see the institutions included in their collection. Note: you can select more than one.

Countries: By default, the widget returns results from all countries. You can restrict it to your chosen countries. Tap ‘Change’ next to ‘All Providing Countries’ and select the countries you need. The countries are presented in order of the size of their contributions to Europeana. The number in brackets shows how many items from that country are available. Note: you can select more than one. To clear your selection and start again, tap ‘Clear’.

Media types: By default, the widget returns results of all media types - image, text, sound, video and 3D. You can restrict it to only the media types you’re interested in. Tap ‘Change’ next to ‘All Media Types’ and select the types you need. The media types are presented in order of size. The number in brackets shows how many items of that media type are available. Note: you can select more than one. To clear your selection and start again, tap ‘Clear’.

Copyright: By default, the widget returns results with any copyright status. You can restrict this, for example, to only show re-usable content. Tap ‘Change’ next to ‘All Copyrights’ and select the statuses you need. The copyright statuses are presented in order of size. The number in brackets shows how many items of that status are available. Note: you can select more than one. To clear your selection and start again, tap ‘Clear’.

Languages: By default, the widget returns results in all languages. You can restrict it to your chosen languages. Tap ‘Change’ next to ‘All Languages’ and select the languages you need. The languages are presented in order of the size of their representation in Europeana. The number in brackets shows how many items of each language are available. Note: you can select more than one. To clear your selection and start again, tap ‘Clear’.

When you have selected all your filters, tap ‘Next’ or the ‘Style’ tab heading. 4. Style tab: You can choose a black or white widget and select to include thumbnails or not. Select the style you would like to use. Tap ‘Next’ or the ‘Preview’ tab heading.

1. Preview tab: Your widget will be displayed. Please note that the widget is responsive and so expands to fit the width of its container. For this reason, it may be a different size on the preview than it will be on your own web page. If you wish to amend the widget’s properties, just go back to the ‘Search’, ‘Filter’ or ‘Style’ tab and make your changes.

If you are happy with your widget, simply copy the ‘Embed’ code displayed and paste this into your web page.

We would love to know how you are using this search widget, please tell us by dropping us an email at api@europeana.eu