Developer-dokumentation

billet.dk eksponerer grafen over live kultur i Danmark via et åbent REST API og en MCP-server til AI-assistenter. Alle svar er read-only og indeholder kun officielle billetlinks (is_official = true).

REST API v1

Base URL: https://billet.dk/api/v1. Ingen autentificering krævet. Rate limit: 120 req/min pr. IP. Cache-Control: public, s-maxage=300.

Arrangementer

# Kommende koncerter i København
GET /api/v1/arrangementer?by=kobenhavn&limit=10

# Ét arrangement
GET /api/v1/arrangementer/mew-vega-2026-08-15

# Med datofilter og genre
GET /api/v1/arrangementer?fra=2026-08-01&til=2026-08-31&genre=jazz

Kunstnere

# Søg på navn
GET /api/v1/kunstnere?q=mew

# Kunstner med kommende program
GET /api/v1/kunstnere/mew

Spillesteder

# Alle spillesteder i Aarhus
GET /api/v1/spillesteder?by=aarhus

# Spillested med program
GET /api/v1/spillesteder/vega

On-sale radar

# Kommende billetsalgsstarter (næste 30 dage)
GET /api/v1/on-sale?limit=20

Svarformat

{
  "version": "v1",
  "generatedAt": "2026-07-26T12:00:00Z",
  "limit": 10,
  "offset": 0,
  "data": [
    {
      "version": "v1",
      "slug": "mew-vega-2026-08-15",
      "title": "Mew",
      "startsOn": "2026-08-15",
      "startsAt": "2026-08-15T17:00:00Z",
      "status": "scheduled",
      "kind": "concert",
      "venue": { "slug": "vega", "name": "VEGA", "city": "København" },
      "artists": [{ "slug": "mew", "name": "Mew", "role": "headliner" }],
      "billetter": [
        {
          "url": "https://billetten.dk/...",
          "sellerSlug": "billetten",
          "sellerName": "Billetten",
          "priceMinDkk": 295.00,
          "priceMaxDkk": 295.00,
          "availability": "on_sale"
        }
      ],
      "onSale": []
    }
  ]
}

MCP-server (Model Context Protocol)

Endpoint: https://billet.dk/mcp (HTTP POST, JSON-RPC 2.0, protokolversion 2024-11-05). Bruges af AI-assistenter som Claude, Cursor og andre MCP-klienter.

Konfiguration i Claude Desktop

{
  "mcpServers": {
    "billet-dk": {
      "url": "https://billet.dk/mcp"
    }
  }
}

Tilgængelige tools

Eksempel: initialize

POST https://billet.dk/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}

// Svar:
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": { "tools": {} },
    "serverInfo": { "name": "billet-dk", "version": "1" }
  }
}

Eksempel: søg arrangementer

POST https://billet.dk/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "soeg_arrangementer",
    "arguments": { "by": "kobenhavn", "limit": 5 }
  }
}

Embed widget

Ud over REST API og MCP tilbyder billet.dk et iframe-embed, der viser kommende datoer med officielle billetlinks direkte på kunstner- og spillestedssider.

Endpoint

GET https://billet.dk/api/widget/kunstner/{slug}
GET https://billet.dk/api/widget/spillested/{slug}

Returnerer et komplet HTML-dokument (text/html). Ingen autentificering. Cache: s-maxage=3600, stale-while-revalidate=86400. Tillader embedding fra alle origins (frame-ancestors *).

Eksempel

<iframe
  src="https://billet.dk/api/widget/kunstner/mew"
  width="100%"
  height="400"
  frameborder="0"
  style="border:none;border-radius:4px;display:block"
  title="Kommende koncerter med Mew"
></iframe>

Widgetten indeholder ingen tredjeparts-JavaScript eller cookies. Se generatorsiden på /widget for code-snippets til kunstner- og spillestedsembeds.

Åbne data og licens

API og MCP er åbne og kræver ingen nøgle til read-only brug. Tallene på /tal viser daglig brug. Til udtræk i større mængder eller kommerciel integration: skriv til hej@billet.dk.