Gezielte Suche und Übernahme von Titel- und Normdaten

Über SRU (Search/Retrieve via URL) können Sie mit Suchindizes und Suchbegriffen gezielt in den Daten der Deutschen Nationalbibliothek suchen und diese anschließend in die eigene Umgebung übernehmen. Die Ergebnisse der Suche stehen in einem definierten XML-Format zur Verfügung.
Anfragen werden in der Retrievalsprache CQL (Contextual Query Language) formuliert.

Der SRU-Standard wurde von der Library of Congress veröffentlicht und ist eine Weiterentwicklung des Z39.50-Protokolls.

Eine Übersicht aller verfügbaren Metadaten und der verschiedenen Bezugsmöglichkeiten finden Sie hier.

Standards der SRU-Schnittstelle

Protokoll SRU: Version 1.1
Retrievalsprache CQL Context Set Version 1.2, Conformance-Level 2

SRU-Funktionen

SRU umfasst die Basisfunktionen:

• Explain: Selbstbeschreibung im XML-Standardformat, enthält Informationen über

  • Katalog
  • Indizes und unterstützte Sortierparameter
  • Datenformate

• Search/Retrieve: Suchanfrage

  • Retrievalsprache: CQL (Contextual Query Language)

  • Boolesche Operatoren (and, or, not) werden unterstützt. Zu jedem Suchbegriff muss ein Indexkürzel angegeben werden, ansonsten erfolgt die Suche im voreingestellten Standardindex WOE. Syntax einer Suchanfrage:

    ... Indexkürzel%3DSuchbegriff%20or%20Indexkürzel%3DSuchbegriff ...

  • Hilfe zur Formulierung von Suchanfragen mit CQL

• Sort: Sortierung der Ergebnismenge

  • Der Sortierparameter wird nicht im Rahmen der SRU Version 1.1 unterstützt, sondern als Teil der CQL Context Set Version 1.2. Bei welchen Indizes der Sortierparameter unterstützt wird, ist im katalogspezifischen SRU-Explain dokumentiert und durch die Angabe sort="true" erkennbar, eine Kombination ist nicht möglich.
    Syntax einer Suchanfrage: sort.descending oder sort.ascending

Zugangsvoraussetzungen

Der Zugang zur SRU-Schnittstelle ist kostenfrei und ohne Registrierung möglich.

Verfügbare Kataloge

Formate

Detaillierte Informationen zu den angebotenen Formaten finden Sie hier.

Nutzungs- und Bezugsbedingungen

Detaillierte Informationen zu den Nutzungs- und Bezugsbedingungen finden Sie hier.

Praktische Beispiele

SRU-Anfrage für die Titeldaten eines Heftes bzw. Kalenderwoche (KW) des Neuerscheinungsdienstes oder einer Reihe der Deutschen Nationalbibliografie: Die Angabe einer Kalenderwoche erfolgt nach dem Muster: JJReiheKW z. B. 24N05 oder für die Reihe A entsprechend 24A05 im Index „WVN“. Die Kalenderwoche wird immer zweistellig angegeben, bei Kalenderwoche 1 bis 9 mit führender Null.

Beispiel: https://services.dnb.de/sru/dnb?version=1.1&operation=searchRetrieve&query=WVN%3D24A05&recordSchema=MARC21-xml

Folgende Einschränkungen sind möglich:

Das Sternchen * (Asterisk) steht als Platzhalter für eine beliebige Anzahl von Zeichen und ist unbedingt direkt an den Wert anzufügen.

Beispiele für entsprechende SRU-Anfragen:

Tp* (Person)

https://services.dnb.de/sru/authorities?version=1.1&
operation=searchRetrieve&
query=PER%3DRupp%20Elisabeth%20and%20BBG%3DTp*&
recordSchema=MARC21-xml

Ts* (Sachbegriff)

https://services.dnb.de/sru/authorities?version=1.1&
operation=searchRetrieve&
query=WOE%3DMarketing%20and%20BBG%3DTs*&
recordSchema=MARC21-xml

Schlagwörter erhalten Sie über die Einschränkung mittels "COD=s"

https://services.dnb.de/sru/authorities?version=1.1&
operation=searchRetrieve&
query=WOE%3Dsozialistenkongress%20and%20COD%3Ds&
recordSchema=MARC21-xml

URL-Kodierung

In der URL-Kodierung werden Umlaute nach UTF-8 und mit vorangestelltem %-Zeichen kodiert (Prozentkodierung).
Beispiel: Kleinbuchstabe ö in UTF-8 = C3 B6 und mit vorangestellten %-Zeichen = %C3%B6.

Zur Verwendung von „=“ in einer Anfrage (... query=dc.title=musik ...) empfehlen die Vorgaben die Ersetzung des 2. „=“ durch „%3D“ (... query=dc.title%3Dmusik ...) und die Ersetzung von Sonderzeichen (z. B. Diakritika durch UTF-8 hexadezimal) im Suchbegriff (siehe Standard).
Leerzeichen zum Beispiel vor und nach booleschen Operatoren sind mit %20 (... SW%3DKRAFTWERK%20not%20SW%3DROBOTER ...) zu ersetzen (abhängig vom Client).

Anzahl der gelieferten Datensätze pro Anfrage

Standard (default): 10 Datensätze pro Antwort
Maximal: 100 Datensätze pro Antwort bei Angabe von ...&maximumRecords=100 (mögliche Werte 1 bis 100)
Abruf weiterer Datensätze: ...&startRecord=101 (mögliche Werte 1 bis 99.000)

Häufig gestellte Fragen (FAQ)

Kontakt

schnittstellen-service@dnb.de

Aktuelles