Navigation und Service

SRU im Überblick

SRU (Search / Retrieve via URL) ist ein standardisiertes Webservice-Protokoll, um Datenbanken im Internet abzufragen. Die Ergebnisse der Suche werden in einem definierten XML-Format zur Verfügung gestellt.
Das SRU-Protokoll ermöglicht die gezielte Suche mittels Suchindizes und Suchbegriffen und die Übernahme der entsprechenden Treffer in die eigene Umgebung. Die 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.
Nach Anmeldung und Autorisierung bietet die Deutsche Nationalbibliothek über das HTTP- oder HTTPS-Protokoll und das SRU-Protokoll eine Anfragemöglichkeit auf ihre Daten.

SRU - häufig gestellte Fragen (FAQ) / Fehlerbehebung

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 in XML-Standardformat, enthält Informationen über

    • Datenbank
    • Indizes
    • Datenformate
  • Search / Retrieve: Suchanfrage

    • Retrievalsprache: CQL (Contextual Query Language)
    • Boolesche Operatoren (and, or, not) werden unterstützt
      Aufbau einer Suchanfrage: ... Indexbezeichnung%3DSuchbegriff%20or%20Suchbegriff ...

Zugangsvoraussetzungen

Für einen kostenfreien Zugang zur SRU-Schnittstelle benötigen Sie ein personalisiertes Kundenkonto. Dazu nutzen Sie bitte das Registrierungsformular und senden dann eine E-Mail an mit Ihren Kontaktdaten, dem gewünschten Katalog (Titel- o./u. Normdaten), dem Datenformat und ggf. der Angabe einer festen IP-Adresse bzw. IP-Bereich. Alternativ ist der Zugriff über einen individuellen Zugangscode (access token) möglich. Sie erhalten eine Nachricht von uns, sobald der Zugang freigeschaltet ist.

Über SRU verfügbare Kataloge der Deutschen Nationalbibliothek

Über SRU verfügbare Kataloge der Deutschen Nationalbibliothek
KatalogauswahlSelbstbeschreibung in XML-Standardformat
Katalog der Deutschen Nationalbibliothek (DNB) ohne Gemeinsame Normdatei (GND)
http://services.dnb.de/sru/dnb?operation=explain&version=1.1
Katalog des Deutschen Musikarchivs (DMA)
http://services.dnb.de/sru/dnb.dma?operation=explain&version=1.1
Authorities: Katalog der Gemeinsamen Normdatei (GND)
Einschränkungen nach Entitäten
http://services.dnb.de/sru/authorities?operation=explain&version=1.1

Formate

Folgende Formate werden in der Codierung UTF-8 decomposed ("zerlegt") angeboten:

Formate
FormatFormatbezeichnungStandard
MARC21-xmlXML-Variante von MARC 21http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
DNB Casual (oai_dc)Auswahl von Dublin-Core-Elementen
nur für Titeldaten
http://www.openarchives.org/OAI/2.0/oai_dc.xsd
RDF (RDF/XML)Linked Data Servicehttp://www.w3.org/2000/07/rdf.xsd

Nutzungs- und Bezugsbedingungen

Ab 1. Juli 2015 sind alle Titeldaten der Deutschen Nationalbibliothek und die Normdaten der Gemeinsamen Normdatei (GND) kostenfrei unter "Creative Commons Zero"-Bedingungen (CC0 1.0) zur freien Nachnutzung verfügbar.
Die Metadaten und Online-Schnittstellen werden ohne Gewähr dafür angeboten, dass sie ununterbrochen, pünktlich, fehlerfrei, vollständig sind und dass sie nicht Rechte Dritter (z. B. Persönlichkeits- oder Urheberrechte) verletzen.

Ansprechpartner/Kontakt

Ansprechpartner / Kontakt
Ansprechpartner
Montag - Freitag von 9 - 15 Uhr
Nicole von der HudeTel.: +49 69 1525-1632
Heike EichenauerTel.: +49 69 1525-1074

Praktische Beispiele

Syntax einer SRU-Anfrage

Syntax einer SRU-Anfrage mit Beispiel und Erklärung
BeispielErklärung
https://services.dnb.de/sru
http://services.dnb.de/sru
Anfrage an SRU-Server der DNB
/dnbFestlegen des Kataloges (z. B. DNB, GND ...)
?version=1.1Angabe der SRU-Version, Standard
&operation=searchRetrieveBefehl an den Server
&query=Anfrage formulieren
WOE%3DGoetheWOE ist die Indexbezeichnung, %3D ist die URL-Kodierung für =, Suchbegriff hier: Goethe
&recordSchema=MARC21-xmlgewünschtes Format der SRU-Antwort

Einschränkung nach Entitäten im Katalog "authorities"

Folgende Einschränkungen sind möglich:

Einschränkung nach Entitäten
EntitätenBibliografische Gattung
GeografikumTg*
KongressTf*
KörperschaftTb*
NameTn*
PersonTp*
SachbegriffTs*
WerkTu*

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=WOE%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.

URL-Kodierung
ZeichenUTF-8 hexadezimal
Ä=%C3%84
Ö=%C3%96
Ü=%C3%9C
ä=%C3%A4
ö=%C3%B6
ü=%C3%BC
ß=%C3%9F
(Leerschritt, Spatium)=%20
" (Anführungszeichen)=%22
/ (Slash)=%2F
\ (Backslash)=%5C
Liste weiterer Zeichen

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 z. B. vor und nach booleschen Operatoren sind mit %20 (... KRAFTWERK%20not%20ROBOTER ...) 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 unendlich)

SRU / Z39.50

SRU bietet gegenüber Z39.50 folgende Vorteile:

Letzte Änderung: 28.09.2016

Kurz-URL: http://www.langzeitarchivierung.de/sru

Diese Seite

Schriftbanner mit Deutscher Nationalbibliothek Leipzig, Frankfurt am Main