API: finding, reading and citing records
Identify a person by their original identifier and cite a specific data edition.
Examples from data edition 1, issued on 20 November 2026.
Narrow the search
The first three hits for “Focht” belong to the Person class. The original identifier distinguishes people who share a surname. This example runs with 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"])Edition 1 returns f0394 Josef Focht, f1915 Franc Focht and f1916 Karl Focht.
Retrieve an individual record
curl -fsS 'https://musixplora.modavis.org/version/1/api/v1/entities/f0394' | python3 -m json.toolIn the JSON, id is the original identifier and label is the catalogue heading. The record_status field describes how the entry survives. Josef Focht has status master. The links object gives the addresses of the relationships, identifiers, statements and source references. Case and spaces can be significant in an original identifier. Encode a space in a URL path as %20.
Cite the edition used
Include the record title, original identifier, edition number and date, and the address in links.citation. “Cite this record” also provides a RIS file. For an analysis, document the query parameters and your selection criteria.