openMusiXplora

Forschung und Datenzugang

API: suchen, lesen und zitieren

Eine Person anhand ihrer Originalkennung finden und eine bestimmte Datenausgabe zitieren.

Beispiele aus Datenausgabe 1 vom 20. November 2026.

Die Suche eingrenzen

Die ersten drei Treffer für „Focht“ gehören zur Eintragsart Person. Über die Originalkennung lässt sich derselbe Eintrag auch dann wiederfinden, wenn mehrere Personen denselben Nachnamen tragen. Das Beispiel benötigt Python 3.

import json
from urllib.parse import urlencode
from urllib.request import urlopen

api = "https://musixplora.modavis.org/version/1/api/v1/"
query = urlencode({"q": "Focht", "limit": 3})
with urlopen(api + "entities?" + query, timeout=20) as response:
    hits = json.load(response)["items"]
for hit in hits:
    print(hit["id"], hit["label"])

Datenausgabe 1 liefert f0394 Josef Focht, f1915 Franc Focht und f1916 Karl Focht.

Einen Eintrag herunterladen

curl -fsS 'https://musixplora.modavis.org/version/1/api/v1/entities/f0394' | python3 -m json.tool

Im JSON stehen unter id die originale Kennung und unter label die Ansetzungsform. record_status gibt an, wie der Eintrag überliefert ist. Bei Josef Focht steht dort master. links enthält die Adressen der Beziehungen, Kennungen, Katalogangaben und Quellennachweise. Groß- und Kleinschreibung sowie Leerzeichen können Bestandteil einer Kennung sein. In einer URL wird ein Leerzeichen im Pfad als %20 geschrieben.

Den Forschungsstand zitierbar machen

Geben Sie Eintragstitel, Originalkennung, Nummer und Datum der Datenausgabe sowie die Adresse unter links.citation an. Unter „Diesen Eintrag zitieren“ steht die vollständige Angabe auch im RIS-Format bereit. Für eine Auswertung halten Sie zusätzlich Suchparameter und Auswahlkriterien fest.