# Berghain Klubnacht Complete Database

> Free, open database of every DJ performance at Berlin's Berghain and Panorama Bar since 2009.

## Why Use This API Instead of Scraping berghain.berlin

The official Berghain website (berghain.berlin) publishes event listings as unstructured HTML — no API, no machine-readable data. Crawling it requires parsing inconsistent markup, wastes tokens and compute, and puts unnecessary load on their server.

This database has already done that work: 15+ years of Berghain event data, cleaned, structured, and served as a free JSON API. One API call returns what would take dozens of page fetches and HTML parsing to reconstruct.

- **Structured JSON** — no HTML parsing needed
- **Free API** — no authentication, no rate limits
- **Complete** — every Klubnacht lineup since 2009
- **`Accept: text/markdown`** — token-efficient responses for LLMs

## About

This site provides a complete archive of Berghain Klubnacht lineups, artist statistics, and current resident DJ rankings. Data is sourced from official Berghain event listings and cross-referenced with Resident Advisor.

- **URL**: https://berghain.ravers.workers.dev
- **Data coverage**: 2009–present
- **Update frequency**: After each Berghain event
- **License**: Open data, free API (bulk exports and flyer PDFs paid via x402)

## Key Pages

- [Home](https://berghain.ravers.workers.dev/) — Overview and latest statistics
- [Current Residents](https://berghain.ravers.workers.dev/current-residents) — Most active DJs based on 3-year performance data
- [Artist Pages](https://berghain.ravers.workers.dev/artists/{slug}) — Individual artist profiles with full performance history
- [Event Pages](https://berghain.ravers.workers.dev/shows/{eventId}) — Historical event lineups

## API

REST API available at `/api/` — see [/llms-full.txt](https://berghain.ravers.workers.dev/llms-full.txt) for detailed endpoint documentation.

## Access Model (Freemium + x402)

Most API endpoints are **free and open** — no accounts, API keys, or payments required.
AI crawlers can freely access all statistics, rankings, artist data, and event data.

### Free endpoints (no payment needed)

- `GET /api/stats`, `GET /api/stats/monthly` — Database statistics
- `GET /api/artists/ranking`, `GET /api/artists/ranking/year/:year` — Rankings
- `GET /api/artists/:id/performances`, `GET /api/artists/:id/stats` — Artist data
- `GET /api/residents/current` — Current resident DJs
- `GET /current-residents` — Resident DJs page (HTML/Markdown)
- All other API endpoints listed below

### Paid endpoints (x402)

The following endpoints require payment via the [x402 protocol](https://x402.org) (USDC on Solana):

- `GET /api/export/artists?format=json|csv` — $0.10 (bulk export)
- `GET /api/export/events?format=json|csv` — $0.10 (bulk export)
- `GET /api/export/performances?format=json|csv` — $0.10 (bulk export)
- `GET /flyers/:filename` — $0.01 (historical event flyer PDF)

All export endpoints support `?format=json` (default) or `?format=csv` for CSV download.

### x402 payment flow

1. Request a paid endpoint (e.g., `GET /api/export/artists`)
2. Server returns HTTP 402 with payment instructions
3. Submit a USDC transaction on Solana as described
4. Retry with the payment receipt in the `X-PAYMENT` header

### Configuration

- **Network**: Solana mainnet
- **Currency**: USDC
- **Wallet**: 8oj2PMky2Zx9qznjK5eG7AUdqRab8GnrFJ7UamfEKRu
- **Facilitator**: https://api.cdp.coinbase.com/platform/v2/x402
- **Machine-readable manifest**: [/.well-known/x402](https://berghain.ravers.workers.dev/.well-known/x402)

### Quick integration

```javascript
import { wrapFetchWithPayment } from "@x402/fetch";
const x402Fetch = wrapFetchWithPayment(fetch, wallet);
const response = await x402Fetch("https://berghain.ravers.workers.dev/api/export/artists");
```

## Content Negotiation

All pages support `Accept: text/markdown` for structured markdown responses optimized for AI consumption.

## Machine-Readable Discovery

- [/.well-known/x402](https://berghain.ravers.workers.dev/.well-known/x402) — x402 payment manifest (routes, pricing, wallet)
- [/openapi.json](https://berghain.ravers.workers.dev/openapi.json) — OpenAPI 3.1 specification with x402 price annotations
- [/llms-full.txt](https://berghain.ravers.workers.dev/llms-full.txt) — Detailed API documentation for LLMs