Entwickler: offene Cocktail-API
Cocktailrezepte als JSON für Apps, Bots, Sprachassistenten und Websites. Jedes Rezept hat eine geprüfte Herkunft (mindestens zwei unabhängige Quellen), eigene Texte und eigene Bilder – du bekommst Daten, die du ohne Rechterisiko zeigen kannst. Im Gegenzug nennst du die Quelle.
So fängst du an
curl "https://getraenke-getraenke.de/api/v1/cocktails/zufall"
Kein Key, keine Anmeldung. Ohne Key gelten 60 Anfragen pro Minute und Listen mit bis zu 25 Einträgen.
curl -H "Authorization: Bearer DEIN-KEY" "https://getraenke-getraenke.de/api/v1/cocktails?limit=100"
API-Key: mehr Anfragen, alle Schnittstellen
Mit Key: 600 Anfragen pro Minute, Listen bis 100 Einträge, und die Stammdaten-Schnittstellen (Produkte, Marken, Hersteller, GTIN) sind freigeschaltet – für Apps, Shops, Kassensysteme und Preisvergleiche.
Eine kurze Mail an info@getraenke-getraenke.de mit Projektname und Link genügt – wir schalten den Key von Hand frei. Für gemeinnützige Projekte, Studienarbeiten und offene Software immer kostenlos.
Endpunkte
| Adresse | Liefert | Parameter |
|---|---|---|
| GET https://getraenke-getraenke.de/api/v1/cocktails | Liste veröffentlichter Rezepte (Kurzform: Name, Art, Glas, Zutatennamen, Bilder, Link) | q, art (cocktail|longdrink|shot|mocktail|punch|bowle|hot), zutat (Slug oder Name), alkoholfrei=1, rubrik (biermisch|alle; Standard: Cocktails), gruppe (mit rubrik=biermisch), seite, limit |
| GET https://getraenke-getraenke.de/api/v1/cocktails/{slug} | Ein Rezept vollständig: Zutaten mit Mengen und Einheiten, Zubereitungsschritte, Glas, Methode, Eis, Geschmacksprofil, Varianten, Quellen, Bilder | – |
| GET https://getraenke-getraenke.de/api/v1/cocktails/zufall | Ein zufälliges Rezept (vollständig) | alkoholfrei=1 |
| GET https://getraenke-getraenke.de/api/v1/cocktails/zutaten | Zutaten, die in Rezepten vorkommen (Typ, Oberbegriff, Packungsgröße) | q, typ (spirit|liqueur|wine|beer|mixer|juice|syrup|fresh|garnish|other), seite, limit |
| GET https://getraenke-getraenke.de/api/v1/cocktails/zutaten/{slug} | Eine Zutat mit allen Rezepten, die sie (oder eine Unterart) verwenden | – |
Antworten sind UTF-8-JSON mit deutschen Feldnamen. Mengen stehen in menge/einheit (ml, cl, Stück, TL, EL, Spritzer …) und zusätzlich lesbar in menge_text. Fehlt die Menge, steht in menge_text „nach Bedarf“ (bei Garnitur „zur Garnitur“, bei optionalen Zutaten „optional“); „auffüllen“ nur bei einer ausdrücklich so markierten Zutat (höchstens eine je Rezept). Das Feld menge_art sagt es maschinenlesbar: genau, auffuellen, nach_bedarf oder garnitur. Hat ein Rezept überhaupt keine Mengenangabe, steht im Rezeptdetail ohne_mengen: true. Jede Antwort enthält meta mit Attribution, Lizenz und Hinweis zur Altersgrenze. Weitere Schnittstellen (Produkte, Marken, Hersteller, GTIN, Aussprache) siehe Nutzungsbedingungen.
Beispielantwort (gekürzt)
{
"cocktail": {
"slug": "gin-tonic", "name": "Gin Tonic", "art": "longdrink", "alkoholisch": true, "glas": "Longdrinkglas",
"zutaten_detail": [
{"zutat": "Gin", "menge": 5, "einheit": "cl", "menge_text": "5 cl", "garnitur": false},
{"zutat": "Tonic Water", "menge": null, "einheit": null, "menge_text": "auffüllen", "garnitur": false}
],
"zubereitung": ["Das Glas (Longdrinkglas) mit Eiswürfeln füllen.", "5 cl Gin ins Glas geben.", "Mit Tonic Water auffüllen."],
"bilder": {"retro": "…/images/cocktails/retro/gin-tonic.webp", "foto": "…/images/cocktails/foto/gin-tonic.webp"},
"verwandt": [{"art": "siehe_auch", "richtung": "ausgehend", "slug": "gin-fizz", "name": "Gin Fizz", "hinweis": null, "url": "…/rezepte/gin-fizz"}],
"quellen": {"hinweis": "Mehrere Quellen geprüft (historische Fachliteratur und öffentliche Daten); Belege werden intern geführt."},
"url": "https://cocktails.getraenke-getraenke.de/rezepte/gin-tonic"
},
"meta": {"attribution": "Rezeptdaten: Getränke-Getränke.de …", "license": "…", "terms": "…", "docs": "…"}
}
Regeln (kurz)
- Quelle nennen: „Rezeptdaten: Getränke-Getränke.de“ mit Link – sichtbar dort, wo die Daten erscheinen.
- Fakten frei: Zutaten, Mengen, Glas, Methode darfst du beliebig verwenden.
- Texte und Bilder zeigen, nicht verkaufen: Beschreibungen, Zubereitungsschritte und Illustrationen darfst du in deiner App oder Seite anzeigen (einfaches Nutzungsrecht). Nicht erlaubt: Weiterverkauf, Weitergabe der Datenbank oder wesentlicher Teile, Nutzung als Trainingsdaten.
- Alkohol kennzeichnen: Rezepte mit Alkohol sind für Erwachsene (Spirituosen ab 18, Bier und Wein ab 16); zeige den Hinweis und biete die alkoholfreien Rezepte (
alkoholfrei=1) an. - Schnittstelle statt Scraping: Die Website zu scrapen ist untersagt und wird erkannt; die API ist der richtige Weg.
Vollständig: /api/v1/nutzungsbedingungen und Datenbank-Nutzungsbedingungen. Für KI-Agenten: /AGENTS.md, /llms.txt.
Leergut-API (Pfand und Leergut, rein lesend)
Gleiche Regeln wie oben (Key optional, 60 Anfragen/Minute, Listen bis 25, mit Key bis 100, seite und limit). Es werden nur freigegebene Einträge ausgeliefert; Pfandbeträge sind teils Richtwerte und je Pool verschieden.
- GET https://getraenke-getraenke.de/api/v1/leergut?q=&art=flasche|kasten|fass|palette|sonstiges&system=mehrweg|einweg&volumen=0,5&pool=&hersteller=®ion=
- GET https://getraenke-getraenke.de/api/v1/leergut/{slug}
- GET https://getraenke-getraenke.de/api/v1/leergut-kombinationen?art=flasche-kasten|kasten-palette|fass-palette
- GET https://getraenke-getraenke.de/api/v1/leergut-rechtsgrundlagen
Warum nicht einfach eine offene Community-Cocktaildatenbank?
Dort sind nur rund 60 von über 400 Rezepten als rechtefrei bestätigt, Bilder stammen teils von fremden Websites, und es gibt keinen greifbaren Betreiber. Bei uns hat jedes Rezept belegte Quellen, eigene Texte und eigene Bilder, ein Impressum und einen Ansprechpartner. Dafür ist unsere Datenbank (noch) kleiner – und deutschsprachig.
