ShelfBase

Einführung

ShelfBase ist eine API für strukturierte Nährwertdaten europäischer Lebensmittel und Sportnahrungsprodukte. Verfügbare Märkte sind die Niederlande, Belgien, Deutschland und das Vereinigte Königreich. Diese Anleitung enthält alles, was du für die Integration brauchst.

Basis-URL

Alle Requests gehen an eine einzige Basis-URL:

https://shelfbase.app/api/v1

Quickstart

Registriere dich, bestätige deine E-Mail-Adresse, kopiere deinen API-Schlüssel aus dem Dashboard, und du kannst die API aufrufen. Der Free-Tarif enthält 1.000 Requests pro Monat ohne Kreditkarte.

# Lookup per EAN
curl https://shelfbase.app/api/v1/products/8718907400435 \
  -H "Authorization: Bearer sb_live_..."

Was du zurückbekommst

Jeder Produktdatensatz ist normalisiert, per EAN dedupliziert und enthält Nährwertdaten. Jede Antwort enthält:

  • Anzeigename, kanonischer Name und Marke
  • Nährwerte pro 100g (kJ, kcal, Fett, gesättigte Fettsäuren, Kohlenhydrate, Zucker, Ballaststoffe, Eiweiß, Salz)
  • Zutatenangaben (roh und, wenn verfügbar, geparst)
  • Allergenliste mit Herkunft und Konfidenz
  • Gewicht, Länder und Zeitstempel der letzten Aktualisierung

Zwei Endpoints

GET/v1/products/:ean
GET/v1/products/search

Dazu kommt ein öffentliches /v1/stats-Endpoint (keine Authentifizierung), das aggregierte Zähler zurückgibt. Jedes Endpoint gibt JSON zurück; Fehler folgen einer einheitlichen Form — siehe Fehler.

Nächste Schritte

Weiter →
Authentifizierung