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://cocktails.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://cocktails.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. Ein Key gilt unbegrenzt – kein Abo.

Kostenlos für Entwicklung und Open Source

Eine kurze Mail an getraenke@kolabri.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://cocktails.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, seite, limit
GET https://cocktails.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://cocktails.getraenke-getraenke.de/api/v1/cocktails/zufall	Ein zufälliges Rezept (vollständig)	alkoholfrei=1
GET https://cocktails.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://cocktails.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, heißt es „auffüllen“. 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"},
    "quellen": {"genannt": ["IBA Official Cocktails"], "weitere": true},
    "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.

Warum nicht einfach TheCocktailDB?

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.