Gegevens
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.
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.
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.tar.gz
- sha256sum
- https://static.openfoodfacts.org/data/sha256sum
- md5sum
- https://static.openfoodfacts.org/data/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.
CSV Data export
Alle product-gegevens, of sommige producten, kunnen worden gedownload in CSV-formaat (leesbaar met OpenOffice, Excel en vele andere software) via het geavanceerde zoekformulier.
- Links
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (raw CSV)
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format)
De bestandscodering is Unicode UTF-8. Het teken dat velden scheidt is <tab> (tabulatie).
RDF-gegevensexport
De database is ook beschikbaar in RDF-formaat. aankondiging in het Frans.
Afbeeldingsgegevens exporteren
Alle afbeeldingen en OCR-resultaten kunnen worden gedownload van onze server of van AWS (via 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 contact op met ons als u het gebruikt, zodat we 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/v2/product/737628064502.json
U kunt het resultaat ook in XML krijgen door .xml
te gebruiken
Voorbeeld: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
- API V1- Oude documentatie beschikbaar op Wiki (Belangrijke opmerking: de pagina is verdeeld in subpagina's voor LEZEN en SCHRIJVEN).
- API V2 - Uitgebreid maar niet OpenAPI-compatibel - Het bevat use cases voor het weergeven van een product en laat uw gebruikers de gegevens toevoegen die nodig zijn om de Nutri-Score, de NOVA-classificatie, additieven en de Eco-Score te bepalen.
- API V2 - nieuwe OpenAPI-documentatie - Werk in uitvoering
- API V3 - nieuwe OpenAPI-documentatie - Werk in uitvoering
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 :-)
Android- en iPhone mobiele app
De code voor de mobiele Open Food Facts app is beschikbaar op GitHub (Flutter, Android en iOS). 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.
De klassieke app voor iOS is ontwikkeld in Swift.
De klassieke app voor Android is ontwikkeld in Kotlin.
De nieuwe platformonafhankelijke app is een Dart/Flutter-app.
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.
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
- 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)
- Cordova: GitHub (oude officiële Open Food Facts app)
- DART: GitHub - Pakket op pub.dev
- Elixir: GitHub
- Go: GitHub
- Java: GitHub
- Kotlin: GitHub
- NodeJS: GitHub
- PHP: GitHub
- PHP (Lararel): GitHub
- Python: GitHub
- React Native: GitHub
- Ruby: GitHub
- Rust: GitHub
Bespreking van gegevens, API en export
U kunt een thread openen in onze API documentatie repository
Contact
Voor vragen over de data kan je contact met ons opnemen via contact@openfoodfacts.org