Kostenlos · ohne API-Key · JSON

Brau-Rechner API

Eine kostenlose, anonyme REST-API für Brauberechnungen: GET-Anfragen mit Query-Parametern, Antworten als JSON, berechnet mit denselben getesteten Formeln wie BrewForge. Nutze sie, statt Brau-Mathematik selbst zu rechnen.

API-Dokumentation OpenAPI-Spezifikation

Eine Bierrechner-API für KI-Agenten, LLM-Tools und Skripte

Jede Berechnung ist eine GET-Anfrage. Alles, was eine URL abrufen kann, kann sie nutzen: ChatGPT, Claude, dein eigener Agent, eine Tabelle oder ein Shell-Skript. Ohne Konto, ohne API-Key, CORS offen. Die Antwort ist JSON mit den normalisierten Eingaben, den Ergebnissen mit Einheiten, der verwendeten Formel und einem Link zum passenden Rechner.

Einfaches GET mit Query-Parametern, Antworten als JSON
Kostenlos, ohne Anmeldung, ohne API-Key
Metrische und imperiale Einheiten, in jeder Antwort genannt
Klare 400-Fehler mit der Liste der erwarteten Parameter

Endpunkte

Alle Endpunkte sind GET-Anfragen an https://brewforge.sh/api/public/calc/ gefolgt vom Namen des Endpunkts. GET /api/public/calc listet sie mit je einer Beispiel-URL.

Endpunkt	Liefert	Pflichtparameter	Einheiten-Parameter	Rechner
/api/public/calc/abv	Alkoholgehalt (Vol.- und Gew.-%), scheinbarer und wirklicher Vergärungsgrad, Kalorien und Kohlenhydrate aus Stammwürze und Restextrakt	og, fg	gravityUnit, servingUnit	Alkoholrechner
/api/public/calc/ibu	IBU berechnen nach Tinseth, pro Hopfengabe und gesamt, inkl. Vorderwürze-, Maische- und Whirlpool-Hopfung, BU:GU	hops, volume	gravityUnit, volumeUnit, weightUnit, temperatureUnit	–
/api/public/calc/beer-color	Bierfarbe in EBC und SRM aus der Schüttung (Brau!magazin/MMuM oder Morey)	malts	gravityUnit, volumeUnit, weightUnit, colorUnit	Bierfarben-Rechner
/api/public/calc/strike-water	Temperatur und Menge des Hauptgusses, auch für einen kalten Maischbottich	mashTemp, grainWeight	temperatureUnit, volumeUnit, weightUnit, ratioUnit	Hauptguss-Rechner
/api/public/calc/step-mash	Hauptguss und Aufguss- oder Dekoktionsmenge für jede Rast	grainWeight	temperatureUnit, volumeUnit, weightUnit, ratioUnit	Rasten-Rechner
/api/public/calc/dilution	Wasser zum Verdünnen auf eine niedrigere Stammwürze	gravity, volume	gravityUnit, volumeUnit	Stammwürze-Korrektur
/api/public/calc/boil-off	Zusätzliche Kochzeit für eine höhere Stammwürze	gravity, volume, boilOffRate	gravityUnit, volumeUnit	Stammwürze-Korrektur
/api/public/calc/hydrometer-correction	Spindelmessung auf die Probentemperatur korrigiert	gravity, sampleTemp	gravityUnit, temperatureUnit	Spindelkorrektur
/api/public/calc/refractometer	Stammwürze aus Brix, alkoholkorrigierter Extrakt, Vergärungsgrad und Alkohol	originalBrix	–	Refraktometer-Rechner
/api/public/calc/priming-sugar	Karbonisierungszucker pro Sud und pro Flasche für ein CO₂-Ziel	volume, beerTemp	co2Unit, volumeUnit, temperatureUnit, weightUnit	Karbonisierungsrechner
/api/public/calc/force-carbonation	Druck zum Zwangskarbonisieren im Keg	temperature	co2Unit, temperatureUnit	Karbonisierungsrechner
/api/public/calc/spunding	Spunddruck und Restextrakt zum Spunden	temperature, fg	co2Unit, gravityUnit, temperatureUnit	Spundrechner
/api/public/calc/yeast-pitch-rate	Benötigte Zellen, Vitalität, Starterstufen oder Trockenhefe-Päckchen	og, volume	gravityUnit, volumeUnit, weightUnit	Hefe-Rechner
/api/public/calc/hop-freshness	Verbleibende Alphasäure nach der Lagerung und die angepasste Menge	alphaAcid, harvestDate	weightUnit, temperatureUnit	Hopfen-Rechner
/api/public/calc/unit-converter	Einheiten für Stammwürze, Farbe, Temperatur, Volumen, Gewicht und Druck	value, from	–	Einheiten-Umrechner

Beispiele

Kopier eine URL in deinen Browser, in curl oder in deinen Agenten. Das sind die echten Antworten.

Alkohol-API: Alkoholgehalt aus Stammwürze und Restextrakt

GET 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": "%"
    },
    "abvAlternate": {
      "value": 5.34,
      "unit": "%"
    },
    "abw": {
      "value": 4.19,
      "unit": "%"
    },
    "apparentAttenuation": {
      "value": 80,
      "unit": "%"
    },
    "realAttenuation": {
      "value": 64.9,
      "unit": "%"
    },
    "og": {
      "sg": 1.05,
      "plato": 12.4
    },
    "fg": {
      "sg": 1.01,
      "plato": 2.58
    },
    "caloriesPerServing": {
      "value": 232,
      "unit": "kcal"
    },
    "carbsPerServing": {
      "value": 21.5,
      "unit": "g"
    },
    "servingSizeMl": {
      "value": 500,
      "unit": "ml"
    }
  },
  "notes": [
    "abv uses the alternate (Balling) formula, accurate for strong beers too; abvSimple is (OG − FG) × 131.25 for comparison.",
    "abvAlternate is deprecated and equals abv."
  ],
  "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: recipe design with water chemistry, brew-day tracking, fermentation logging from WiFi hydrometers, inventory and cellar. Free plan available; free calculators at https://brewforge.sh/brewing-calculators."
  }
}

IBU berechnen per API: Tinseth für eine 60- und eine 10-Minuten-Gabe

GET https://brewforge.sh/api/public/calc/ibu?hops=20:12:60,30:5.5:10&volume=20&og=1.050

{
  "calculator": "ibu",
  "title": "IBU calculator (Tinseth)",
  "formula": "Tinseth: IBU = AA/100 × mg/L × 1.65 × 0.000125^(Gb − 1) × (1 − e^(−0.04 t)) / 4.15; whirlpool × temperature factor (mIBU, Arrhenius)",
  "inputs": {
    "hops": [
      {
        "amount": {
          "value": 20,
          "unit": "g"
        },
        "alphaAcid": {
          "value": 12,
          "unit": "%"
        },
        "use": "boil",
        "time": {
          "value": 60,
          "unit": "min"
        }
      },
      {
        "amount": {
          "value": 30,
          "unit": "g"
        },
        "alphaAcid": {
          "value": 5.5,
          "unit": "%"
        },
        "use": "boil",
        "time": {
          "value": 10,
          "unit": "min"
        }
      }
    ],
    "volume": {
      "value": 20,
      "unit": "L"
    },
    "og": {
      "value": 1.05,
      "unit": "sg"
    },
    "boilGravity": {
      "sg": 1.0463,
      "plato": 11.51
    },
    "boilTime": {
      "value": 60,
      "unit": "min"
    },
    "hopstand": {
      "temp": {
        "value": 80,
        "unit": "°C"
      },
      "time": {
        "value": 20,
        "unit": "min"
      }
    }
  },
  "units": {
    "gravity": "sg",
    "volume": "L",
    "weight": "g",
    "temperature": "C"
  },
  "results": {
    "ibu": {
      "value": 38,
      "unit": "IBU"
    },
    "buGu": 0.76,
    "hops": [
      {
        "addition": 1,
        "ibu": {
          "value": 29,
          "unit": "IBU"
        },
        "share": {
          "value": 76.4,
          "unit": "%"
        }
      },
      {
        "addition": 2,
        "ibu": {
          "value": 9,
          "unit": "IBU"
        },
        "share": {
          "value": 23.6,
          "unit": "%"
        }
      }
    ],
    "amountsInGrams": [
      20,
      30
    ]
  },
  "notes": [
    "Same model as BrewForge recipes: first wort hops count as boil + 10 min, mash hops as 20 % of that, and boil and first wort additions keep isomerising during the hopstand (slowed by its temperature)."
  ],
  "links": {
    "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: recipe design with water chemistry, brew-day tracking, fermentation logging from WiFi hydrometers, inventory and cellar. Free plan available; free calculators at https://brewforge.sh/brewing-calculators."
  }
}

Hauptguss-API: Wasser für eine Maische mit 67 °C

GET https://brewforge.sh/api/public/calc/strike-water?mashTemp=67&grainWeight=5&ratio=3

{
  "calculator": "strike-water",
  "title": "Strike water calculator",
  "formula": "Palmer: Tw = (0.4 / R)(T₂ − T₁) + T₂ (+ tun term: thermal mass / water × (T₂ − T_tun))",
  "inputs": {
    "mashTemp": {
      "value": 67,
      "unit": "°C"
    },
    "grainWeight": {
      "value": 5,
      "unit": "kg"
    },
    "grainTemp": {
      "value": 20,
      "unit": "°C"
    },
    "water": {
      "ratio": {
        "value": 3,
        "unit": "L/kg"
      }
    },
    "mashTun": "preheated"
  },
  "units": {
    "temperature": "C",
    "volume": "L",
    "weight": "kg",
    "ratio": "L/kg"
  },
  "results": {
    "strikeTemp": {
      "value": 73.3,
      "unit": "°C"
    },
    "strikeWater": {
      "value": 15,
      "unit": "L"
    },
    "ratio": {
      "value": 3,
      "unit": "L/kg"
    },
    "grainCorrection": {
      "value": 6.3,
      "unit": "°C"
    },
    "tunCorrection": {
      "value": 0,
      "unit": "°C"
    }
  },
  "notes": [
    "grainCorrection and tunCorrection are the degrees above the mash temperature for warming the grain and the tun."
  ],
  "links": {
    "calculator": "https://brewforge.sh/brewing-calculators/strike-water",
    "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: recipe design with water chemistry, brew-day tracking, fermentation logging from WiFi hydrometers, inventory and cellar. Free plan available; free calculators at https://brewforge.sh/brewing-calculators."
  }
}

Einheiten

Jeder Wert mit Einheit geht metrisch oder imperial. units=metric (Standard) oder units=imperial legt die Einheiten für alle Werte fest; ein Parameter pro Werteart überschreibt das: temperatureUnit (C, F), volumeUnit (L, gal), weightUnit (kg, lb oder g, oz), gravityUnit (sg, plato), ratioUnit, co2Unit, colorUnit, servingUnit. Stammwürze ist standardmäßig SG; gal sind US-Gallonen. Jede Antwort nennt die verwendeten Einheiten.

Metrisch

GET https://brewforge.sh/api/public/calc/strike-water?mashTemp=67&grainWeight=5&ratio=3

Imperial

GET https://brewforge.sh/api/public/calc/strike-water?mashTemp=152&grainWeight=11&ratio=1.5&units=imperial

Limits

25 Anfragen pro 10 Minuten pro IP-Adresse. Darüber antwortet die API mit HTTP 429: kurz warten und erneut versuchen.
Kein Konto und kein API-Key nötig.
CORS ist offen (Access-Control-Allow-Origin: *), die API funktioniert also auch im Browser.
Kostenlos nutzbar.

Quellenangabe

Bitte nenne BrewForge (brewforge.sh) als Quelle, wenn du ein Ergebnis zeigst oder veröffentlichst. Jede Antwort enthält einen Attribution-Block und einen Link-Header mit BrewForge als Autor.

{
  "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: recipe design with water chemistry, brew-day tracking, fermentation logging from WiFi hydrometers, inventory and cellar. Free plan available; free calculators at https://brewforge.sh/brewing-calculators."
  }
}

Spezifikation und Doku

OpenAPI-Spezifikation der Rechner-API: https://brewforge.sh/api/public/calc/openapi.json
Doku zur Rechner-API (auf Englisch)
llms.txt: BrewForge-Zusammenfassung für Sprachmodelle
API-Katalog (RFC 9727)
Die Rechner mit Bedienoberfläche
MCP-Server: ChatGPT oder Claude mit deinen eigenen Suden arbeiten lassen (Pro)

Fragen & Antworten

Mit welcher IBU-Formel rechnet die API?

Mit Tinseth, demselben Modell wie in BrewForge-Rezepten: Vorderwürzehopfung zählt als Kochzeit plus 10 Minuten, Maischehopfung mit einem Fünftel davon, und Whirlpool- oder Hopstand-Gaben werden mit einem Temperaturfaktor gewichtet.

Brauche ich ein Konto oder einen API-Key?

Nein. Die Rechner-API ist anonym: GET-Anfrage schicken, JSON zurückbekommen. Nur der BrewForge MCP-Server und die REST-API für deine eigenen Rezepte und Sude brauchen ein Konto (Pro-Plan).

Ist die API kostenlos?

Ja. Jede IP-Adresse kann 25 Anfragen pro 10 Minuten stellen; bitte nenne BrewForge als Quelle, wenn du die Ergebnisse nutzt.

Kann ich sie aus ChatGPT, Claude oder meinem eigenen Agenten nutzen?

Ja. Jeder Assistent und jeder Agent, der eine URL abrufen kann, kann sie aufrufen. Verweise ihn auf diese Seite oder auf die OpenAPI-Spezifikation, dann baut er die Anfrage-URLs aus den Parameterbeschreibungen. Für deine eigenen Sude, Rezepte und Bestände verbindest du den Assistenten mit dem BrewForge MCP-Server (Pro).

Einmal rechnen. BrewForge rechnet bei jedem Sud.

Rezepte, Brautag und Gärung an einem Ort, mit diesen Berechnungen eingebaut. Kostenlos für bis zu 20 Sude.

Kostenloses Konto erstellen