Synth.Directory

API · Beta 0.1.1

Die API

Alles im Verzeichnis ist als JSON verfügbar: Behauptungen mit ihren Quellen und Medien, Aufnahmen, Künstler, Instrumente, Suche, und eine Möglichkeit, neue Einträge vorzuschlagen, die in dieselbe Prüfwarteschlange wie die Website gelangen. Die API befindet sich in der Beta-Phase. Version 0.1.1. Feldnamen und -formen können sich ändern, während sich das Verzeichnis festigt; Änderungen sind am Fuß dieser Seite aufgeführt, und das OpenAPI-Dokument ist immer der genaue aktuelle Vertrag.

Ein Token erhalten

  1. Erstellen Sie ein Konto und melden Sie sich an.
  2. Öffnen API-Tokens unter Meine und erstellen Sie eines. Es wird einmal angezeigt; es beginnt mit sd_.
  3. Senden Sie es als Bearer-Token bei jeder Anfrage.
curl -H "Authorization: Bearer sd_..." "https://synth.directory/api/v1/claims?q=juno&status=verified"

Limits

200 Anfragen pro Stunde und Token. Jede Antwort trägt X-RateLimit-Limit und X-RateLimit-Remaining; über dem Limit erhalten Sie einen 429 mit einer JSON-Nachricht. Für Partner und den eigenen Bot des Verzeichnisses gibt es eine unbegrenzte Stufe; fragen Sie nach.

Lesen

Listen sind paginiert: page und per_page (bis zu 100), mit next_page im Antworttext.

  • GET /api/v1/claims · q, status, origin, artist, instrument, role, since, order · GET /api/v1/claims/{id}
  • GET /api/v1/records · q, artist_id, status=wanted|claimed, since, order, with=claims · GET /api/v1/records/{id}
  • GET /api/v1/artists?q= · GET /api/v1/artists/{id}
  • GET /api/v1/instruments · q, maker, kind · GET /api/v1/instruments/{id}
  • GET /api/v1/people?q= · Interpreten und Produzenten · GET /api/v1/people/{id} · mit ihren akzeptierten Credits
  • GET /api/v1/search?q= · Künstler, Aufnahmen und Instrumente in einer Antwort

Status: verified, potentially, submitted, inferred (aus der Wissensdatenbank, noch keine Quelle), disputed. Eine Behauptungszeile sieht aus wie eine Zeile des Exports unten.

Presets, Bewertungen und Favoriten sind nur für Personen auf der Website. Sie sind nicht in der API und werden nie exportiert.

Vorschlagen

POST /api/v1/propose reiht einen Vorschlag genau wie die Website ein; eine Person prüft ihn, bevor etwas veröffentlicht wird. Der Token-Name wird beim Vorschlag vermerkt, damit Bots in der Prüfung sichtbar sind.

{"kind": "claim", "work_id": 101, "instrument": "Minimoog", "instrument_maker": "Moog", "role": "lead",
 "source": {"grade": "A", "kind": "interview", "url": "https://...", "publication": "Sound On Sound",
            "author": "...", "published_on": "1983-06-01", "quote": "one sentence, verbatim"}}
{"kind": "source", "claim_id": 202, "source": {...}}
{"kind": "artist", "name": "Tool", "country": "US", "refs": ["https://en.wikipedia.org/...", "https://musicbrainz.org/..."]}
{"kind": "record", "artist_id": 12, "title": "Lateralus", "year": 2001, "refs": ["https://musicbrainz.org/..."]}
{"kind": "credit", "subject": "claim", "id": 202, "person": "Vince Clarke", "part": "played", "note": "on the intro only"}
{"kind": "credit", "subject": "work", "id": 101, "person": "Flood", "part": "produced"}

Credit-Teile: Behauptung played, programmed · Aufnahme produced, engineered, mixed, arranged. Eine Person wird ohne Berücksichtigung der Groß- und Kleinschreibung anhand des Namens zugeordnet oder neu angelegt. Credits sind Fakten, daher sind sie, anders als Presets, in der API und im Export enthalten.

Das ganze Verzeichnis

GET /export/manifest.json ist öffentlich und zeigt, was vorhanden ist. GET /export/claims.jsonl streamt jede Behauptung mit ihren Quellen und akzeptierten Medien, ein JSON-Objekt pro Zeile, mit since- und status-Filtern. Es benötigt ein Export-Token; fragen Sie nach.

Lizenz

Einzelne Fakten stehen unter CC0. Das Verzeichnis als Zusammenstellung, und jeder wesentliche Auszug wie der Export, steht unter der Open Database Licence: nennen Sie das Verzeichnis, und geben Sie eine daraus abgeleitete Datenbank zurück. Eine kommerzielle Lizenz für geschlossene Produkte ist bei Box Of Rules erhältlich.

Der Vertrag

OpenAPI-3.1-Dokument · llms.txt · ai-catalog.json

Änderungen

  • 0.1.1 (10. September 2026) Personen: Interpreten- und Produzenten-Credits bei Behauptungen und Aufnahmen, Personen-Endpunkte, Credit-Vorschläge.
  • 0.1.0 (10. September 2026) Erste Beta: Token, 200 pro Stunde, Lesen von Behauptungen, Aufnahmen, Künstlern, Instrumenten und Suche; Vorschläge für Behauptungen, Quellen, Künstler und Aufnahmen; der Export-Feed.