ShelfBase

Introductie

ShelfBase is een API voor gestructureerde voedingsdata van Europese food- en sportvoedingsproducten. Beschikbare markten zijn Nederland, België, Duitsland en het Verenigd Koninkrijk. Deze gids dekt alles wat je nodig hebt om te integreren.

Basis-URL

Alle requests gaan naar één basis-URL:

https://shelfbase.app/api/v1

Quickstart

Meld je aan, bevestig je e-mail, kopieer je API-sleutel uit het dashboard, en je kunt de API aanroepen. De Free-tier bevat 1.000 requests per maand zonder creditcard.

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

Wat je terugkrijgt

Elk product-record is genormaliseerd, gededupeceerd op EAN en bevat voedingsdata. Elke response bevat:

  • Weergavenaam, canonieke naam en merk
  • Voedingswaarden per 100g (kJ, kcal, vet, verzadigd vet, koolhydraten, suiker, vezels, eiwit, zout)
  • Ingrediëntentekst (ruw en geparseerd waar beschikbaar)
  • Allergenenlijst met herkomst en confidence
  • Gewicht, landen en laatst-ververst-tijdstempel

Twee endpoints

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

Plus een publiek /v1/stats endpoint (geen auth) dat aggregaattellingen teruggeeft. Elk endpoint geeft JSON terug; fouten volgen één vorm — zie Fouten.

Volgende stappen

Volgende →
Authenticatie