Navigation and service

OAI - overview

Short URL: http://www.dnb.de/EN/oai

OAI (externer linkOpen Archives Initiative) is an initiative aimed at defining an open interface for the exchange of metadata. Communication in such an interface takes place between the German National Library as the data provider and a service provider requesting the data. The data is collected automatically by an "OAI harvester". The protocol used for the communication is called OAI-PMH (externer linkOAI-Protocol for Metadata Harvesting). OAI permits continuous synchronisation of large amounts of data; this is based on the import of data from an up-to-date basic stock (dump) to a separate database.
Following login and authorisation, the German National Library allows its data to be searched using an HTTP or HTTPS interface and the OAI-PMH protocol.

Frequently Asked Questions (FAQ) / Troubleshooting

Standard of the OAI interface

Protocol: externer linkOAI-PMH Version 2.0

OAI-PMH Protocol

The OAI-PMH protocol is web-based. The OAI harvester works with simple requests using HTTP-GET or -POST and receives an HTTP response back from the data provider. Embedded in an XML structure, this response contains the requested metadata. An advantage is that an OAI repository can be searched even with a web browser.

OAI harvester

In order to use OAI to compare the data between the German National Library and a service provider, the service provider must have implemented an OAI harvester (e. g. externer linkOAI-PMH Harvester Manager) The OAI harvester calls itself repeatedly in a continuous loop. It executes a "ListRecords command" limited to the dataset (catalogue) defined for the service provider. In addition, the „externer linkListRecords-command“ is given the time of the last call in the form of a externer linkTime stamp.This ensures that

  •  Aufzählungno change is missed
  •  Aufzählungchanges are shown with minimum delay in the service provider's database
  •  Aufzählungno data which is irrelevant for the service provider is transported

OAI functions

The OAI-PMH protocol includes six basic functions which are appended to the baseURL (e.g. "http://services.dnb.de/oai/repository") using "?verb=":

  •  Aufzählung

    externer linkIdentify: Display general information about OAI repository, e.g.

    •  AufzählungrepositoryName
    •  AufzählungbaseURL
    •  AufzählungprotocolVersion

  •  Aufzählung

    externer linkListSets: Information about all data sets (catalogues) available in OAI repository

  •  Aufzählung

    externer linkListMetadataFormats: List of all data formats available in OAI repository

  •  Aufzählung

    GetRecord: Call of individual data records using the ID. The identification number of the data record concerned must be known for this (MARC 21: 035 $a with prefix DE-101 respectively DE-599)

    Parameter:

    •  Aufzählungidentifier: Identification number of required data record
    •  AufzählungmetadataPrefix: Name of the data format in which the data record is to be issued. The selection of values can be requested using the ListMetadataFormats command (see above).

  •  Aufzählung

    ListRecords: Harvest data records by entering the time period (from / until) and/or data sets. This is the core command of OAI. It permits selective harvesting, i.e. the harvester can restrict the request to data records which

    •  Aufzählungoriginate from a particular catalogue and
    •  Aufzählungwere created or changed in a particular period

    The time is given in externer linkUTC.

    Parameter:

    •  Aufzählungfrom / until: Points which define the time period for the selective harvesting. Depending on the OAI repository these can be either defined to the day (YYYY-MM-DD) or to the second (YYYY-MM-DDThh:mm:ssZ)
    •  Aufzählungset: The catalogue from which the data records originate
    •  AufzählungmetadataPrefix: see above
    •  AufzählungresumptionToken: Permits the return of part responses. The OAI harvester is sent a token which he can use for a new request to obtain the next responses from the OAI repository. The token sends back details of the date of expiry, the size of the total list and counter (optional).

German National Library catalogues (sets) accessible via OAI

SelectionValue for "set" parameter
Deutsche Nationalbibliografie without "Gemeinsame Normdatei" (GND)
dnb
Deutsche Nationalbibliografie, Series A (Monographs and periodicals from the publishers' booktrade)dnb:reiheA
Deutsche Nationalbibliografie, Series B (Monographs and periodicals from outside the publishers' booktrade)dnb:reiheB
Deutsche Nationalbibliografie, Series C (Maps)dnb:reiheC
Deutsche Nationalbibliografie, Series H (University Publications)dnb:reiheH
Deutsche Nationalbibliografie, Series M (Printed Music)dnb:reiheM
Deutsche Nationalbibliografie, Series T (Recorded Music)dnb:reiheT
Deutsche Nationalbibliografie, Series O (Online Publications)dnb:reiheO
Deutsche Nationalbibliografie, restricted to subject class
dnb:sg020 (example of library and information science)
Deutsche Nationalbibliografie, Series A, restricted to subject class
dnb:reiheA:sg720 (example of architecture)
Deutsche Nationalbibliografie, Catalogue Enrichment (TOC-Service)dnb:toc
Catalogue of Deutsche Nationalbibliothek with New Release Service and online dissertations without "Gemeinsame Normdatei" (GND)dnb-all
New Release Service (publishers' reports)dnb-all:reiheN
Online Publications (without limitation on Series O)
dnb-all:online
Restricted to subject class
dnb-all:online:sg020 (example of library and information science)
Online Dissertations dnb-all:online:dissertations
Restricted to subject class
dnb-all:online:dissertations:sg720 (example of architecture)
German Music Archive (DMA, incl. the collection of historical sound recordings)dnb-all:dma
"Gemeinsame Normdatei" (GND)
authorities

Formats

The following formats are offered in downloadChanges to UTF-8 character set (PDF, 25KB, Not barrier-free file.):

Format
MARC 21-XMLXML variant of MARC 21externer linkhttp://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
DNB Casual (oai_dc)Selection of Dublin-Core elements
only for bibliographic data
externer linkhttp://www.openarchives.org/OAI/2.0/oai_dc.xsd
RDFxml Linked Data Service
Limited to bibliographic records for which an RDFxml version is available.
The harvesting of redirects in RDFxml is implemented.
externer linkhttp://www.w3.org/2000/07/rdf.xsd

Access requirements

For free access to the OAI interface send an e-mail to the including your contact details, the required OAI set (e.g. bibliographic and/or authority data), the data format and, if applicable, details of the fixed IP address or IP address range. Alternatively it is also possible to obtain access using an individual access code (access token). You will receive a message from us as soon as access is activated for you.

Terms of use and purchase

From 1 July 2015 all bibliographic data of the German National Library and the authority data of the Integrated Authority File (GND) will be provided free of charge and can be freely re-used under "Creative Commons Zero" (externer linkCC0 1.0) terms.
The metadata and online interfaces are provided with no guarantee of their being continuous, punctual, error-free or complete, or of their not infringing the rights of third parties (e.g. personal rights and copyright).

Contact

Contact
Monday - Friday from 9.00 a.m. to 3.00 p.m.
Nicole von der HudeTel.: +49-69-1525-1632
Heike EichenauerTel.: +49-69-1525-1074

Practical examples

Syntax of an OAI request

Syntax of an OAI request with example and explanation
ExampleExplanation
http://services.dnb.de/oai/repository
https://services.dnb.de/oai/repository
Request to OAI server of the German National Library
?verb=ListIdentifiersCommand to server
&from=2015-04-23Parameter "from" defines the start of the query period
&until=2015-04-24Parameter "until" defines the end of the query period
&metadataPrefix=MARC21-xmlFormat desired for OAI reply
&set=authoritiesDefines the catalogue or set

Syntax of an OAI request with a specific ID number

http://services.dnb.de/oai/repository?verb=GetRecord&metadataPrefix=MARC21-xml&identifier=oai:dnb.de/authorities/118540238

Syntax of an OAI request for online dissertations from the "Social sciences, sociology, anthropology" subject class within a specific time period

http://services.dnb.de/oai/repository?verb=ListRecords&from=2012-04-01T14:55:00Z&until=2012-07-08T09:54:59Z&metadataPrefix=oai_dc&set=dnb-all:online:dissertations:sg300

Last update: 08.02.2016

This Page

Schriftbanner mit Deutscher Nationalbibliothek Leipzig, Frankfurt am Main