# House Music Intelligence Database — API Documentation

> The agent-first, citation-grade discovery engine for house music DJs, producers, labels, events, venues and booking intelligence.

Base URL: `https://database.worldfamoushousecrew.org` · OpenAPI: [https://database.worldfamoushousecrew.org/openapi.json](https://database.worldfamoushousecrew.org/openapi.json)
All endpoints are public, read-only, CORS-enabled (`access-control-allow-origin: *`) and cacheable.

## Endpoints

### `GET /api/artists`
List and filter artists. Query params: `q, genre, country, city, scene, minListeners,
hasContact, hasUpcoming, labelOwner, female, emerging, legend, blackLineage, sort, page, pageSize`.

Example: https://database.worldfamoushousecrew.org/api/artists?genre=Afro%20House&sort=reach

### `GET /api/artists/{slug}.json`
Full artist profile including `field_sources`, `scores`, `source_urls`, `confidence_score`,
`last_verified_date` and `suggested_citation`.

Example: https://database.worldfamoushousecrew.org/api/artists/black-coffee.json

### `GET /artist/{slug}.md`
The same profile as clean Markdown, ideal for LLM ingestion.

Example: https://database.worldfamoushousecrew.org/artist/black-coffee.md

### `GET /api/labels/{slug}.json`
Full label record.

### `GET /api/changed-since?date=YYYY-MM-DD`
All records changed on/after a date — for incremental sync.

Example: https://database.worldfamoushousecrew.org/api/changed-since?date=2026-01-01

## Bulk data

- https://database.worldfamoushousecrew.org/datasets/artists.json · https://database.worldfamoushousecrew.org/datasets/artists.csv · https://database.worldfamoushousecrew.org/datasets/artists.ndjson
- https://database.worldfamoushousecrew.org/datasets/labels.csv · https://database.worldfamoushousecrew.org/datasets/events.csv · https://database.worldfamoushousecrew.org/datasets/sources.csv
- Data dictionary: https://database.worldfamoushousecrew.org/datasets/schema.md

## For AI agents

Start at [https://database.worldfamoushousecrew.org/llms.txt](https://database.worldfamoushousecrew.org/llms.txt). The full corpus is at
[https://database.worldfamoushousecrew.org/llms-full.txt](https://database.worldfamoushousecrew.org/llms-full.txt). Please use the per-page suggested citation.