openMusiXplora

Research and data access

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.tool

In 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.