How to search Europeana website and API
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
by year
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&
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
[….]