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.
| Name | Was berechnet wird | Beispiel |
|---|---|---|
abv | Alkoholgehalt (Vol.-% und Gew.-%), Vergärungsgrad, Kalorien und Kohlenhydrate aus Stammwürze und Restextrakt. | Beispiel |
ibu | Bittere (IBU) von Hopfengaben nach Tinseth: Kochen, Vorderwürzehopfung, Maischehopfung und Whirlpool/Hopstand mit Temperatur. | Beispiel |
beer-color | Bierfarbe (EBC und SRM) aus der Schüttung, mit der Formel von Brau!magazin/MMuM (braucht og) oder Morey (braucht batchVolume). | Beispiel |
strike-water | Temperatur und Menge des Hauptgusses für eine Maischtemperatur, optional mit Aufheizen eines kalten Maischebottichs. | Beispiel |
step-mash | Hauptguss zum Einmaischen, danach für jede weitere Rast das kochende Wasser (Infusion) oder die zu ziehende Dickmaische (Dekoktion). | Beispiel |
dilution | Wasser, um Würze auf einen Ziel-Extrakt zu verdünnen, und/oder der Extrakt nach Zugabe einer bestimmten Wassermenge. | Beispiel |
boil-off | Zusätzliche Kochzeit und Verdampfung, um Würze auf einen Ziel-Extrakt zu bringen, und/oder der Extrakt nach längerem Kochen. | Beispiel |
hydrometer-correction | Korrigiert eine Spindelmessung, deren Probentemperatur von der Kalibriertemperatur der Spindel abweicht. | Beispiel |
refractometer | Stammwü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-sugar | Karbonisierungszucker für die Flaschengärung (Traubenzucker, Haushaltszucker, Trockenmalzextrakt, Honig), pro Sud und pro Flasche. | Beispiel |
force-carbonation | Druck am Druckminderer, um ein Keg bei Ausschanktemperatur auf einen CO₂-Zielwert zu karbonisieren. | Beispiel |
spunding | Spunddruck 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-rate | Benö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-freshness | Verbleibende Alphasäure in gelagertem Hopfen (Hop-Storage-Index-Modell), die Menge, die du stattdessen nimmst, und die Haltbarkeit bis 75 % Restgehalt. | Beispiel |
unit-converter | Rechnet 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) oderunits=imperiallegt 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,lbfür Malz;g,ozfür Hopfen und Zucker),gravityUnit(sg,plato),ratioUnit(L/kg,qt/lb),co2Unit(volumes,g/L),colorUnit(ebc,lovibond) undservingUnit(ml,floz). Groß- und Kleinschreibung spielt bei Einheiten keine Rolle; übliche Schreibweisen wiefahrenheit,litersoder°Pfunktionieren auch. - Der Extrakt ist in beiden Systemen standardmäßig SG.
galbedeutet 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(Verwendungboil,fwh,mashoderwhirlpool).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(Methodeinfusion,decoctionoderdirect), odertemplate=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.
BrewForge für TRMNLPro
Was BrewForge ist und wie das TRMNL-Plugin funktioniert: Gärüberwachung und Biervorrat auf deinem E-Ink-Display.
API-Überblick
Die APIs von BrewForge: REST-API, Actions-API und MCP-Server für KI-Assistenten, um Sude, Bestand, Profile und mehr aus Skripten und anderen Apps zu lesen und zu ändern