SPARQL-Endpunkt

Überblick

Der Kulturpool stellt seinen gesamten Datenbestand zusätzlich als RDF-Graph bereit und macht ihn über einen SPARQL-Endpunkt abfragbar. Damit lassen sich Fragen stellen, die sich mit der Suche API nicht formulieren lassen — etwa über Beziehungen zwischen Objekten, Personen und Orten hinweg, und in föderierten Abfragen sogar über den Kulturpool hinaus.

Ausführliche Dokumentation folgt

Diese Seite ist eine Kurzbeschreibung. Eine vollständige Dokumentation mit Vokabular, Graph-Struktur und weiteren Beispielabfragen wird nachgereicht.

Abfrageoberfläche

Unter der folgenden Adresse steht eine interaktive Abfrageoberfläche (YASGUI) bereit, in der Abfragen direkt im Browser geschrieben und ausgeführt werden können:

https://sparql.kulturpool.at/

Die Oberfläche ist mit einer föderierten Beispielabfrage vorbelegt, die Kulturpool-Objekte mit Personendaten aus Wikidata und der GND verknüpft.

Endpunkt

Programmatisch wird der Endpunkt unter dieser URL angesprochen — per GET mit dem Query-Parameter query oder per POST. Eine Authentifizierung ist nicht erforderlich, CORS ist freigeschaltet.

https://sparql.kulturpool.at/query

curl -s -G "https://sparql.kulturpool.at/query" \
  -H "Accept: application/sparql-results+json" \
  --data-urlencode 'query=PREFIX dc: <http://purl.org/dc/elements/1.1/>
PREFIX edm: <http://www.europeana.eu/schemas/edm/>
SELECT ?cho ?title WHERE {
  ?cho a edm:ProvidedCHO ;
       dc:title ?title ;
       dc:creator "Gustav Klimt" .
}
LIMIT 5'

Daten im Graph

Die Daten folgen dem Europeana Data Model (EDM) — demselben Modell, das auch die Objekt API und die Datensets ausliefern.

Jedes Kulturgut trägt eine stabile URI, die dessen Kulturpool-ID (uuid) enthält:

https://id.kulturpool.at/{uuid}/cho

Damit lässt sich zwischen SPARQL und den übrigen APIs hin- und herwechseln: Eine uuid aus einem Suchtreffer führt direkt zur URI im Graph, und umgekehrt liefert die Objekt API zu jeder URI den vollständigen Datensatz.

Wann welcher Zugang?

Anwendungsfall	Empfohlener Weg
Volltext- und Facettensuche	Suche API
Einzelnes Objekt in voller Tiefe	Objekt API
Vollständiger Datenbestand zur lokalen Verarbeitung	Datensets
Abfragen über Beziehungen, Verknüpfung mit externen Datenquellen	SPARQL (diese Seite)