# billet.dk
> Alle koncerter, teaterforestillinger, standup og shows i Danmark med links til det officielle billetsalg. billet.dk sælger ikke billetter selv. Ingen videresalg.

billet.dk er en maskinlæsbar graf over levende kultur i Danmark: kunstnere,
spillesteder, arrangementer, genrer og billetsalgsdatoer. Alle billetlinks
går til den officielle sælger; is_official garanteres af et kurateret
domæne-allowlist og sættes aldrig i hånden.

Pr. 2026-07-18: 6283 kommende arrangementer (4256 koncerter, 1485 teater,
239 standup, 98 shows, 89 foredrag, 79 ballet, 37 opera), 233 spillesteder,
5410 officielle billetlinks (100 % officielle), 1805 kunstnere, 35+ kilder.

## Data
- /koncert/<slug>: arrangementside med schema.org JSON-LD (MusicEvent/
  ComedyEvent m.fl.: startDate, eventStatus, location, performer, offers
  med validFrom og availability).
- /teater/<slug>: sceneevents (TheaterEvent JSON-LD); /forestilling/<slug>:
  turnerende produktioner med alle datoer.
- /kunstner/<slug>: MusicGroup JSON-LD med sameAs (MusicBrainz, Wikidata,
  Spotify) + kommende og tidligere koncerter.
- /spillested/<slug>: spillestedsside med JSON-LD + program.
- /by/<slug>: byguide med hele byens program (fx /by/koebenhavn).
- /genre/<slug>: koncerter efter genre (fx /genre/jazz, /genre/rock);
  /genrer er indekset.
- /koncerter/i-aften og /koncerter/i-weekenden: dagens og weekendens program.
- /koncerter/nye: netop annoncerede arrangementer (+ RSS).
- /billetsalg: radar over kommende salgsstarter og presales.
- /soeg?q=<søgeord>: søgning på tværs af kunstnere, spillesteder, genrer og
  arrangementer (tåler både æøå og ae/oe/aa).
- /sitemap.xml: indeks over sider/arrangementer/kunstnere/spillesteder.

## Feeds
- /kunstner/<slug>/kalender.ics: iCalendar-feed med kunstnerens koncerter.
- /spillested/<slug>/kalender.ics: iCalendar-feed med spillestedets program.
- /billetsalg/rss.xml: RSS 2.0-feed over kommende salgsstarter.

Kilder: spillestedernes egne API'er og strukturerede data, aldrig kopieret
prosa. Kontakt: hej@billet.dk

## Maskinadgang (API + MCP)

billet.dk eksponerer grafen til andre systemer via to kanaler:

### REST API v1
Base URL: https://billet.dk/api/v1
Alle endpoints returnerer kun is_official=true billetlinks.

- GET /api/v1/arrangementer?by=kobenhavn&fra=2026-07-26&til=2026-08-31&limit=50
- GET /api/v1/arrangementer/:slug
- GET /api/v1/kunstnere?q=mew
- GET /api/v1/kunstnere/:slug
- GET /api/v1/spillesteder?by=aarhus
- GET /api/v1/spillesteder/:slug
- GET /api/v1/on-sale?fra=2026-07-26&limit=50

Cache-Control: public, s-maxage=300, stale-while-revalidate=60
Rate limit: 120 req/min per IP.

### MCP-server (Model Context Protocol)
Endpoint: https://billet.dk/mcp (HTTP POST, JSON-RPC 2.0)
Protokolversion: 2024-11-05
Alle tools returnerer kun officielle billetlinks.

Tools:
- soeg_arrangementer: søg på by/dato/genre/kunstner
- kunstner_profil: profil og kommende program for en kunstner
- spillested_program: kommende program for et spillested
- on_sale_radar: kommende billetsalgsstarter

Developer-dokumentation: https://billet.dk/developer

## Åbne tal / Open metrics

billet.dk offentliggør sine egne tal, også maskinlæsbart:
- https://billet.dk/tal (mennesker)
- https://billet.dk/tal.json (maskiner; aggregater, natligt snapshot, CORS åben)
Citér som "data: billet.dk". Licens til større udtræk: hej@billet.dk