API Data Fields

Introduction

Each Europeana field has different names in different contexts. We have a theoretical and RDF context, where we returns qualified names such as dc:title. In search the same field becomes proxy_dc_title, in search result it is simply title, and in object display it is the Proxy object's dcTitle field. Some fields as part of aggregated fields, and facets. These are special fields which cover the content of multiple fields to provide a common entry point for similar fields.

Sample record with all fields

For testing purposes, a sample record is available which contains almost all available fields in the EDM schema. This record can be used for testing purposes and to make sure that your application can work with all the different types of fields and information. The identifier for this record is:

/000002/_UEDIN_214

Classes, fields and facets

Meaning of columns:

  • EDM Field: The field's name in the Europeana metadata scheme
  • Name in search: The name we should use in search queries
  • Datatype: The fields data type in searching
  • Name in search result: The field's name in search call response. For some, there are different variations such as title and dcTitleLangAware which are the same but with a different structure (single value vs multi-lingual list)
  • Name (record): The field's name in the object call response
  • Aggregated Field/Facet: The name of aggregated fields and facets which cover this field.

edm:ProvidedCHO

Represents the Cultural Heritage Object, the metadata itself sent by the data provider is described within the Provider Proxy, see the EDM Primer for the differences between the edm:ProvidedCHO and the Proxies.

EDM FieldName in searchDatatypeName in search resultName (record)Aggregated Field/Facet
@rdf:aboutProvidedCHO.about
owl:sameAsProvidedCHO.owlSameAs

ore:Proxy

A Proxy represents different views of an object so that the metadata generated by Europeana can be distinguished from the original metadata sent by the Data Provider.

Differences between a Provider's Proxy and Europeana Proxy:

  • a provider proxy has edm:type and a europeana proxy does not.
  • a europeana proxy has edm:year and a provider proxy does not.
EDM FieldName in searchDatatypeName in search resultName (record)Aggregated Field/Facet
@rdf:about (Europeana Proxy)stringProxy.about
@rdf:about (Provider Proxy)stringProxy.about
dc:contributorproxy_dc_contributorstringdcContributorProxy.dcContributorwho
dc:coverageproxy_dc_coveragestringProxy.dcCoveragesubject
dc:creatorproxy_dc_creatorstringdcCreator
dcCreatorLangAware
Proxy.dcCreatorwho
dc:dateproxy_dc_datestringProxy.dcDatewhen
dc:descriptionproxy_dc_descriptionstringdcDescription
dcDescriptionLangAware
Proxy.dcDescription
dc:formatproxy_dc_formatstringProxy.dcFormatwhat
dc:identifierproxy_dc_identifierstringProxy.dcIdentifier
dc:languageproxy_dc_languagestringProxy.dcLanguage
dc:publisherproxy_dc_publisherstringProxy.dcPublisher
dc:relationstringProxy.dcRelation
dc:rightsproxy_dc_rightsstringProxy.dcRights
dc:sourceproxy_dc_sourcestringProxy.dcSource
dc:subjectproxy_dc_subjectstringProxy.dcSubjectsubject, what
dc:titleproxy_dc_titlestringtitle
dcTitleLangAware
Proxy.dcTitletitle
dc:typeproxy_dc_typestringProxy.dcTypewhat
dcterms:alternativeproxy_dcterms_alternativetextProxy.dctermsAlternativetitle
dcterms:createdproxy_dcterms_createdstringProxy.dctermsCreatedwhen
dcterms:hasFormatstringProxy.dctermsHasFormat
dcterms:hasPartproxy_dcterms_hasPartstringdctermsHasPartProxy.dctermsHasPart
dcterms:hasVersionstringProxy.dctermsHasVersion
dcterms:isFormatOfstringProxy.dctermsIsFormatOf
dcterms:isPartOfproxy_dcterms_isPartOfstringProxy.dctermsIsPartOf
dcterms:isReferencedBystringProxy.dctermsIsReferencedBy
dcterms:isReplacedBystringProxy.dctermsIsReplacedBy
dcterms:isRequiredBystringProxy.dctermsIsRequiredBy
dcterms:issuedproxy_dcterms_issuedstringProxy.dctermsIssuedwhen
dcterms:isVersionOfstringProxy.dctermsIsVersionOf
dcterms:mediumproxy_dcterms_mediumstringProxy.dctermsMediumwhat
dcterms:provenanceproxy_dcterms_provenancestringProxy.dctermsProvenance
dcterms:referencesstringProxy.dctermsReferences
dcterms:replacesstringProxy.dctermsReplaces
dcterms:requiresstringProxy.dctermsRequires
dcterms:spatialproxy_dcterms_spatialstringdctermsSpatialProxy.dctermsSpatialwhere, subject
dcterms:tableOfContentsstringProxy.dctermsTOC
dcterms:temporalproxy_dcterms_temporalstringProxy.dctermsTemporalwhen, subject
edm:currentLocationproxy_edm_currentLocationstringProxy.edmCurrentLocation
edm:hasMetproxy_edm_hasMetstringProxy.edmHasMet
edm:hasTypestringProxy.edmHasType
edm:incorporatesstringProxy.edmIncorporates
edm:isDerivativeOfstringProxy.edmIsDerivativeOf
edm:isNextInSequencestringProxy.edmIsNextInSequence
edm:isRelatedToproxy_edm_isRelatedTostringProxy.edmIsRelatedTo
edm:isRepresentationOfstringProxy.edmIsRepresentationOf
edm:isSimilarTostringProxy.edmIsSimilarTo
edm:isSuccessorOfstringProxy.edmIsSuccessorOf
edm:realizesstringProxy.edmRealizes
edm:typeproxy_edm_typestringProxy.edmTypeTYPE
edm:unstored (DEPRECATED)stringProxy.edmUnstored
edm:wasPresentAtstringProxy.edmWasPresentAt
edm:usetTag (DEPRECATED)
edm:yearproxy_edm_yearstringYEAR, when
ore:proxyForstringProxy.proxyFor
ore:proxyInstringProxy.proxyIn
owl:sameAsstring
rdf:type

ore:Aggregation

EDM FieldName in searchDatatypeName in search resultName (record)Aggregated Field/Facet
@rdf:aboutstringAggregation.about
ore:aggregatesstringAggregation.aggregates
edm:aggregatedCHOstringAggregation.aggregatedCHO
edm:dataProviderprovider_aggregation_edm_dataProviderstringedmDataProviderAggregation.edmDataProviderDATA_PROVIDER
edm:hasViewprovider_aggregation_edm_hasViewstringAggregation.hasView
edm:intermediateProviderprovider_aggregation_edm_intermediateProviderstringAggregation.intermediateProvider
edm:isShownAtprovider_aggregation_edm_isShownAtstringAggregation.edmIsShownAt
edm:isShownByprovider_aggregation_edm_isShownBystringAggregation.edmIsShownBy
edm:objectprovider_aggregation_edm_objectstringedmObjectAggregation.edmObject
edm:providerprovider_aggregation_edm_providerstringproviderAggregation.edmProviderPROVIDER
dc:rightsprovider_aggregation_dc_rightsstringAggregation.dcRights
edm:rightsprovider_aggregation_edm_rightsstringAggregation.edmRightsRIGHTS
edm:ugcedm_UGCbooleanugcAggregation.edmUgcUGC
edm_previewNoDistributebooleanAggregation.edmPreviewNoDistribute

edm:EuropeanaAggregation

EDM FieldName in searchDatatypeName in search resultName (record)Aggregated Field/Facet
@rdf:aboutstringEuropeanaAggregation.about
dc:creatorstringEuropeanaAggregation.dcCreator
edm:aggregatedCHOstringEuropeanaAggregation.aggregatedCHO
edm:datasetNameedm_datasetNamestring
edm:countryeuropeana_aggregation_edm_countrystringcountryEuropeanaAggregation.edmCountryCOUNTRY
edm:hasViewstringEuropeanaAggregation.edmHasView
edm:isShownBystringEuropeanaAggregation.edmIsShownBy
edm:landingPagestringEuropeanaAggregation.edmLandingPage
edm:languageeuropeana_aggregation_edm_languagestringEuropeanaAggregation.edmLanguageLANGUAGE
edm:previewstringEuropeanaAggregation.edmPreview
edm:rightsstringEuropeanaAggregation.edmRights
ore:aggregatesstringEuropeanaAggregation.aggregates

edm:WebResource

EDM FieldName in searchDatatypeName (record)Aggregated Field/Facet
@rdf:aboutedm_webResourcestringWebResource.about
dc:descriptionstringWebResource.dcDescription
dc:formatstringWebResource.dcFormat
dc:rightswr_dc_rightsstringWebResource.webResourceDcRights
dc:sourcestringWebResource.dcSource
dcterms:conformsTostringWebResource.dctermsConformsTo
dcterms:createdstringWebResource.dctermsCreated
dcterms:extentstringWebResource.dctermsExtent
dcterms:hasPartstringWebResource.dctermsHasPart
dcterms:isFormatOfstringWebResource.dctermsIsFormatOf
dcterms:isReferencedBywr_dcterms_isReferencedBystringWebResource.dctermsIsReferencedBy
dcterms:isPartOfstringWebResource.isPartOf
dcterms:issuedstringWebResource.dctermsIssued
edm:isNextInSequencewr_edm_isNextInSequencestringWebResource.isNextInSequence
edm:previewstringWebResource.edmPreview
edm:rightswr_edm_rightsstringWebResource.webResourceEdmRights
edm:codecNamestringWebResource.edmcodecName
ebucore:hasMimeTypestringWebResource.ebucorehasMimeType
ebucore:fileByteSizestringWebResource.ebucorefileByteSize
ebucore:durationstringWebResource.ebucoreduration
ebucore:widthstringWebResource.ebucorewidth
ebucore:heightstringWebResource.ebucoreheight
edm:spatialResolutionstringWebResource.edmspatialResolution
ebucore:sampleSizestringWebResource.ebucoresampleSize
ebucore:sampleRatestringWebResource.ebucoresampleRate
ebucore:bitRatestringWebResource.ebucorebitRate
ebucore:frameRatestringWebResource.ebucoreframeRate
edm:hasColorSpacestringWebResource.edmhasColorSpace
edm:componentColorstringWebResource.edmcomponentColor
ebucore:orientationstringWebResource.ebucoreorientation
ebucore:audioChannelNumberstringWebResource.ebucoreaudioChannelNumber
rdf:typestringWebResource.rdfType
svcs:has_servicewr_svcs_hasservicestringWebResource.svcsHasService

cc:License

EDM FieldName in searchDatatypeName (record)
@rdf:aboutwr_cc_licensestringLicense.about
provider_aggregation_cc_licensestring
provider_aggregation_odrl_inherited_fromstring
cc:deprecatedOnwr_cc_deprecated_onstringLicense.ccDeprecatedOn
provider_aggregation_cc_deprecated_ondate

svcs:Service

EDM FieldName in searchDatatypeName (record)
@rdf:aboutsvcs_servicestringService.about
svcs:conformsTosv_dcterms_conformsTostringService.dctermsConformsTo
doap:implementsstringService.doapImplements

edm:Agent

EDM FieldName in searchDatatypeName in search resultName (record)Aggregated Field/Facet
@rdf:aboutedm_agentstringedmAgentAgent.about
skos:prefLabelag_skos_prefLabeltextedmAgentLabelAgent.prefLabelwho
skos:altLabelag_skos_altLabeltextAgent.altLabelwho
skos:hiddenLabel
skos:notestringAgent.note
dc:datestringAgent.dcDate
dc:identifierstringAgent.dcIdentifier
dcterms:isPartOfstringAgent.dcTermsIsPartOf
dcterms:hasPartstringAgent:dcTermsHasPart
edm:beginstringAgent.begin
edm:endstringAgent.end
edm:hasMetstringAgent.edmHasMet
edm:isRelatedTostringAgent.edmIsRelatedTo
edm:wasPresentAtstringAgent.edmWasPresentAt
foaf:nameag_foaf_namestringAgent.foafNamewho
rdaGr2:biographicalInformationstringAgent.rdaGr2BiographicalInformation
rdaGr2:dateOfBirthag_rdagr2_dateOfBirthstringAgent.rdaGr2DateOfBirth
rdaGr2:dateOfDeathag_rdagr2_dateOfDeathstringAgent.rdaGr2DateOfDeath
rdaGr2:dateOfEstablishmentstringAgent.rdaGr2DateOfEstablishment
rdaGr2:dateOfTerminationstringAgent.rdaGr2DateOfTermination
rdaGr2:genderstringAgent.rdaGr2Gender
rdaGr2:placeOfBirthag_rdagr2_placeOfBirthstringAgent.rdaGr2PlaceOfBirth
rdaGr2:placeOfDeathag_rdagr2_placeOfDeathstringAgent.rdaGr2PlaceOfDeath
rdaGr2:professionOrOccupationag_rdagr2_professionOrOccupationstringAgent.rdaGr2ProfessionOrOccupation
owl:sameAsstringAgent.owlSameAs

skos:Concept

EDM FieldName in searchDatatypeName in search resultName (record)Aggregated Field/Facet
@rdf:aboutskos_conceptstringedmConceptTermConcept.about
skos:prefLabelcc_skos_prefLabeltextedmConceptPrefLabelConcept.prefLabelwhat
skos:altLabelcc_skos_altLabeltextConcept.altLabelwhat
skos:hiddenLabel
skos:broaderstringedmConceptBroaderTermConcept.broader
stringedmConceptBroaderLabelwhat
skos:narrowerstringConcept.narrower
skos:relatedstringConcept.related
skos:broadMatchstringConcept.broadMatch
skos:narrowMatchstringConcept.narrowMatch
skos:relatedMatchstringConcept.relatedMatch
skos:exactMatchstringConcept.exactMatch
skos:closeMatchstringConcept.closeMatch
skos:notestringConcept.note
skos:notationstringConcept.notation
skos:inSchemestringConcept.inScheme

edm:Place

EDM FieldName in searchDatatypeName in search resultName (record)Aggregated Field/Facet
@rdf:aboutedm_placestringedmPlacePlace.about
wgs84_pos:latpl_wgs84_pos_latstringedmPlaceLatitudePlace.latitude
wgs84_pos:longpl_wgs84_pos_longstringedmPlaceLongitudePlace.longitude
wgs84_pos:altpl_wgs84_pos_altstringPlace.altitude
skos:prefLabelpl_skos_prefLabeltextedmPlaceLabelPlace.prefLabelwhere
skos:altLabelpl_skos_altLabeltextPlace.altLabelwhere
skos:notestringPlace.note
dcterms:hasPartstringPlace.dcTermsHasPart
dcterms:isPartOfstringedmPlaceBroaderTerm, dctermsIsPartOfPlace.isPartOf
edm:isNextInSequencePlace.isNextInSequence
owl:sameAsstringPlace.owlSameAs

edm:TimeSpan

EDM FieldName in searchDatatypeName in search resultName (record)Aggregated Field/Facet
@rdf:aboutedm_timespantextedmTimespanTimeSpan.about
skos:prefLabelts_skos_prefLabeltextedmTimespanLabelTimeSpan.prefLabelwhen
skos:altLabelts_skos_altLabeltextTimeSpan.altLabelwhen
skos:hiddenLabelstring
skos:notestringTimeSpan.note
dcterms:hasPartstringTimeSpan.dcTermsHasPart
dcterms:isPartOfstringedmTimespanBroaderTermTimeSpan.isPartOf
stringedmTimespanBroaderLabel
edm:beginstringedmTimespanBeginTimeSpan.begin
edm:endstringedmTimespanEndTimeSpan.end
edm:isNextInSequenceTimeSpan.isNextInSequence
crm:P79F.beginning_is_qualified_byTimeSpan.crmP79FBeginningIsQualifiedBy
crm:P80F.end_is_qualified_byTimeSpan.crmP80FEndIsQualifiedBy
owl:sameAsstringTimeSpan.owlSameAs

edm:FullTextResource

Fields outside of EDM schema

Name in searchDatatypeName in search resultName (record)Aggregated Field/Facet
europeana_completenessintegereuropeanaCompleteness, completenessCOMPLETENESS
timestampdate
europeana_idstringid

Aggregated fields

Name in searchDatatype
subjecttext
texttext
titletext
whattext
whentext
wheretext
whotext

Metadata facets

Name in searchDatatype
COMPLETENESSstring
CONTRIBUTORstring
COUNTRYstring
DATA_PROVIDERstring
LANGUAGEstring
PROVIDERstring
RIGHTSstring
TYPEstring
UGCstring
YEARstring

Technical metadata facets

Facets that relate to the metadata extracted from the media, such as images and videos.

Facet nameDatatypeMedia typeDescription
MEDIAbooleanTo indicate whether an URL to the full media file is present in the edm:isShownBy or edm:hasView metadata and is resolvable.
MIME_TYPEstringMime-type of the file, e.g. image/jpeg
IMAGE_SIZEstringImageSize in megapixels of an image, values: small (< 0.5MP), medium (0.5-1MP), large (1-4MP) and extra_large (> 4MP)
IMAGE_COLOURbooleanImageLists 'true' for colour images. An alias to this facet is IMAGE_COLOR, note that for non-colour images you cannot provide the 'false' value. Use the greyscale-facet instead.
IMAGE_GREYSCALEbooleanImageLists 'true' for greyscale images. An alias to this facet is IMAGE_GRAYSCALE, note that for colour images you cannot provide the 'false' value. Use the colour-facet instead.
COLOURPALETTEstringImageThe most dominant colours present in images, expressed in HEX-colour codes. See colour palette.
IMAGE_ASPECTRATIOstringImagePortrait or landscape.
VIDEO_HDbooleanVideoLists 'true' for videos that have a resolution higher than 576p.
VIDEO_DURATIONstringVideoDuration of the video, values: short (< 4 minutes), medium (4-20 minutes) and long (> 20 minutes).
SOUND_HQbooleanSoundLists 'true' for sound files where the bit depth is 16 or higher or if the file format is a lossless file type (ALAC, FLAC, APE, SHN, WAV, WMA, AIFF & DSD). Note that 'false' does not work for this facet.
SOUND_DURATIONstringSoundDuration of the sound file, values: very_short (< 30 seconds), short (30 seconds - 3 minutes), medium (3-6 minutes) and long (> 6 minutes).
TEXT_FULLTEXTbooleanTextLists 'true' for text media types which are searchable, e.g. a PDF with text.