Synth.Directory

API · Beta 0.1.1

API

Semua yang ada di direktori tersedia sebagai JSON: klaim beserta sumber dan medianya, rekaman, artis, instrumen, pencarian, dan cara mengusulkan entri baru yang masuk ke antrean tinjauan yang sama seperti situs web. API sedang dalam versi beta. Versi 0.1.1. Nama dan bentuk field dapat berubah seiring direktori menjadi stabil; perubahan tercantum di bagian bawah halaman ini, dan dokumen OpenAPI selalu menjadi kontrak terkini yang persis.

Mendapatkan token

  1. Buat akun dan masuk.
  2. Buka Token API di bawah Milik saya dan buat satu. Ditampilkan sekali; dimulai dengan sd_.
  3. Kirim sebagai bearer token di setiap permintaan.
curl -H "Authorization: Bearer sd_..." "https://synth.directory/api/v1/claims?q=juno&status=verified"

Batasan

200 permintaan per jam per token. Setiap respons membawa X-RateLimit-Limit dan X-RateLimit-Remaining; jika melebihi batas Anda mendapat 429 dengan pesan JSON. Ada tingkat tanpa batas untuk mitra dan bot direktori sendiri; tanyakan.

Membaca

Daftar dipaginasi: page dan per_page (hingga 100), dengan next_page di body.

  • 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= · performer dan produser · GET /api/v1/people/{id} · dengan kredit mereka yang diterima
  • GET /api/v1/search?q= · artis, rekaman dan instrumen dalam satu jawaban

Status: verified, potentially, submitted, inferred (dari basis pengetahuan, belum ada sumber), disputed. Baris klaim terlihat seperti satu baris ekspor di bawah ini.

Preset, peringkat, dan favorit hanya untuk orang di situs web. Semuanya tidak ada di API dan tidak akan pernah diekspor.

Mengusulkan

POST /api/v1/propose mengantrekan usulan persis seperti yang dilakukan situs web; seseorang meninjaunya sebelum apa pun dipublikasikan. Nama token dicatat pada usulan sehingga bot terlihat saat peninjauan.

{"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"}

Bagian kredit: klaim played, programmed · rekaman produced, engineered, mixed, arranged. Orang dicocokkan berdasarkan nama tanpa membedakan huruf besar/kecil, atau dibuat baru. Kredit adalah fakta, jadi berbeda dari preset, kredit ada di API dan ekspor.

Seluruh direktori

GET /export/manifest.json bersifat publik dan menyatakan apa yang ada di sana. GET /export/claims.jsonl mengalirkan setiap klaim beserta sumber dan media yang diterima, satu objek JSON per baris, dengan filter since dan status. Ini memerlukan token ekspor; tanyakan.

Lisensi

Fakta individual berlisensi CC0. Direktori sebagai kompilasi, dan kutipan besar apa pun seperti ekspor, berada di bawah Open Database Licence: kreditkan direktori, dan bagikan kembali basis data yang Anda turunkan darinya. Lisensi komersial untuk produk tertutup tersedia dari Box Of Rules.

Kontrak

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

Perubahan

  • 0.1.1 (10 September 2026) Orang: kredit performer dan produser pada klaim dan rekaman, endpoint orang, proposal kredit.
  • 0.1.0 (10 September 2026) Beta pertama: token, 200 per jam, membaca klaim, rekaman, artis, instrumen dan pencarian; usulan untuk klaim, sumber, artis dan rekaman; feed ekspor.