Help ons om voedseltransparantie de norm te maken!

Als non-profitorganisatie zijn we afhankelijk van uw donaties om consumenten over de hele wereld te blijven informeren over wat ze eten.

De voedselrevolutie begint bij jou!

Doneer

Gegevens

Voorwaarden voor hergebruik

De Open Food Facts-database is beschikbaar onder de Open Database-licentie.
De individuele inhoud van de database is beschikbaar onder de Database Contents License.
Productafbeeldingen zijn beschikbaar onder de Creative Commons Attribution ShareAlike-licentie. Ze kunnen grafische elementen bevatten die onderhevig zijn aan auteursrechten of andere rechten, die in sommige gevallen kunnen worden gereproduceerd (citaatrecht of redelijk gebruik).

Lees alsjeblieft Voorwaarden voor gebruik en hergebruik voordat u de gegevens opnieuw gebruikt.

Vertel ons over uw hergebruik

We willen graag weten hoe de gegevens van Open Food Facts worden gebruikt. Het is niet verplicht, maar we stellen het zeer op prijs als u ons vertelt over uw hergebruik zodat we ze kunnen delen met de Open Food Facts community. U kunt ook dit formulier invullen om kans te maken dat uw app wordt aanbevolen.

Open Food Facts gegevensexport

Database dumps en exports worden elke nacht gegenereerd. De database is erg groot, daarom zijn er verschillende manieren om de gegevens te exporteren, afhankelijk van de gewenste toepassing.

Informatie over de verschillende velden voor de MongoDB-dump en CSV-export is beschikbaar op https://world.openfoodfacts.org/data/data-fields.txt

MongoDB-dump

Alle productdata is beschikbaar in een MongoDB-databasedump.

Link
https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz
sha256sum
https://static.openfoodfacts.org/data/gz-sha256sum
md5sum
https://static.openfoodfacts.org/data/gz-md5sum

Delta-export

Dagelijkse delta-exporten zijn beschikbaar voor de afgelopen 14 dagen. De lijst met beschikbare delta-bestanden is te vinden op https://static.openfoodfacts.org/data/delta/index.txt.

Elke regel is een bestand dat beschikbaar is op https://static.openfoodfacts.org/data/delta/{filename}.

De bestandsnaam bevat UNIX-tijdstempel van de eerste en de laatste wijziging in het JSON-bestand, zodat de delta-bestanden kunnen worden geïmporteerd (na extractie) met mongoimport in alfabetische volgorde.

Let op: vanwege de aard van mongoexport , bevatten de deltabestanden geen informatie over verwijderde producten. Om verwijderde producten uit uw database te verwijderen, moet u de volledige MongoDB-dump importeren.

JSONL-gegevens exporteren

De hele database is beschikbaar in JSONL formaat (soms LDJSON of NDJSON) waarbij elke regel een JSON object is. Het zijn dezelfde gegevens als de MongoDB-export. Het bestand is gecomprimeerd met gzip.

Link
https://static.openfoodfacts.org/data/openfoodfacts-products.jsonl.gz

Een goede manier om de database te exploiteren is door gebruik te maken van DuckDB, een analytisch hulpprogramma dat ontworpen is om grote hoeveelheden gegevens in een fractie van een seconde te verwerken. Je kunt onze blog post lezen waarin we je helpen bij het verkennen en verwerken van de Open Food Facts database met DuckDB

CSV Data export

Gegevens van alle producten, of een deel van de producten, kunnen worden gedownload in CSV-formaat (leesbaar met LibreOffice, Excel en vele andere software) via het geavanceerd zoekformulier.

Links
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (gecomprimeerde CSV in GZIP-formaat: ~ 0,9 Gb, ongecomprimeerd: ~ 9 Gb)

De bestandscodering is Unicode UTF-8. Het teken dat velden scheidt is <tab> (tabulatie).

RDF-gegevensexport

De database is ook beschikbaar in RDF-formaat. U kunt de aankondiging lezen in Frans.

Link
https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf.gz

Afbeeldingsgegevens exporteren

Alle afbeeldingen en OCR-resultaten kunnen worden gedownload van onze server of van AWS (via het AWS Open Data Program). Bekijk onze documentatie voor meer informatie over het downloaden van afbeeldingen.

Live JSON en XML API

Een JSON API is beschikbaar om de productgegevens te lezen. Deze API wordt met name gebruikt in de mobiele app Open Food Facts voor iPhone en Android.

We veranderen de API in de loop van de tijd, maar we zorgen ervoor dat de compatibiliteit met eerdere versies behouden blijft. Neem alstublieft contact met ons op zodat wij u kunnen informeren over mogelijke wijzigingen.

De URL om gegevens voor een product te lezen is: https://world.openfoodfacts.org/api/v2/product/[barcode].json

Voorbeeld: https://world.openfoodfacts.org/api/v3/product/737628064502.json

Houd er rekening mee dat als de uitvoer te overweldigend is, u deze kunt filteren, zoals beschreven in de API-documentatie.

OpenAPI-hulp gezocht

We willen graag de documentatie van de API voltooien, gebruiksscenario's toevoegen en het genereren van SDK's automatiseren. Als u een OpenAPI connaisseur bent, bent u van harte welkom om te helpen.

Je mag de API in productie gebruiken, zolang 1 API-aanroep ook overeenkomt met een echte scan door een gebruiker. Elke poging om de database met behulp van de API te scrapen, zal zeer waarschijnlijk worden geblokkeerd, omdat er een volledige dagelijkse export bestaat (zie op deze pagina).

Het verzenden van een HTTP-header met uw API-call is ook een goede manier om contact met ons op te nemen, mocht er zich een probleem voordoen.

Als je ergens niet zeker van bent, of een vraag hebt (er zijn geen domme vragen), stel hem dan gerust op het #api-kanaal op Slack :-)

Experimentele XML-API

U kunt het resultaat ook in XML krijgen door .xmlte gebruiken

Voorbeeld: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

Deze API wordt niet actief onderhouden en is niet officieel gedocumenteerd.

Wrappers en SDKs

Waarschijnlijk hebben we een wrapper voor je favoriete programmeertaal. Als die wrapper bestaat, dan kan je die gebruiken en verbeteren. Als we de gewenste wrapper niet hebben, kan je helpen met die te maken.

Hiermee kunt u gegevens consumeren en uw gebruikers nieuwe gegevens laten bijdragen

Algemene principes om uw gebruikers blij te maken

  • Je kunt op zoek gaan naar productinformatie, inclusief veel nuttige berekende productwaarden.
  • DART: GitHub
  • Je kunt ook de volledige flow implementeren zodat ze met enige moeite direct resultaat krijgen.

Als jouw gebruikers niet onmiddellijk een resultaat verwachten (bijvoorbeeld inventaris-apps)

  • Foto's indienen (voorkant/voeding/ingrediënten): het gemakkelijkst voor uw gebruikers
  • De Open Food Facts - AI Robotoff - zal gegevens uit de foto's afleiden
  • Na verloop van tijd zullen andere apps en de Open Food Facts-community de lacunes in de gegevens opvullen

Als jouw gebruikers direct een resultaat verwachten (bijvoorbeeld Voedingswaarden- apps)

  • Stuur voedingswaarden en categorie > krijg de Nutri-Score
  • Verstuur ingrediënten > krijg de NOVA-groep (over voedsel ultra-bewerking), additieven, allergenen, genormaliseerde ingrediënten, vegan, vegetarisch…
  • Voer categorie en labels in > krijg binnenkort de Eco-Score (over milieu-impact)

Mobiele Android- en iPhone-app

De code voor de mobiele app Open Food Facts is beschikbaar op GitHub (Flutter, Kotlin Android en Swift iOS).

We willen de verouderde Kotlin- en Swift-codebases omzetten in Kotlin- en Swift SDK's, ondersteuning is welkom :-) Met de app kunnen gebruikers de streepjescode van producten scannen, de productinformatie bekijken en foto's en gegevens voor ontbrekende producten aanvullen en indienen.

De app staat gebruikers toe om de barcode van producten te scannen, om de productinformatie te bekijken en om foto's en gegevens te bekijken en te verzenden voor ontbrekende producten.

Je bent van harte welkom om de code opnieuw te gebruiken (het is open source) en ons te helpen deze te verbeteren, voor iedereen, op de hele planeet.

SDK's

Bespreking van gegevens, API en export

U kunt kijken naar FAQ's over de API en Data Exports en algemene Open Food Facts vragen

U kunt deelnemen aan de Open Food Facts Slack chatroom wat de beste manier is om vragen te stellen en de API te bespreken. Stel uw vragen in het #api kanaal

U kunt een thread openen in onze API documentatie repository

Voor vragen over de gegevens kunt u contact met ons opnemen via reuse@openfoodfacts.org