Synth.Directory

API · Beta 0.1.1

API:et

Allt i katalogen finns tillgängligt som JSON: påståenden med sina källor och media, inspelningar, artister, instrument, sökning, och ett sätt att föreslå nya poster som hamnar i samma granskningskö som webbplatsen. API:et är i beta. Version 0.1.1. Fältnamn och former kan ändras allteftersom katalogen stabiliseras; ändringar listas längst ner på denna sida, och OpenAPI-dokumentet är alltid det exakta aktuella kontraktet.

Skaffa en token

  1. Skapa ett konto och logga in.
  2. Öppna API-tokens under Mina och skapa en. Den visas en gång; den börjar med sd_.
  3. Skicka den som en bearer-token i varje förfrågan.
curl -H "Authorization: Bearer sd_..." "https://synth.directory/api/v1/claims?q=juno&status=verified"

Gränser

200 förfrågningar i timmen per token. Varje svar har X-RateLimit-Limit och X-RateLimit-Remaining; över gränsen får du en 429 med ett JSON-meddelande. En obegränsad nivå finns för partner och katalogens egen bot, fråga.

Läsning

Listor är paginerade: page och per_page (upp till 100), med next_page i svarskroppen.

  • 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= · utövare och producenter · GET /api/v1/people/{id} · med sina godkända krediteringar
  • GET /api/v1/search?q= · artister, inspelningar och instrument i ett svar

Statusar: verified, potentially, submitted, inferred (från kunskapsbasen, ingen källa ännu), disputed. En påstående-rad ser ut som en rad i exporten nedan.

Presets, betyg och favoriter är bara för personer på webbplatsen. De finns inte i API:et och kommer aldrig att exporteras.

Föreslå

POST /api/v1/propose köar ett förslag precis som webbplatsen gör; en person granskar det innan något publiceras. Tokenens namn registreras på förslaget så att botar är synliga vid granskning.

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

Roller: påstående played, programmed · inspelning produced, engineered, mixed, arranged. En person matchas mot namnet utan hänsyn till stora och små bokstäver, eller skapas. Krediteringar är fakta, så till skillnad från presets finns de i API:et och exporten.

Hela katalogen

GET /export/manifest.json är offentlig och säger vad som finns där. GET /export/claims.jsonl strömmar varje påstående med sina källor och godkänd media, ett JSON-objekt per rad, med filtren since och status. Den kräver en exporttoken, fråga.

Licens

Enskilda fakta är CC0. Katalogen som sammanställning, och varje väsentligt utdrag som exporten, omfattas av Open Database Licence: kreditera katalogen, och dela tillbaka en databas du härleder från den. En kommersiell licens för slutna produkter finns tillgänglig från Box Of Rules.

Kontraktet

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

Ändringar

  • 0.1.1 (10 september 2026) Personer: kreditering av utövare och producenter på påståenden och inspelningar, personer-slutpunkter, krediteringsförslag.
  • 0.1.0 (10 september 2026) Första betan: tokens, 200 i timmen, läsning av påståenden, inspelningar, artister, instrument och sökning; förslag för påståenden, källor, artister och inspelningar; exportflödet.