ARCHE provides several interfaces to search and retrieve its data in programmatic ways.
ARCHE implements the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH). The corresponding endpoint can be found at https://arche.acdh.oeaw.ac.at/oaipmh. Please consult the OAI-PMH specification for further information on how to interact with this endpoint.
If you want to get a list of all records in ARCHE you can try this:
If you want to see information for a specific record you may for instance use this:
ARCHE provides metadata in the following representations via OAI-PMH:
- CMDI (set on ARCHE)
- Dublin Core (example on ARCHE)
- Kulturpool (set on ARCHE)
- ARCHE RDF/XML (example record on ARCHE)
You can get a list of all supported metadata formats with this:
Since resources in ARCHE cover a wide range of humanities data, OAI-PMH Sets were introduced to allow for selective harvesting. You can get a list of all sets with this:
Images (TIF, PNG) stored in ARCHE can be accessed through the IIIF protocol. The IIIF endpoint is implemented with Loris IIIF Image Server. To actually access an image’s IIIF endpoint you will need to add the parameter ‘?format=iiif’ to the image’s identifier.
E.g. if you want to access the IIIF endpoint of the image resource with the Identifier: https://id.acdh.oeaw.ac.at/glasersqueezes2015/rec1110000910/AT-OeAW-BA-3-27-A-A845.png you simply need to append the afore-mentioned parameter:
Alternatively you can simply click on the ‘IIIF Endpoint’ button displayed on the resource’s detail view page.
Please consult the IIIF Image API documentation for further information on how to interact with this endpoint.
BEACON is a file format to map local identifiers to external norm data records like VIAF or GND. A GND BEACON file for ARCHE can be found at https://arche.acdh.oeaw.ac.at/browser/sites/default/files/beacon.txt
Please note that this file is updated once a day but you can create an up-to-date version yourself by going to https://arche.acdh.oeaw.ac.at/browser/api/gnd?_format=json
ARCHE Entities JSON Endpoint
Basic JSON representations of ARCHE entities (Persons, Places, Organisations, Projects, Collections and Publications) can be retrieved through entity specific endpoints. The API is implemented with Drupal and the endpoints follow this URL schema:
These endpoints are primarily consumed for autocompletes by third party applications.
All persons named ‘Ines’:
All organisations with ‘press’ in the title:
All places called ‘Durbaib’:
All publications with ‘lang’ in the title:
ARCHE Resources as RDF
RDF serialisations (.ttl) of ARCHE resources can be retrieved by appending a ‘format=rdf’ or ‘format=metadata’parameter to the resource’s identifier like in the examples below:
This RDF serialization is provided by the EasyRDF library. Therefore, when you try to access an URL like the one above through a browser, ARCHE will return an HTML representation of the requested resource and NOT a .ttl representation. But if you send a GET request to the same URL with, for instance, CURL (or if you prefer some GUI you could use Postman) you will retrieve the RDF serialisation.
The metadata for the resources stored in ARCHE is already being harvested via OAI-PMH by external aggregators.
- CLARIN Virtual Language Observatory (VLO): collects language related resources. Click here to get an overview of ARCHE’s resources in VLO and click here to get to a more technical overview of the harvested records. The set provided by ARCHE can be found here.
- Kulturpool: collects digital Austrian cultural heritage assets. It also acts as a central data provider for Europeana. The harvested records are displayed here and can be found on Europeana as well. The set provided by ARCHE can be found here.