Erste Schritte mit FoodBase

Konto anlegen

Geh auf die Registrierungsseite und leg ein kostenloses Konto an. Keine Kreditkarte nötig — der Free-Plan gibt dir 100 API-Anfragen pro Tag, das reicht locker zum Testen und für Prototypen.

API-Schlüssel erzeugen

Nach dem Einloggen gehst du zu Dashboard > API Keys und klickst auf Create key. Gib ihm einen aussagekräftigen Namen wie „Meine App“ oder „Entwicklung“. Der vollständige Schlüssel wird nur einmal angezeigt — kopier ihn also und bewahr ihn sicher auf (etwa in einer .env-Datei oder einem Passwort-Manager).

Dein Schlüssel sieht ungefähr so aus: food_KV23NskbwXkKzi1yaPdPF1

Die erste Anfrage

Such ein Lebensmittel nach Namen:

curl "https://foodbase.dev/v1/foods/search?q=banana&limit=3" \
  -H "X-API-Key: food_your_key_here"

Die Antwort enthält passende Produkte mit Namen, Marken, Kategorien und grundlegenden Nährwerten:

{
  "data": [
    {
      "id": "abc-123",
      "name_default": "Banana",
      "brand": null,
      "category": "Fresh fruits",
      "nutriscore": "a"
    }
  ],
  "total": 26080,
  "limit": 3,
  "offset": 0
}

Suche per Barcode

Wenn du eine Barcode-Scanner-App baust, nutz den Barcode-Endpunkt mit einem EAN-13- oder UPC-Code:

curl "https://foodbase.dev/v1/foods/barcode/5449000000996" \
  -H "X-API-Key: food_your_key_here"

Zurück kommen die vollständigen Produktdetails inklusive einer Nährwertübersicht mit Kalorien, Eiweiß, Kohlenhydraten, Fett, Zucker und Ballaststoffen — alles pro 100 g.

Detaillierte Nährstoffe abrufen

Für die komplette Nährstoffaufschlüsselung (über 40 Werte, nach Kategorien geordnet) gibt es den Nutrients-Endpunkt. Er ist in jedem Plan verfügbar — der Free-Plan enthält 25 Aufschlüsselungen pro Tag (behalte den Header X-RateLimit-Nutrients-Remaining im Blick), bezahlte Pläne sind unbegrenzt:

curl "https://foodbase.dev/v1/foods/{id}/nutrients" \
  -H "X-API-Key: food_your_key_here"

Die Antwort gruppiert die Nährstoffe in Kategorien:

• Makros — Energie (kcal/kJ), Eiweiß, Kohlenhydrate, Fett, Ballaststoffe, Zucker, Alkohol, Stärke
• Fette — gesättigte, Trans-, einfach/mehrfach ungesättigte Fettsäuren, Omega-3/6, Cholesterin
• Mineralstoffe — Natrium, Calcium, Eisen, Kalium, Magnesium, Zink und mehr
• Vitamine — A, C, D, E, B-Komplex (B1, B2, B6, B9, B12), Niacin

Mehrere Produkte auf einmal

Du brauchst mehrere Produkte gleichzeitig? Nimm den Bulk-Endpunkt mit bis zu 100 IDs:

curl -X POST "https://foodbase.dev/v1/foods/bulk" \
  -H "X-API-Key: food_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["id-1", "id-2", "id-3"]}'

Die Ergebnisse kommen in derselben Reihenfolge wie die übergebenen IDs zurück — du musst nichts neu sortieren.

Die KI-Endpunkte ausprobieren

Jeder Plan — auch Free — enthält ein monatliches Kontingent an KI-Credits (20 im Free-Plan). Damit laufen die Vision- und Analyse-Endpunkte: ein Produkt auf einem Foto erkennen, ein Nährwertetikett auslesen, eine Mahlzeit analysieren oder eine verständliche KI-Zusammenfassung zu einem beliebigen Produkt erzeugen. Jeder Aufruf hat einen festen Credit-Preis, der in der Doku steht, und jede KI-Antwort enthält X-Credits-Remaining-Header.

Am schnellsten siehst du sie im Foto-Playground in Aktion — lad direkt im Browser ein Foto mit deinem eigenen Schlüssel hoch. Oder ruf einen direkt auf:

curl -X POST "https://foodbase.dev/v1/analyze/product" \
  -H "X-API-Key: food_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"barcode": "3017620422003"}'

Rate-Limits, die nicht gegen dich arbeiten

Die Limits pro Sekunde sind Token-Buckets: Die Rate deines Plans ist die Dauergeschwindigkeit (Free = 1 Anfrage/Sek.), und obendrauf bekommst du einen Burst vom Fünffachen — eine Seite, die ein paar parallele Anfragen abfeuert, funktioniert also einfach. Jede Antwort enthält Header, mit denen deine App die Nutzung überwachen kann:

X-RateLimit-Second-Limit: 1
X-RateLimit-Burst-Capacity: 5
X-RateLimit-Second-Remaining: 4
X-RateLimit-Daily-Limit: 100
X-RateLimit-Daily-Remaining: 97
X-RateLimit-Daily-Reset: 2026-04-14T23:59:59Z

Solltest du doch einmal ein 429 bekommen, enthält es immer einen Retry-After-Header mit den Sekunden bis zum nächsten Token — halte dich daran (die meisten HTTP-Clients können das automatisch), und du bist so schnell wieder bei 200ern, wie der Limiter es zulässt. Wenn du viele Produkte auf einmal abrufen willst, ist POST /foods/bulk eine Anfrage statt N.

Nächste Schritte

• Stöbere in der API-Dokumentation durch alle verfügbaren Endpunkte und probier sie interaktiv aus
• Erkunde die Datenbank selbst im Produkt-Explorer — jede Produktseite zeigt genau das, was die API zurückgibt
• Prüf deine Nutzungsstatistiken, um deine täglichen Anfragen im Blick zu behalten
• Wechsle deinen Plan, wenn du mehr Kapazität brauchst
• Lies unseren Leitfaden zu den Nährwertdaten, um die Datenabdeckung zu verstehen