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: externer linkVersion 1.1
Retrievalsprache externer linkCQL Context Set Version 1.2, externer linkConformance-Level 2

SRU-Funktionen

SRU umfasst die Basisfunktionen:

  •  Aufzählung

    externer linkExplain: Selbstbeschreibung in XML-Standardformat, enthält Informationen über

    •  AufzählungDatenbank
    •  AufzählungIndizes
    •  AufzählungDatenformate
  •  Aufzählung

    Search / Retrieve: Suchanfrage

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

Ü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)
externer linkhttp://services.dnb.de/sru/dnb?operation=explain&version=1.1
Katalog des Deutschen Musikarchivs (DMA)
externer linkhttp://services.dnb.de/sru/dnb.dma?operation=explain&version=1.1
Authorities: Katalog der Gemeinsamen Normdatei (GND)
Einschränkungen nach Entitäten
externer linkhttp://services.dnb.de/sru/authorities?operation=explain&version=1.1

Formate

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

Format
MARC21-xmlXML-Variante von MARC 21externer linkhttp://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
DNB Casual (oai_dc)Auswahl von Dublin-Core-Elementen
nur für Titeldaten
externer linkhttp://www.openarchives.org/OAI/2.0/oai_dc.xsd
RDFxmlLinked Data Serviceexterner linkhttp://www.w3.org/2000/07/rdf.xsd

Zugangsvoraussetzungen

Für einen kostenfreien Zugang zur SRU-Schnittstelle senden Sie bitte eine E-Mail an den 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 für Sie freigeschaltet ist.

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 (externer linkCC0 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
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
http://services.dnb.de/sru
https://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):
http://services.dnb.de/sru/authorities?version=1.1&operation=searchRetrieve&query=WOE%3DRupp%20Elisabeth%20and%20BBG%3DTp*&recordSchema=MARC21-xml

Ts* (Sachbegriff):
http://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":
http://services.dnb.de/sru/authorities?version=1.1&operation=searchRetrieve&query=WOE%3Dsozialistenkongress%20and%20COD%3Ds&recordSchema=MARC21-xml

URL-Kodierung

In der externer linkURL-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
Ä=%C3%84
Ö=%C3%96
Ü=%C3%9C
ä=%C3%A4
ö=%C3%B6
ü=%C3%BC
ß=%C3%9F
(Leerschritt, Spatium)=%20
" (Anführungszeichen)=%22
/ (Slash)=%2F
\ (Backslash)=%5C
externer linkListe 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. externer linkDiakritika durch externer linkUTF-8 hexadezimal) im Suchbegriff (siehe externer linkStandard).
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): externer link10 Datensätze pro Antwort
Maximal: externer link100 Datensätze pro Antwort bei Angabe von ...&maximumRecords=100 (mögliche Werte 1 bis 100)
Abruf externer linkweiterer Datensätze: ...&startRecord=101 (mögliche Werte 1 bis unendlich)

SRU / Z39.50

SRU bietet gegenüber Z39.50 folgende Vorteile:

Letzte Änderung: 08.02.2016

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

Diese Seite

Schriftbanner mit Deutscher Nationalbibliothek Leipzig, Frankfurt am Main