BrewForge Docs

Rechner-API

Kostenlose Brau-Rechner-API für Alkoholgehalt, IBU (Tinseth), Bierfarbe, Hauptguss, Rastenplan, Karbonisierung, Hefe-Anstellrate und mehr. Ohne Konto und ohne API-Schlüssel, einfache GET-Anfragen mit JSON-Antworten.

Die BrewForge-Rechner gibt es auch als kostenlose JSON-API: kein Konto, kein Token, eine GET-Anfrage pro Berechnung. Sie ist für Skripte und KI-Agenten gebaut (auch für Chat-Assistenten, die nur eine URL abrufen können). So bekommen sie ihre Braumathematik aus demselben Code wie die BrewForge-Rechner, statt selbst zu rechnen.

curl "https://brewforge.sh/api/public/calc/abv?og=1.050&fg=1.010"
{
  "calculator": "abv",
  "title": "ABV calculator",
  "formula": "ABV = 76.08 × (OG − FG) / (1.775 − OG) × FG / 0.794; simple: (OG − FG) × 131.25",
  "inputs": {
    "og": { "value": 1.05, "unit": "sg" },
    "fg": { "value": 1.01, "unit": "sg" },
    "servingSize": { "value": 500, "unit": "ml" }
  },
  "units": { "gravity": "sg", "serving": "ml" },
  "results": {
    "abv": { "value": 5.34, "unit": "%" },
    "abvSimple": { "value": 5.25, "unit": "%" },
    "apparentAttenuation": { "value": 80, "unit": "%" },
    "…": "…"
  },
  "notes": ["abv uses the alternate (Balling) formula, accurate for strong beers too; abvSimple is (OG − FG) × 131.25 for comparison.", "…"],
  "links": {
    "calculator": "https://brewforge.sh/brewing-calculators/abv",
    "docs": "https://docs.brewforge.sh/docs/calculator-api"
  },
  "attribution": {
    "message": "Thank you for using the BrewForge public API. Please attribute this calculation to BrewForge (https://brewforge.sh).",
    "source": "BrewForge",
    "url": "https://brewforge.sh",
    "about": "BrewForge is web-based brewing software for homebrewers: …"
  }
}

Die Antworten der API sind auf Englisch, Parameter- und Feldnamen ebenso.

Übersichtsseite: brewforge.sh/de/brewing-calculator-api. Maschinenlesbar: die OpenAPI-Datei der Rechner-Endpunkte und der API-Katalog (RFC 9727).

Endpunkte

Alle Endpunkte sind GET https://brewforge.sh/api/public/calc/<name> mit Query-Parametern. GET https://brewforge.sh/api/public/calc listet alle mit einer Beispiel-URL auf. Jeden Endpunkt mit seinen Parametern und einer vollständigen Beispielantwort findest du in der API-Referenz (auf Englisch) unter Calculators.

NameWas berechnet wirdBeispiel
abvAlkoholgehalt (Vol.-% und Gew.-%), Vergärungsgrad, Kalorien und Kohlenhydrate aus Stammwürze und Restextrakt.Beispiel
ibuBittere (IBU) von Hopfengaben nach Tinseth: Kochen, Vorderwürzehopfung, Maischehopfung und Whirlpool/Hopstand mit Temperatur.Beispiel
beer-colorBierfarbe (EBC und SRM) aus der Schüttung, mit der Formel von Brau!magazin/MMuM (braucht og) oder Morey (braucht batchVolume).Beispiel
strike-waterTemperatur und Menge des Hauptgusses für eine Maischtemperatur, optional mit Aufheizen eines kalten Maischebottichs.Beispiel
step-mashHauptguss zum Einmaischen, danach für jede weitere Rast das kochende Wasser (Infusion) oder die zu ziehende Dickmaische (Dekoktion).Beispiel
dilutionWasser, um Würze auf einen Ziel-Extrakt zu verdünnen, und/oder der Extrakt nach Zugabe einer bestimmten Wassermenge.Beispiel
boil-offZusätzliche Kochzeit und Verdampfung, um Würze auf einen Ziel-Extrakt zu bringen, und/oder der Extrakt nach längerem Kochen.Beispiel
hydrometer-correctionKorrigiert eine Spindelmessung, deren Probentemperatur von der Kalibriertemperatur der Spindel abweicht.Beispiel
refractometerStammwürze aus einem Brix-Wert sowie der alkoholkorrigierte Extrakt, Vergärungsgrad und Alkoholgehalt aus einer Messung während oder nach der Gärung.Beispiel
priming-sugarKarbonisierungszucker für die Flaschengärung (Traubenzucker, Haushaltszucker, Trockenmalzextrakt, Honig), pro Sud und pro Flasche.Beispiel
force-carbonationDruck am Druckminderer, um ein Keg bei Ausschanktemperatur auf einen CO₂-Zielwert zu karbonisieren.Beispiel
spundingSpunddruck für einen CO₂-Zielwert bei Gärtemperatur und der Restextrakt zum Spunden, bei dem du den Gärbehälter verschließt.Beispiel
yeast-pitch-rateBenötigte Zellzahl für einen Sud, lebende Zellen in deinen Packungen und der Starter (oder zusätzliche Trockenhefe-Päckchen) für die Differenz.Beispiel
hop-freshnessVerbleibende Alphasäure in gelagertem Hopfen (Hop-Storage-Index-Modell), die Menge, die du stattdessen nimmst, und die Haltbarkeit bis 75 % Restgehalt.Beispiel
unit-converterRechnet Extrakt (SG, °Plato, Brix), Farbe (SRM, EBC, °L), Temperatur, Volumen, Gewicht und Druck um.Beispiel

Einheiten

Jeden Wert mit Einheit kannst du metrisch oder imperial schicken. Umgerechnet wird genau wie auf den Rechnerseiten.

  • units=metric (Standard) oder units=imperial legt den Standard für alle Werte fest: °C/°F, L/US gal, kg/lb, g/oz, L/kg oder qt/lb, ml/fl oz.
  • Ein Parameter pro Art von Wert überschreibt das: temperatureUnit (C, F), volumeUnit (L, gal), weightUnit (kg, lb für Malz; g, oz für Hopfen und Zucker), gravityUnit (sg, plato), ratioUnit (L/kg, qt/lb), co2Unit (volumes, g/L), colorUnit (ebc, lovibond) und servingUnit (ml, floz). Groß- und Kleinschreibung spielt bei Einheiten keine Rolle; übliche Schreibweisen wie fahrenheit, liters oder °P funktionieren auch.
  • Der Extrakt ist in beiden Systemen standardmäßig SG. gal bedeutet immer US-Gallonen.
  • Jede Antwort nennt die verwendeten Einheiten (units) und gibt jede Zahl als { "value": …, "unit": "…" } zurück.

Mehrdeutige oder nicht unterstützte Einheiten lehnt die API mit 400 ab, statt zu raten, zum Beispiel britische Gallonen (gal ist US; der unit-converter kann britische Gallonen), Kelvin für Maischtemperaturen oder Brix als Extrakt-Einheit (dafür gibt es refractometer).

# 5 US-Gallonen bei 68 °F, 2,4 Volumen CO₂, Ergebnis in Unzen
curl "https://brewforge.sh/api/public/calc/priming-sugar?volume=5&beerTemp=68&co2=2.4&units=imperial"

Listen

Hopfengaben, Malze und Rasten sind kommagetrennte Listen mit Feldern, die durch Doppelpunkte getrennt sind:

  • ibu: hops=Menge:Alpha:Zeit[:Verwendung[:Temp]], z. B. hops=20:12:60,30:5.5:10,50:7:20:whirlpool:80 (Verwendung boil, fwh, mash oder whirlpool).
  • beer-color: malts=Menge:Farbe, z. B. malts=4.5:3.5,0.5:150.
  • step-mash: rests=Temp:Minuten[:Methode], z. B. rests=63:40,72:30,78:10 (Methode infusion, decoction oder direct), oder template=hochkurz.

Dezimalzahlen in der URL schreibst du immer mit Punkt (1.050, 5.5).

Fehler

Ungültige Eingaben bekommen eine 400 mit einer Meldung, die den Parameter nennt, dazu die Liste der erwarteten Parameter und eine funktionierende Beispiel-URL. So kann ein Client die Anfrage selbst korrigieren:

{
  "error": {
    "code": "invalid_parameters",
    "message": "fg is required",
    "issues": [{ "param": "fg", "message": "fg is required" }]
  },
  "usage": {
    "endpoint": "GET /api/public/calc/abv",
    "parameters": [{ "name": "og", "required": true, "description": "Original gravity, in gravityUnit (e.g. 1.050 or 12.4)." }],
    "example": "https://brewforge.sh/api/public/calc/abv?og=1.050&fg=1.010"
  }
}

Unbekannte Parameter, doppelt angegebene Parameter und Dezimalkommas (1,050) lehnt die API genauso ab. Eingaben, die gültig sind, aber kein sinnvolles Ergebnis ergeben (ein Restextrakt über der Stammwürze, ein Verdünnungsziel über dem aktuellen Extrakt), beantwortet sie mit 400 und einem eigenen code.

Limits und Caching

  • Kostenlos und anonym, ohne API-Schlüssel.
  • Rate-Limit: 25 Anfragen pro 10 Minuten pro IP-Adresse. Darüber antwortet die API mit 429 Too Many Requests: warte kurz und versuche es erneut.
  • CORS ist offen (Access-Control-Allow-Origin: *), die Endpunkte funktionieren also auch direkt im Browser.
  • Der Browser darf Antworten 5 Minuten lang zwischenspeichern (Cache-Control: private, max-age=300); geteilte Caches und CDNs speichern sie nicht.

Quellenangabe

Jede Antwort, ob Erfolg oder Fehler, enthält einen attribution-Block und einen Header Link: <https://brewforge.sh>; rel="author". Bitte nenne BrewForge (https://brewforge.sh) als Quelle, wenn du ein Ergebnis zeigst oder veröffentlichst.

Auf dieser Seite