# Synth.Directory

> A public reference of which synthesiser was used on which record, with settings, sourced and reviewed against a stated evidential standard. Run like Wikipedia, hosted by Box Of Rules.

Every page below is also available as Markdown: append `index.md` to the URL, or send `Accept: text/markdown`.

## Pages
- [home](https://synth.directory/index.md): Search and browse every record, instrument and artist in the wiki
- [standard](https://synth.directory/standard/index.md): The evidential standard: what verifies a claim, grade A/B/C sources
- [contribute](https://synth.directory/contribute/index.md): How to add a claim, a source or a free-licence image
- [terms](https://synth.directory/terms/index.md): Contribution terms: licensing, moderation, takedown
- [takedown](https://synth.directory/takedown/index.md): Corrections and takedown procedure
- [privacy](https://synth.directory/privacy/index.md): Privacy: what is stored, cookies, your rights
- [contact](https://synth.directory/contact/index.md): Contact form for corrections, rights notices and questions

## URL patterns
- https://synth.directory/artists/{slug} - one artist and its records
- https://synth.directory/works/{slug} - one record and its claimed instruments
- https://synth.directory/instruments/{slug} - one instrument and every record naming it
- https://synth.directory/claims/{id} - one claim: its status, settings, sources and images
- https://synth.directory/people/{slug} - one person: what they played, programmed, produced, engineered, mixed or arranged

## API (personal token)
Create an account, then a token at https://synth.directory/me/tokens. Send it as `Authorization: Bearer sd_...`. 200 requests an hour per token; an unlimited tier is planned.

- GET https://synth.directory/api/v1/claims?q=&status=&origin=&artist=&instrument=&role=&person=&since=&order=oldest|newest - search claims, each shaped like a line of /export/claims.jsonl
- GET https://synth.directory/api/v1/claims/{id} - one claim
- GET https://synth.directory/api/v1/records?q=&artist_id=&status=wanted|claimed&since=&order=oldest|newest&with=claims - search records
- GET https://synth.directory/api/v1/records/{id} - one record, with claims
- GET https://synth.directory/api/v1/artists?q= - search artists
- GET https://synth.directory/api/v1/artists/{id} - one artist, with records
- GET https://synth.directory/api/v1/instruments?q=&maker=&kind= - search instruments
- GET https://synth.directory/api/v1/instruments/{id} - one instrument, with claims
- GET https://synth.directory/api/v1/people?q= - search people (performers and producers)
- GET https://synth.directory/api/v1/people/{id} - one person, with accepted credits
- GET https://synth.directory/api/v1/search?q= - artists, records and instruments together, 10 of each
- POST https://synth.directory/api/v1/propose - propose an artist, a record, a claim, a source, an edit or a credit; every write joins the review queue, nothing is auto-accepted

## Licence
Facts (an instrument, a role, a record, a year, a citation) are CC0: no rights reserved. Contributor prose is CC BY 4.0.

## Discovery
GET https://synth.directory/.well-known/ai-catalog.json (ARD manifest), GET https://synth.directory/api/v1/openapi.json (OpenAPI 3.1 for the API above), GET https://synth.directory/robots.txt, GET https://synth.directory/sitemap.xml.

## Contact
hello@synth.directory for corrections, takedown notices, or questions about reuse.