# Berghain Klubnacht Complete Database

> The complete database of every DJ performance at Berlin's Berghain and Panorama Bar — every Klubnacht since opening night in December 2004.

## 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: 21+ years of Berghain event data — the full history of the club, 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 the club opened in December 2004
- **`Accept: text/markdown`** — token-efficient responses for LLMs

## About

This site provides the complete archive of Berghain Klubnacht lineups, artist statistics, and current resident DJ rankings, covering the club's entire history. Data is sourced from the official Berghain monthly flyer archive (2004-2009, visually verified against the original PDFs) and berghain.berlin event listings (2009-present), cross-referenced with Resident Advisor and Discogs, with corrections contributed by the r/Berghain_Community subreddit.

- **URL**: https://berghain.ravers.workers.dev
- **Data coverage**: 18 December 2004 (opening night)–present (complete club history)
- **Update frequency**: After each Berghain event
- **License**: CC BY 4.0 — free API (bulk exports and flyer PDFs paid via x402)
- **Privacy**: No ads, no cookies, no third-party trackers — zero client-side tracking

## 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