Synth.Directory

API · ベータ版 0.1.1

このAPI

ディレクトリのすべてがJSONとして利用できます: 出典とメディア付きの主張、楽曲、アーティスト、楽器、検索、そしてウェブサイトと同じ審査待ちの列に入る新規エントリーの提案方法です。 このAPIはベータ版です。 バージョン 0.1.1。ディレクトリが定まるにつれ、フィールド名や形式は変わることがあります。変更内容はこのページの末尾に記載され、OpenAPIドキュメントは常にその時点の正確な契約を示します。

トークンを取得する

  1. アカウントを作成してログインしてください。
  2. 開く APIトークン を「自分のもの」から開いて作成してください。一度だけ表示され、次で始まります: sd_.
  3. すべてのリクエストにベアラートークンとして付けて送信してください。
curl -H "Authorization: Bearer sd_..." "https://synth.directory/api/v1/claims?q=juno&status=verified"

制限

トークンごとに1時間あたり 200 件のリクエストです。すべてのレスポンスにX-RateLimit-LimitとX-RateLimit-Remainingが付与されます。上限を超えるとJSONメッセージ付きの429が返されます。パートナーおよびディレクトリ自身のボット向けに無制限プランがあります。お問い合わせください。

読み取り

リストはページ分割されます: pageとper_page（最大100）、本文にnext_pageが含まれます。

  • 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= · 演奏者とプロデューサー · GET /api/v1/people/{id} · 承認済みのクレジットとともに
  • GET /api/v1/search?q= · アーティスト、楽曲、楽器を一つの答えで

ステータス: verified, potentially, submitted, inferred (ナレッジベースからの推測、出典はまだありません), disputed. 主張の行は、下の書き出し内容の1行のような形になります。

プリセット、評価、お気に入りはウェブサイト上の人間向けの機能です。APIには含まれず、書き出されることもありません。

提案

POST /api/v1/proposeは、ウェブサイトと全く同じように提案をキューに入れます。公開される前に人が確認します。トークン名は提案に記録されるため、審査でボットであることが分かります。

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

クレジットの区分：主張 played, programmed ・楽曲 produced, engineered, mixed, arranged. 人物は名前で大文字小文字を区別せずに照合されるか、新規作成されます。クレジットは事実であるため、プリセットとは異なりAPIとエクスポートに含まれます。

ディレクトリ全体

GET /export/manifest.json は公開されており、そこに何があるかを示します。 GET /export/claims.jsonl すべての主張をその出典と承認済みメディアとともに、1行に1つのJSONオブジェクトとしてストリーミングし、sinceとstatusによるフィルターに対応します。書き出し用トークンが必要です。お問い合わせください。

ライセンス

個々の事実はCC0です。編纂物としてのディレクトリ、および書き出しのような実質的な抜粋は、オープンデータベースライセンスの下にあります: ディレクトリにクレジットを付け、そこから派生させたデータベースを共有してください。クローズドな製品向けの商用ライセンスはBox Of Rulesから入手できます。

契約内容

OpenAPI 3.1ドキュメント · llms.txt · ai-catalog.json

変更履歴

  • 0.1.1 (2026年9月10日) 人物：主張および楽曲における演奏者・制作者のクレジット、人物関連エンドポイント、クレジット提案。
  • 0.1.0 (2026年9月10日) 最初のベータ版: トークン、1時間あたり200件、主張・楽曲・アーティスト・楽器・検索の読み取り、主張・出典・アーティスト・楽曲の提案、書き出しフィード。