Craft Beer Kalender API — BfB Büro für Bieratung

Kalender abonnieren

Mit dem iCal-Feed landen neue und geänderte Festivals automatisch im eigenen Kalender (Google Kalender, Outlook, Apple Kalender, Thunderbird). Einfach die Adresse als «Kalender per URL abonnieren» hinzufügen:

v1/?format=ics

Standardmässig enthält der Feed nur bestätigte Termine. Mit &status=all kommen auch vorläufige Termine hinzu: Sie erscheinen als ganztägiger Platzhalter am Monatsersten mit dem Zusatz «[vorläufig]» und werden automatisch verschoben, sobald das Datum feststeht.

Schnellstart

v1/?country=Schweiz&status=confirmed

Ohne Anmeldung und ohne Schlüssel. Die Antwort enthält einen meta-Block (Quelle, Lizenz, Stand der Daten, Anzahl) und die Liste events:

{
  "meta": { "api_version": "v1", "attribution": "Quelle: BfB – Büro für Bieratung",
            "license": "CC BY 4.0", "data_updated": "2026-10-17", "count": 4, ... },
  "events": [
    {
      "id": "zuerich-bier-festival",
      "name": "Zürich Bier Festival",
      "country": "Schweiz",
      "city": "Zürich",
      "month": "2027-04",
      "start": null,
      "end": null,
      "date_label": "voraussichtlich April 2027 (Termin offen)",
      "status": "tentative",
      "description": "Grösstes internationales Craft-Bier-Festival der Schweiz …",
      "url": "https://www.probier.ch/en/news/",
      "last_verified": "2026-08-21"
    }
  ]
}

Parameter

Parameter	Bedeutung
`format`	`json` (Standard), `csv` oder `ics`
`country`	Land, deutsch oder englisch, Umlaute egal (`Schweiz`, `Switzerland`, `Oesterreich`)
`status`	`confirmed` (bestätigt), `tentative` (vorläufig) oder `all`. Standard: `all`, beim iCal-Feed `confirmed`
`from`, `to`	Zeitraum als `YYYY-MM` oder `YYYY-MM-DD`. Es werden alle Events geliefert, die in den Zeitraum fallen oder ihn berühren.
`q`	Freitext über Name, Stadt, Land und Beschreibung. Tolerant bei Umlauten und Akzenten (`q=zurich` findet «Zürich»)
`limit`	Maximale Anzahl Ergebnisse, 1 bis 500 (Standard 500)
`delimiter`	Nur CSV: `semicolon` (Standard, für Excel im deutschsprachigen Raum) oder `comma`

Beispiele

v1/?from=2027-04&to=2027-06

v1/?format=csv&country=Belgien

v1/?q=copenhagen

In einer Website einbinden (JavaScript)

fetch('v1/?status=confirmed')
  .then(r => r.json())
  .then(d => d.events.forEach(e => console.log(e.start, e.name, e.city)));

Die API erlaubt Abfragen von jeder Website aus (CORS).

Wichtig zu den Daten

status = confirmedDas genaue Datum dieser Ausgabe steht auf einer offiziellen Veranstalterseite.

status = tentativeDas Datum der nächsten Ausgabe ist noch nicht offiziell, date_label nennt den erwarteten Zeitraum, start und end sind dann null.

Der Kalender wird monatlich automatisch recherchiert und von BfB vor der Veröffentlichung geprüft, aber nicht jeder Termin einzeln verifiziert. Angaben ohne Gewähr — bitte vor Reise oder Ticketkauf beim Veranstalter nachprüfen. Das Feld last_verified zeigt, wann ein Termin zuletzt geprüft wurde.

Nutzung und Fair Use

Kostenlos, mit Quellenangabe «BfB – Büro für Bieratung» (Lizenz CC BY 4.0). Ein Link auf unseren Kalender ist willkommen.
Bis zu 120 Anfragen pro Stunde und Absender. Darüber antwortet die API mit 429 und dem Header Retry-After.
Antworten sind eine Stunde zwischenspeicherbar (ETag, Cache-Control). Die Daten ändern sich höchstens monatlich, es genügt also, sie ein- bis zweimal täglich abzurufen.
Fehler kommen als JSON mit passendem HTTP-Status (400 ungültiger Parameter, 429 Limit, 503 Daten vorübergehend nicht verfügbar).

Details stehen in den Nutzungsbedingungen.