Introduction

Searching for specific metadata records or datasets across the Europeana website and all our APIs may not always be fully self explanatory. For the Europeana website, there is a dedicated page that explains how to search on the http://europeana.eu . The full API documentation also explaining and listing all the possible search terms is available on Europeana Pro. But for some specific cases it is handy to have a few shortcuts, some specific queries to help solving a specific problem. In addition, we would like to also help you to search across our production website and APIs in the same way as on our preview website and APIs. This is what this page is aiming to achieve.

The API queries examples shared below use the api2demo key. For your own personal use of the API we encourage you have your own API key. To get this, apply here.

Production vs preview

Europeana.eu is the website you are familar with, which is where everything that is published will be visible. But we also have a preview environment, where everything will be before its published. You can work with this preview environment in the same way as with the production environment, but it is not really public as it is also not indexed by Google. Here you also find datasets that are depublished (e.g. because of broken links). This is also the staging environement we use to pause for feedback, before publishing the datasets. Same as for the websites, also APIs are available for production and preview. When using the production search APIs, it always starts with https://api.europeana.eu/record/v2/search.json?, while for preview it starts with https://metis-preview-api-prod.eanadev.org/api/v2/search.json?. In both environements, searching works in the exact same way.

Searching on europeana.eu

When searching on the Europeana website, the URL always starts with https://www.europeana.eu/en/search?, followed by the actual query, e.g. query=who%3AVermeer. Looking for everything from Vermeer will then lead to this URL: who:Vermeer - Search. With this in mind, more search queries can be developed and also search queries on our preview environment can be developed. The corresponding URL in Europeana preview is who:Vermeer - Search .

Below we list a few more queries that you asked us about in the past:

• content and metadata tiers combined query=edm_datasetName%3A08604%2A%20contentTier%3A2%20AND%20metadataTier%3AB

• by agents

  • query=who%3AVermeer

  • query=who%3ARembrandt%20OR%20who%3AVermeer

• by year

  • query=YEAR%3A1910&view=grid

  • query=YEAR%3A%5B1525%20TO%201527%5D

• by specific file extension in isShownBy

  • .wmv extension: view=grid&query=provider_aggregation_edm_isShownBy%3A%2a.wmv%2a

  • .jpg extension: view=grid&query=provider_aggregation_edm_isShownBy%3A%2a.jpg%2a

• IIIF items in Europeana query=sv_dcterms_conformsTo%3A%2Aiiif%2A

• provider_aggregation_edm_isShownAt ?query=provider_aggregation_edm_isShownAt%3A%2Aperiodicals.lib.unideb.hu%2Flista.php%3Fc%3Drege%2A

• has_media:* OR DATA_PROVIDER:"The British Library" ?query=has_media%3A%2A%20AND%20DATA_PROVIDER%3A%22The%20British%20Library%22&

• has_thumbnails ?query=has_thumbnails%3Atrue&qf=IMAGE_SIZE%3Alarge&qf=IMAGE_SIZE%3Amedium&qf=IMAGE_SIZE%3Aextra_large&qf=TYPE%3A%22IMAGE%22&locale=en&

• NOT(has_media:*) ?query=NOT%28has_media%3A%2A%29&qf=DATA_PROVIDER%3A%22The%20Trustees%20of%20the%20Natural%20History%20Museum%2C%20London%22&qf=PROVIDER%3A%22OpenUp%5C%21%22

• timestamp_created ?query=timestamp_created%3A%5B2016-01-01T00%3A00%3A0.000Z%20TO%202016-08-28T00%3A00%3A00.000Z%5D

• […..]

API search

When searching on the Europeana search API, the URL always starts with https://api.europeana.eu/record/v2/search.json?, followed by the actual query, e.g. query=PROVIDER:"CulturaItalia"&profile=facets&facet=contentTier&facet=metadataTier&rows=0&wskey=api2demo. Examples for full queries that are also coming from questions you asked in the past are listed below:

• all data providers per provider wskey=api2demo&query=PROVIDER:"Daguerreobase"&profile=facets&facet=DATA_PROVIDER

• content and metadata tier per provider query=PROVIDER:"CulturaItalia"&profile=facets&facet=contentTier&facet=metadataTier&rows=0&wskey=api2demo

• content and metadata tier per dataset query=edm_datasetName%3A2022706*&profile=facets&facet=contentTier&facet=metadataTier&rows=0&wskey=api2demo

• all datasets with LCNAF vocabulary query=skos_concept:*id.loc.gov*&wskey=api2demo&profile=facets&facet=edm_datasetName&rows=0

• example record with LCNAF vocabulary search.json?query=skos_concept:*id.loc.gov*&wskey=api2demo

• europeana id of enriched records query=edm_datasetName:718_Museu_AjuntamentDeGirona*+AND+skos_concept:*vocab.getty.edu*+AND+((skos_concept:*wikidata.org*)+OR+(edm_agent:*wikidata.org*))&wskey=api2demo&profile=facets&facet=europeana_id&f.europeana_id.facet.limit=2000

• number of records in a dataset &query=edm_datasetName:9200519_Ag_BnF_Gallica_typedoc_manuscrits&profile=facets&facet=edm_datasetName&rows=0&f.edm_datasetName.facet.limit=10&wskey=api2demo

• IIIF resources in a dataset query=edm_datasetName:15515*&rows=0&start=1&facet=wr_svcs_hasservice&profile=facets&f.wr_svcs_hasservice.facet.limit=2000&wskey=api2demo 

• IIIF resources with manifest wskey=api2demo&rows=0&query=wr_svcs_hasservice:*+AND+wr_dcterms_isReferencedBy:*&profile=facets&facet=edm_datasetName&f.edm_datasetName.facet.limit=2000 

• IIIF resources without manifest wskey=api2demo&rows=0&query=wr_svcs_hasservice:*+AND+NOT%20wr_dcterms_isReferencedBy:*&profile=facets&facet=edm_datasetName&f.edm_datasetName.facet.limit=2000 

• [….]