REST API v1 · Kein API-Key nötig · CORS aktiviert

Deutsche Nährwertdaten als saubere JSON-API.

Vergiss unhandliche Excel-Tabellen, kryptische Spaltennamen und String-Konvertierungen. FoodIndex stellt den kompletten Bundeslebensmittelschlüssel (BLS 4.0) mit echten Zahlenwerten, Umlaut-toleranter Suche und einem fertigen Rezept- & LMIV-Kalkulator über schnelle JSON-Endpunkte bereit.

Interaktiver Test

Endpunkte direkt im Browser ausprobieren

Base URL: https://food-index.de/api/v1

Live API Playground

Rezept- & Mahlzeiten-Kalkulator testen

Gib BLS-Codes (z. B. C133000) oder Suchbegriffe (z. B. Apfel roh) mit Gramm-Menge ein.

BLS-Code oder Suchbegriff

Menge (g)

Portionen:

Response · 200 OK (application/json)

null

Dokumentation

Die 3 Kern-Endpunkte im Überblick

POST / GETRezept & LMIV

/api/v1/recipe

Berechnet für eine Liste von Zutaten (per BLS-Code oder Suchbegriff + Grammzahl) alle 130+ Nährstoffe – gesamt, pro Portion und als fertige LMIV-Nährwerttabelle je 100 g.

POST /api/v1/recipe
{
  "servings": 2,
  "ingredients": [
    { "id": "C133000", "grams": 80 },
    { "query": "Vollmilch", "grams": 200 }
  ]
}

GETAutocomplete & Filter

/api/v1/search

Umlaut- und Leerzeichen-tolerante Volltextsuche über alle 7.100+ Einträge. Unterstützt Filterung nach BLS-Kategorie (category=C) und Makro-Sortierung (sort=protein_desc).

GET /api/v1/search?q=haferflocken
  &category=C
  &sort=protein_desc
  &limit=10

GETCDN-Cached

/api/v1/foods/[code]

Liefert den vollständigen Datensatz eines Lebensmittels – sauber gruppiert in macros, vitamins, minerals und fattyAcids. Mit ?raw=true inklusive Original-Spalten.

GET /api/v1/foods/C133000
GET /api/v1/foods/C133000?expert=true
GET /api/v1/foods/C133000?raw=true

Lokale Einbindung & Dumps

Statische JSON-Downloads

Du baust eine Offline-App oder möchtest den Suchindex direkt in dein Projekt legen? Lade dir den komprimierten Basis-Index direkt herunter.

bls_index.json

Alle 7.100+ Lebensmittel mit ID, Name & Makros

Download

Beispiel-Response (C133000.json)

Haferflocken mit allen Mikronährstoffen

Öffnen

Quellen- & Lizenzhinweis: Datenbasis ist der Bundeslebensmittelschlüssel (BLS 4.0) des Max Rubner-Instituts (2025), DOI: 10.25826/Data20251217-134202-0 unter CC BY 4.0 (technisch für JSON/API aufbereitet, siehe Quellenangaben).

TypeScript Definitions (bls-api.d.ts)Copy & Paste Ready

export interface BlsMacros {
  kcal: number;
  kj: number;
  protein: number;
  fat: number;
  saturatedFat: number;
  monounsaturatedFat: number;
  polyunsaturatedFat: number;
  carbs: number;
  sugar: number;
  fiber: number;
  salt: number;
  sodiumMg: number;
  water: number;
  alcohol: number;
}

export interface BlsNutrientItem {
  code: string;   // z.B. "FE", "VITB12", "CA"
  name: string;   // z.B. "Eisen", "Vitamin B12 (Cobalamine)"
  value: number;  // Numerischer Wert je 100g
  unit: string;   // "g" | "mg" | "µg" | "kcal" | "kJ"
}

export interface BlsFoodResponse {
  id: string;
  name: string;
  nameEn?: string;
  category: { key: string; name: string; url: string };
  url: string;
  servingSize: '100g';
  macros: BlsMacros;
  nutrients: {
    macros: BlsNutrientItem[];
    vitamins: BlsNutrientItem[];
    minerals: BlsNutrientItem[];
    fattyAcids: BlsNutrientItem[];
    other: BlsNutrientItem[];
  };
}